MCP - AI-integratie

Wat is MCP?

MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten zoals ChatGPT, Claude, Google Gemini, Microsoft Copilot en Perplexity op een veilige manier verbinding maken met externe databronnen. De Barcode Scan App biedt een MCP server waarmee je AI-assistent direct je Exact Online magazijndata kan opvragen.

In plaats van handmatig gegevens op te zoeken in Exact Online, stel je eenvoudig een vraag aan je AI-assistent. Bijvoorbeeld: "Hoeveel voorraad hebben we van artikel X?" of "Welke inkooporders staan nog open voor leverancier Y?"

Wat kan ik met MCP?

De MCP server biedt 52 tools waarmee je AI-assistent je magazijndata kan doorzoeken en opvragen. De tools zijn gegroepeerd in de volgende categorieën:

Zoeken

• Artikelen zoeken – zoek op artikelcode, barcode of omschrijving
• Relaties zoeken – zoek leveranciers en klanten
• Account aanmaken – maak een nieuwe klant of leverancier aan in Exact Online
• Verkooporder aanmaken – maak een nieuwe verkooporder aan in Exact Online
• Inkooporder aanmaken – maak een nieuwe inkooporder aan in Exact Online
• Werkorder aanmaken – maak een nieuwe werkorder (productieorder) aan in Exact Online
• Verkooporderregel toevoegen – voeg een orderregel toe aan een bestaande verkooporder
• Inkooporderregel toevoegen – voeg een orderregel toe aan een bestaande inkooporder
• Goederenlevering boeken – boek een goederenlevering voor een verkooporder
• Goederenontvangst boeken – boek een goederenontvangst voor een inkooporder
• Magazijnverplaatsing aanmaken – maak een voorraadverplaatsing aan tussen magazijnen
• Magazijnverplaatsing verwerken – verwerk een bestaande magazijnverplaatsing
• Inkooporders zoeken – filter op status, datum, leverancier en magazijn
• Verkooporders zoeken – filter op status, datum, klant en magazijn
• Werkorders zoeken – zoek productie- en assemblageorders
• Goederenontvangsten zoeken – zoek inkomende goederenboekingen
• Goederenleveringen zoeken – zoek uitgaande goederenboekingen
• Magazijnverplaatsingen zoeken – zoek verplaatsingen tussen magazijnen
• Retourzendingen zoeken – zoek en filter geplande retourzendingen
• Retourzending aanmaken – maak een retourzending aan voor een verkooporder
• Retourzending verwerken – verwerk een bestaande retourzending
• Contactpersoon aanmaken – maak een contactpersoon aan bij een bestaand account
• Assemblageorders zoeken – zoek en filter assemblageorders
• Leveranciersartikelen opvragen – zoek welke leveranciers een artikel leveren
• Opslaglocaties tonen – toon alle opslaglocaties van een magazijn

Details opvragen

• Inkooporder details – volledige informatie van een specifieke inkooporder
• Verkooporder details – volledige informatie van een specifieke verkooporder
• Werkorder details – volledige informatie van een specifieke werkorder
• Goederenontvangst details – volledige informatie van een goederenontvangst
• Goederenlevering details – volledige informatie van een goederenlevering
• Magazijnverplaatsing details – volledige informatie van een verplaatsing
• Retourzending details – volledige informatie van een retourzending
• Stuklijst opvragen – bekijk de stuklijst (bill of materials) van een artikel
• Bewerkingsstappen opvragen – bekijk de routing van een productieorder

Productie & assemblage

• Productie gereedmelden – meld een hoeveelheid gereed voor een productieorder
• Materiaal uitgeven – geef materiaal uit aan een productieorder
• Materiaaluitgifte terugdraaien – draai een eerder uitgegeven materiaal terug
• Bijproduct ontvangen – ontvang een bijproduct uit een productieorder
• Assemblageorder afronden – rond een assemblageorder af
• Tijdregistratie – registreer tijd op een bewerkingsstap van een productieorder

Voorraad

• Voorraadinformatie – voorraadniveaus per magazijn, inclusief batch- en serienummers
• Locatievoorraad – voorraad per opslaglocatie binnen een magazijn

Traceerbaarheid

• Batchhistorie – volg de bewegingen van een batchnummer
• Serienummerhistorie – volg de bewegingen van een serienummer

Overig

• Magazijnen opvragen – overzicht van alle beschikbare magazijnen
• Actief magazijn opvragen – bekijk welk magazijn momenteel actief is
• Magazijn wisselen – wissel naar een ander magazijn
• Administraties opvragen – overzicht van alle beschikbare administraties
• Actieve administratie opvragen – bekijk welke administratie momenteel actief is
• Administratie wisselen – wissel naar een andere administratie
• Leverwijzes opvragen – overzicht van alle beschikbare leverwijzes
• Feedback versturen – feedback of suggesties indienen via de AI-assistent

Voorbeelden van vragen

Zodra de MCP server is gekoppeld aan je AI-assistent, kun je vragen stellen zoals:

