Wat is MCP?

MCP (Model Context Protocol) is een open standaard waarmee AI-assistenten zoals ChatGPT, Claude en GitHub Copilot 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 20 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
  • 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

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

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
  • 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"

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:

ChatGPT MCP integratie - vraag stellen over magazijndata
ChatGPT MCP integratie - resultaat van magazijndata opvraag

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:

MCP autorisatie - inloggen met je Barcode Scan App account

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

MCP autorisatie - toestemming geven aan de AI-assistent

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 URLhttps://www.barcodescan.nl/app/mcp
TransportStreamable HTTP
AuthenticatieOAuth 2.1
Discovery URLhttps://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:

MCP connector configuratie 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, GitHub Copilot, 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
  • Alleen leestoegang – de AI kan data opvragen maar niet wijzigen, aanmaken of verwijderen
  • 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), 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?

Nee, de MCP server biedt uitsluitend leestoegang. Er kunnen geen orders worden aangemaakt, gewijzigd of verwijderd via MCP. De AI kan alleen informatie opvragen.

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 maakt gebruik van de lokale cache van de Barcode Scan App. Directe API-calls naar Exact Online worden tot een minimum beperkt, waardoor het effect op je API-limieten minimaal is.