MCP Configureren

Volg deze stappen om Exact Online te gebruiken met je favoriete AI assistant.

1 Verbinden

2 Configureren

3 Herstarten

4 Testen

Nog niet ingelogd? Verbind eerst je Exact Online account om een API key te krijgen.

0 Vereisten

Een Exact Online account met toegang tot minimaal 1 administratie
Een AI assistant met MCP ondersteuning (ChatGPT, Claude, Copilot, Gemini, Cursor, Windsurf, etc.)

1 Verbind Exact Online & krijg API Key

Klik op de knop hieronder om je Exact Online account te verbinden. Na succesvolle verbinding ontvang je een API key.

Verbinden met Exact Online

Na het verbinden ontvang je:

• Een persoonlijke API key (begint met exa_)
• Toegang tot al je administraties via AI
• 200 opdrachten (~60 vragen) per maand gratis (Free plan)

2 Configureer je AI Assistant

Aanbevolen: Via URL (Custom Connector)

Ga in Claude Desktop naar Settings → Connectors → Add MCP Connector en plak deze URL:

Je logt in via OAuth - geen API key nodig. Bij eerste gebruik opent je browser voor Exact Online login.

Alternatief: Via config bestand

Open het Claude Desktop configuratiebestand en voeg de connector toe:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "exact-online": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.praatmetjeboekhouding.nl/mcp"]
    }
  }
}

Herstart Claude Desktop na het opslaan. Bij eerste gebruik log je in met je Exact Online account.

Meer hulp nodig? Bekijk de volledige stap-voor-stap instructies met screenshots voor macOS, Windows en Linux.

Download Claude Desktop →

In Cursor kun je MCP servers toevoegen via Settings:

Open Cursor Settings (Cmd/Ctrl + ,)
Zoek naar "MCP" of ga naar Features → MCP Servers
Klik op Add new MCP server
Selecteer SSE als type
Plak de URL hieronder

MCP Server URL:

✓ Je logt in via OAuth - geen API key nodig

Of bewerk handmatig ~/.cursor/mcp.json:

{
  "mcpServers": {
    "exact-online": {
      "url": "https://api.praatmetjeboekhouding.nl/mcp"
    }
  }
}

In Windsurf kun je MCP servers toevoegen via de configuratie:

MCP Server URL:

✓ Je logt in via OAuth - geen API key nodig

Config bestand:

~/.codeium/windsurf/mcp_config.json

Voeg deze configuratie toe:

{
  "mcpServers": {
    "exact-online": {
      "serverUrl": "https://api.praatmetjeboekhouding.nl/mcp"
    }
  }
}

Let op: Claude Code vereist een API key (andere platforms gebruiken OAuth). Genereer een sleutel via je Dashboard.

Download Claude Code →

De makkelijkste manier is via de CLI:

claude mcp add exact-online --transport http "https://api.praatmetjeboekhouding.nl/mcp" --header "Authorization: Bearer JOUW_API_KEY"

Vervang JOUW_API_KEY met je sleutel van het Dashboard.

Server bestaat al? Eerst verwijderen

Als je de fout "MCP server exact-online already exists" krijgt:

claude mcp remove exact-online

Daarna kun je de server opnieuw toevoegen met het commando hierboven.

Andere handige commando's:

claude mcp list - Toon alle geconfigureerde servers
claude mcp get exact-online - Toon configuratie van een server

Of bewerk handmatig ~/.claude/settings.json:

{
  "mcpServers": {
    "exact-online": {
      "url": "https://api.praatmetjeboekhouding.nl/mcp",
      "headers": {
        "Authorization": "Bearer JOUW_API_KEY"
      }
    }
  }
}

Claude Cowork (Mac & Windows)

Met Claude Cowork kun je samenwerken met Claude op je desktop. Cowork deelt connectors met Claude Desktop — voeg de MCP URL eenmalig toe en gebruik het overal.

