AFAS Help MCP

AFAS-documentatie, waar jij werkt

Jouw agent.
Met AFAS Help.

Geef je AI-assistent toegang tot Jonas, de AI van het AFAS Help Center. Stel vragen over Profit en SB, krijg antwoorden met links naar de help en stel direct je vervolgvraag.

Verbind je agent
Openbaar MCP-endpoint · Streamable HTTPhttps://mcp.nvanderwaal.nl/afashelp

Je gebruikt de gehoste server: voeg de URL toe aan je agent. Je hebt geen AFAS API-sleutel nodig. Je eigen account en modelinstellingen voor je agent blijven van toepassing.

01

Antwoorden met bronnen

Zoek instellingen, integraties en foutmeldingen op. Open de bronlinks om de bijbehorende AFAS-helpdocumentatie te lezen.

02

Stel direct je vervolgvraag

Je agent krijgt de instructie om het gespreks-ID automatisch te hergebruiken zolang het onderwerp, product en de taal hetzelfde blijven.

03

Ga verder in Jonas

Vraag een deellink aan om het gesprek in je browser te openen en verder te gaan in je eigen kopie.

Een URL. Even instellen. Klaar.

Verbind je agent

Kies hieronder je agent. Voeg de configuratie toe aan je bestaande instellingen en start je agent opnieuw of maak opnieuw verbinding. Zoek vervolgens ask_afas_help bij de beschikbare tools.

VS Code / Copilot

Voeg dit toe aan .vscode/mcp.json in je project. Kies de Agent-modus en schakel de AFAS-tools in.

{"servers":{"afas-help":{"type":"http","url":"https://mcp.nvanderwaal.nl/afashelp"}}}

Controleer de verbinding via het opdrachtenpalet: MCP: List Servers.

OpenCode

Voeg dit toe aan opencode.json in je project of aan je globale OpenCode-configuratie.

{"mcp":{"afas-help":{"type":"remote","url":"https://mcp.nvanderwaal.nl/afashelp","enabled":true}}}

Controleer de verbinding: opencode mcp list

Claude Code

Voer deze opdracht uit om de server beschikbaar te maken in al je projecten.

claude mcp add --transport http --scope user afas-help https://mcp.nvanderwaal.nl/afashelp

Controleer de verbinding: claude mcp get afas-help of /mcp in de chat.

Cursor

Voeg dit toe aan .cursor/mcp.json in je project of aan ~/.cursor/mcp.json voor al je projecten.

{"mcpServers":{"afas-help":{"url":"https://mcp.nvanderwaal.nl/afashelp"}}}

Schakel de server in bij de MCP-instellingen en open een Agent-chat.

Codex

Voeg dit blok toe aan ~/.codex/config.toml. De CLI en IDE-extensie gebruiken dezelfde configuratie.

[mcp_servers.afas-help]
url = "https://mcp.nvanderwaal.nl/afashelp"
tool_timeout_sec = 150

Controleer de verbinding: codex mcp list

Claude Desktop

Ondersteunen je versie en abonnement aangepaste externe connectors? Open Settings → Connectors, voeg een aangepaste connector toe en plak het endpoint.

https://mcp.nvanderwaal.nl/afashelp

Is deze optie niet beschikbaar? Gebruik dan een van de andere agents hierboven die externe MCP-servers ondersteunen.

Begin met een vraag

Probeer het in je volgende chat

Gebruik afas-help: wat is het verschil tussen een GetConnector en een UpdateConnector? Vermeld de bronnen.
Gebruik afas-help om uit te leggen hoe ik een REST-aanroep naar AFAS Profit authenticeer. Vermeld de links naar de help.
Hoe test ik dit via REST?
Maak met share_afas_help een link naar dit gesprek zodat ik verder kan in Jonas.

Twee tools, eenvoudig in gebruik

Wat je agent kan doen

ask_afas_help

Stel een vraag van maximaal 2.000 tekens. Je krijgt een antwoord in Markdown, bronnen, voorgestelde vervolgvragen en een conversationId.

{
  "message": "Hoe maak ik een GetConnector?"
}

Je agent vult het bijbehorende conversationId zelf in bij vervolgvragen. Je hoeft dit niet te kopiëren of op te geven.

share_afas_help

Maak een browserlink naar het gesprek tot en met het laatste volledige antwoord. Iedereen met de link kan deze momentopname bekijken en verdergaan in een eigen kopie.

{
  "conversationId": "<ID uit het antwoord>"
}

Je agent vult het ID in. Latere berichten worden niet aan de gedeelde momentopname toegevoegd.

Kies een product en taal

Standaard: AFAS Profit (se), Nederlands (nl / 1), Nederland. Voor AFAS SB gebruik je sb. Voor Engels kies je en / 4 en voor Frans fr / 3. Je agent geeft beide taalwaarden mee en begint een nieuw gesprek als je van context wisselt.

Goed om te weten

Blijft een gesprek bewaard na een herstart?

Gesprekken horen bij je MCP-sessie en staan in het geheugen. Ze verlopen na een uur inactiviteit of wanneer de dienst opnieuw start. Maak dan opnieuw verbinding en stel een nieuwe vraag.

Wat als ik een limiet of time-out krijg?

Er gelden limieten voor het aantal verzoeken, sessies en gelijktijdige aanvragen. Wacht de aangegeven tijd af als je een Retry-After ontvangt. Stel waar mogelijk een time-out van minimaal 150 seconden per toolaanroep in. AFAS heeft daarnaast eigen limieten en kan tijdelijk niet beschikbaar zijn.

Moet ik zelf software installeren?

Je gebruikt AFAS Help MCP via de gehoste server. Voeg het endpoint hierboven toe aan een geschikte AI-agent. Je hoeft geen repository te downloaden, npm-pakket te installeren of eigen server te starten.