Aan de slag - AFAS MCP Platform

Wat is MCP?

Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten zoals Claude direct toegang krijgen tot externe databronnen. In plaats van data handmatig te kopiëren naar een chatvenster, kan de AI zelfstandig data opvragen uit AFAS Profit.

Claude / VS Code AI-assistent

MCP Platform API Uw server

AFAS Profit GetConnectors

AI zoekt zelfstandig de juiste data

Vragen stellen in gewoon Nederlands

Alleen leestoegang via GetConnectors

Usage tracking per omgeving

7 beschikbare MCP Tools

Tool	Wat doet het?
`afas_list_connectors`	Toont alle beschikbare GetConnectors
`afas_get_connector_schema`	Toont de velden van een connector
`afas_query_connector`	Haalt data op met filters en sortering
`afas_aggregate_connector`	Berekeningen: SOM, GEMIDDELDE, AANTAL, etc.
`afas_environment_info`	Toont omgevingsinformatie

1 App Connector aanmaken

Een App Connector koppelt een AFAS-omgeving aan de MCP server.

Ga naar Omgevingen en selecteer de gewenste AFAS-omgeving
Klik op App Connector toevoegen
Vul een herkenbare naam in (bijv. "Financiële rapportages")
Plak optioneel het AFAS token — wordt AES-256 versleuteld opgeslagen

Tip: Als u het AFAS token hier opslaat, is de configuratie voor de eindgebruiker eenvoudiger. Zonder opgeslagen token moet de gebruiker het token meesturen via een extra header.

2 API Key genereren

Elke App Connector heeft een of meerdere API keys nodig voor toegang.

Open de aangemaakte App Connector
Klik op API Key aanmaken
Geef de key een naam (bijv. "Boekhouding - Jan")
Kopieer de key direct: nmcp_...

Belangrijk: Kopieer de API key direct! Na het sluiten van dit scherm is de volledige key niet meer zichtbaar.

3 Transport kiezen

De MCP server ondersteunt twee transport methoden:

Streamable HTTP Aanbevolen

Directe HTTP-verbinding met de MCP server. Geen extra software nodig, sneller en stabieler. Ondersteund door steeds meer clients (o.a. Claude Desktop, Cursor, Windsurf).

URL: https://afasmcp.erp-brug.nl/mcp

Stdio (via mcp-remote)

Gebruikt npx mcp-remote als bridge tussen de client en de HTTP server. Vereist Node.js. Gebruik dit als uw client nog geen Streamable HTTP ondersteunt.

Vereist: Node.js geïnstalleerd

4 Client configureren Voorbeeld: Claude Desktop

De MCP server werkt met alle AI-agents die het MCP protocol ondersteunen, waaronder Claude Desktop, Cursor, Windsurf, VS Code en andere clients.

De kwaliteit van de antwoorden verschilt per agent en gekozen AI-model. Wij behalen goede resultaten met het Claude Haiku 4.5 model — een snelle en kostenefficiënte keuze die uitstekend presteert voor AFAS data-analyse.

Onderstaand voorbeeld toont de configuratie voor Claude Desktop. Open het configuratiebestand op: %APPDATA%\Claude\claude_desktop_config.json

Streamable HTTP

Met opgeslagen AFAS token (aanbevolen):

{
  "mcpServers": {
    "mcp-platform": {
      "type": "http",
      "url": "https://afasmcp.erp-brug.nl/mcp",
      "headers": {
        "X-API-Key": "nmcp_UW_API_KEY_HIER"
      }
    }
  }
}

Zonder opgeslagen token:

Handig bij per-user scenario's en applicatie-inlog via OTP. De gebruiker stuurt het token mee in de header. U hoeft dan ook geen token op te slaan in ons systeem.

{
  "mcpServers": {
    "mcp-platform": {
      "type": "http",
      "url": "https://afasmcp.erp-brug.nl/mcp",
      "headers": {
        "X-API-Key": "nmcp_UW_API_KEY_HIER",
        "X-AFAS-Token": "<token><version>1</version><data>UW_TOKEN</data></token>"
      }
    }
  }
}

Stdio (via mcp-remote) Windows

Op macOS/Linux: gebruik npx in plaats van npx.cmd.

Met opgeslagen AFAS token (aanbevolen):

{
  "mcpServers": {
    "mcp-platform": {
      "command": "npx.cmd",
      "args": [
        "-y",
        "mcp-remote",
        "https://afasmcp.erp-brug.nl/mcp",
        "--header",
        "X-API-Key: nmcp_UW_API_KEY_HIER"
      ]
    }
  }
}

Zonder opgeslagen token:

Handig bij per-user scenario's en applicatie-inlog via OTP. De gebruiker stuurt het token mee in de header. U hoeft dan ook geen token op te slaan in ons systeem.

{
  "mcpServers": {
    "mcp-platform": {
      "command": "npx.cmd",
      "args": [
        "-y",
        "mcp-remote",
        "https://afasmcp.erp-brug.nl/mcp",
        "--header",
        "X-API-Key: nmcp_UW_API_KEY_HIER",
        "--header",
        "X-AFAS-Token: <token><version>1</version><data>UW_TOKEN</data></token>"
      ]
    }
  }
}

Herstart Claude Desktop na het opslaan. Het hamertje-icoon rechtsonder bevestigt de verbinding.

Voorbeelden van gebruik

Zodra de MCP server is verbonden, kunt u vragen stellen over uw AFAS data:

Overzicht opvragen

"Welke GetConnectors zijn er beschikbaar?"

Data opvragen

"Geef me de top 10 klanten op basis van omzet dit jaar"

Analyse

"Hoeveel facturen zijn er per maand verstuurd in 2025?"

Connector verkennen

"Welke velden zitten er in de Profit_Article connector?"

De AI kiest automatisch de juiste tool en vertaalt uw vraag naar de juiste connector-query.

Veiligheid

Alleen leestoegang

De MCP server kan alleen data lezen via GetConnectors, nooit wijzigen

API keys

Elke gebruiker heeft een eigen key, intrekbaar via het portal

Versleutelde tokens

AFAS tokens worden AES-256 versleuteld opgeslagen

Usage tracking

Alle API calls worden bijgehouden per omgeving

Aan de slag met MCP Platform