• "Hoeveel voorraad hebben we van artikel 12345?"
• "Welke inkooporders staan open voor leverancier Acme B.V.?"
• "Geef me de details van verkooporder SO-2026-001234"
• "Waar ligt batchnummer LOT-2025-A opgeslagen?"
• "Welke verkooporders zijn vandaag geleverd?"
• "Wat is de voorraad in magazijn Hoofdmagazijn per opslaglocatie?"
• "Hoeveel werkorders zijn in productie?"
• "Geef een overzicht van alle magazijnverplaatsingen van deze week"
• "Maak een inkooporder aan bij leverancier Acme voor 100 stuks artikel X"

De AI-assistent roept automatisch de juiste MCP tools aan om je vraag te beantwoorden.

Voorbeeld: ChatGPT met MCP

Hieronder zie je een voorbeeld van ChatGPT die via MCP de magazijndata opvraagt uit Exact Online:

Hoe werkt het?

De koppeling tussen je AI-assistent en de Barcode Scan App werkt via het OAuth 2.1 protocol:

1. Configureer de MCP server URL in je AI-client (zie configuratie hieronder)
2. Autoriseer – je AI-client opent een inlogscherm waar je inlogt met je Barcode Scan App account
3. Geef toestemming – bevestig dat de AI-assistent je magazijndata mag opvragen
4. Stel vragen – je kunt nu direct vragen stellen over je Exact Online data

Wanneer je voor het eerst verbinding maakt, opent je AI-client een inlogscherm van de Barcode Scan App. Log hier in met je bestaande account:

Na het inloggen verschijnt een toestemmingsscherm. Klik op Accepteren om de AI-assistent toegang te geven tot je magazijndata:

Na autorisatie onthoudt de AI-client je toestemming. Je hoeft niet opnieuw in te loggen zolang de sessie actief is.

Configuratie

Om de MCP server te koppelen aan je AI-assistent gebruik je de volgende gegevens:

Server URL	https://www.barcodescan.nl/app/mcp
Transport	Streamable HTTP
Authenticatie	OAuth 2.1
Discovery URL	https://www.barcodescan.nl/.well-known/oauth-protected-resource

Configuratie in Claude Desktop

Voeg het volgende toe aan je claude_desktop_config.json:

{
  "mcpServers": {
    "barcodescan": {
      "url": "https://www.barcodescan.nl/app/mcp",
      "transport": "streamable-http"
    }
  }
}

Na het opslaan van de configuratie verschijnt de Barcode Scan App als MCP connector in Claude Desktop:

Configuratie in Claude Code (CLI)

Voer het volgende commando uit:

claude mcp add barcodescan --transport http https://www.barcodescan.nl/app/mcp

Configuratie in ChatGPT

ChatGPT detecteert de MCP server automatisch via de OAuth discovery URL. Voeg de server URL toe in de MCP-instellingen van ChatGPT.

Vereisten

• Een Geavanceerd abonnement op de Barcode Scan App (bekijk abonnementen)
• Een AI-client die het MCP-protocol ondersteunt (bijv. Claude, ChatGPT, Google Gemini, Microsoft Copilot, Perplexity, Cursor)
• Een actieve Exact Online koppeling in de Barcode Scan App

Beveiliging

De MCP server is ontworpen met beveiliging als prioriteit:

• OAuth 2.1 met PKCE – de modernste authenticatiestandaard, beschermt tegen token-onderschepping
• Beperkte schrijftoegang – de AI kan nieuwe accounts, verkoop-, inkoop- en werkorders aanmaken, productieorders gereedmelden, materiaal uitgeven en assemblageorders afronden; bestaande data kan niet gewijzigd of verwijderd worden
• Token-verloop – toegangstokens verlopen na 1 uur en moeten vernieuwd worden
• HTTPS – alle communicatie is versleuteld
• Gebruikersgebonden – de AI ziet alleen de data van de ingelogde gebruiker en divisie
• Toestemming vereist – je moet expliciet toestemming geven voordat een AI-assistent toegang krijgt

Veelgestelde vragen

Welk abonnement heb ik nodig?

De MCP-functionaliteit is beschikbaar voor gebruikers met een Geavanceerd abonnement.

Welke AI-assistenten ondersteunen MCP?

MCP wordt ondersteund door onder andere Claude (Anthropic), ChatGPT (OpenAI), Google Gemini (Google), Microsoft Copilot, Perplexity, GitHub Copilot, Cursor en andere AI-tools die het MCP-protocol implementeren. Het aantal ondersteunde AI-clients groeit snel.

Kan de AI mijn data wijzigen?

De AI kan nieuwe accounts (klanten en leveranciers), contactpersonen, verkooporders, inkooporders, werkorders en retourzendingen aanmaken via MCP. Daarnaast kan de AI productieorders gereedmelden, materiaal uitgeven en terugdraaien, assemblageorders afronden, bijproducten ontvangen en tijdregistratie doen. Bestaande data kan niet gewijzigd of verwijderd worden.

Hoe trek ik de toegang in?

Je kunt de MCP-toegang intrekken door de OAuth-autorisatie te verwijderen in de instellingen van je AI-client, of door contact met ons op te nemen.

Telt MCP-gebruik mee voor de Exact Online API-limieten?

De MCP server kan API-calls naar Exact Online maken, bijvoorbeeld bij het aanmaken van orders. Deze tellen mee voor je API-limieten. Voor het opvragen van gegevens wordt zoveel mogelijk gebruik gemaakt van de lokale cache van de Barcode Scan App.