claude cowork

Download Claude Desktop → (inclusief Cowork)

Alleen Claude Code vereist een API key. Ga naar je Dashboard om een sleutel te genereren. Andere platforms (ChatGPT, Claude Desktop, etc.) gebruiken OAuth login.

3 Herstart je AI Assistant

Sluit je AI assistant volledig af en start opnieuw op. De MCP server wordt automatisch geladen.

Tip: Op macOS gebruik Cmd+Q om apps volledig af te sluiten. Het kruisje sluit alleen het venster.

4 Test de verbinding

Open een nieuwe chat en probeer een van deze vragen:

"Welke Exact Online administraties heb ik?"

"Toon alle openstaande facturen"

"Geef een overzicht van de omzet dit jaar"

De AI roept automatisch de juiste Exact Online tools aan om je vraag te beantwoorden.

Wat kun je vragen?

Na configuratie kun je je AI vragen stellen over je Exact Online data:

Administraties

"Welke administraties heb ik toegang tot?"

Relaties & Klanten

"Toon alle klanten met openstaand saldo"

Facturen

"Welke facturen zijn meer dan 30 dagen oud?"

Financieel

"Wat is de winst- en verliesrekening van Q1?"

Artikelen

"Zoek alle producten met 'printer' in de naam"

Projecten

"Toon actieve projecten en hun budget"

Bekijk alle 47 beschikbare tools in de Documentatie.

Je kiest zelf welke AI je gebruikt

Wij sturen je boekhouddata naar de AI die jij configureert. Check de privacy-instellingen van jouw AI-provider om te bepalen hoe zij met je data omgaan.

Bekijk privacy tips per AI →

Problemen oplossen

De AI ziet de MCP server niet

Controleer of de JSON syntax correct is (geen trailing comma's)
Zorg dat je de app volledig hebt herstart
Check of de URL correct is: https://api.praatmetjeboekhouding.nl/mcp

"Authentication required" of "Unauthorized" fout

Controleer of je API key correct is gekopieerd (inclusief exa_ prefix)
Check of de header exact Bearer JOUW_KEY is (met spatie na Bearer)
Genereer een nieuwe key via Dashboard

"No connections found" fout

Je hebt nog geen Exact Online account verbonden
Ga naar Verbinden om je account te koppelen

"Token expired" fout

Je Exact Online token is verlopen (na 30+ dagen inactiviteit)
Verbind opnieuw om een nieuwe token te krijgen

"Server disconnected" of "Verbinding verbroken" (Claude Desktop)

Dit kan gebeuren als je login-token is verlopen na langere inactiviteit. Oplossing:

Sluit Claude Desktop volledig af (Taakbeheer / Activity Monitor)
Wis opgeslagen login: verwijder de map ~/.mcp-auth/
Start Claude Desktop opnieuw en stel een vraag - je browser opent voor een nieuwe login

Meer details in de Claude Desktop handleiding

Nog steeds problemen? Neem contact op of bekijk de FAQ.

Andere ondersteunde platforms

Onze MCP-koppeling werkt met elk platform dat het MCP protocol ondersteunt. Naast de bovenstaande tabs werken ook:

Google Gemini

Via Gemini SDK of CLI. Ideaal voor Google Workspace gebruikers.

Microsoft Copilot

Via Copilot Studio. Krachtig met Excel + Python in Excel.

Perplexity AI

Officiële MCP support. Combineer boekhouddata met webonderzoek.

Open WebUI / LM Studio

Gratis, lokale opties. Je data verlaat je computer niet.

Gebruik dezelfde MCP URL: https://api.praatmetjeboekhouding.nl/mcp

Externe bronnen

Meer hulp nodig? Bekijk deze gidsen:

Make.com: MCP gebruiken met ChatGPT - Gedetailleerde gids voor ChatGPT MCP setup
Model Context Protocol (MCP) - Officiële MCP documentatie