Claude Setup

Verbind Claude met je Exact Online boekhouding — via claude.ai (web) of Claude Desktop

Nieuwe simpelere setup!

Geen API keys meer nodig. Log in via je browser wanneer Claude daarom vraagt.

Eerst uitproberen? Gebruik de demo!

Test de koppeling met ons demo bedrijf "Bakkerij De Gouden Croissant B.V." zonder eigen Exact Online account.

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

Vervang de hele config of voeg toe naast je eigen "exact-online" entry.

Hoe werkt het?

  1. 1
    Configureer Claude

    Voeg de MCP server URL toe aan Claude Desktop of Claude Code

  2. 2
    Stel je eerste vraag

    Vraag iets over je boekhouding, bijv. "Wat is mijn omzet deze maand?"

  3. 3
    Log in via je browser

    Je browser opent automatisch. Log in met je Exact Online account.

  4. 4
    Klaar!

    Claude heeft nu toegang tot je boekhouding. Je token blijft een tijd geldig, maar kan na langere inactiviteit verlopen. In dat geval log je opnieuw in via je browser.

Claude.ai (web) — Makkelijkste methode

Aanbevolen Geen installatie nodig

De snelste manier om te starten. Je hebt alleen een Claude Pro of Team account nodig op claude.ai. Geen Node.js, geen config bestanden, geen terminal.

  1. 1
    Ga naar Settings

    Open claude.ai → klik op je profiel → Settings → Connectors

  2. 2
    Voeg MCP Connector toe

    Klik op "Add MCP Connector" (of "Add more")

  3. 3
    Voer de URL in 
    https://api.praatmetjeboekhouding.nl/mcp
  4. 4
    Log in bij Exact Online

    Claude opent een browservenster voor Exact Online login. Log in en geef toestemming.

  5. 5
    Klaar!

    Stel je eerste vraag, bijvoorbeeld: "Wat is mijn omzet deze maand?"

Vereisten: Claude Pro of Team abonnement op claude.ai. Geen Node.js nodig, geen config bestanden, geen terminal.

Of gebruik Claude Desktop (hieronder)

Voordat je begint (Claude Desktop)

  • 1
    Claude Desktop geinstalleerd

    Download van claude.ai/download

  • 2
    Node.js geinstalleerd

    Check met node --version of download van nodejs.org

  • 3
    Exact Online account

    Je logt straks in via je browser met je bestaande Exact Online credentials

macOS Setup

Stap 1: Sluit Claude Desktop volledig af

# Forceer afsluiten van Claude Desktop
pkill -9 "Claude" 2>/dev/null || true

Stap 2: Maak config directory aan (indien nodig)

# Maak directory aan
mkdir -p ~/Library/Application\ Support/Claude

Stap 3: Maak de config

# Schrijf de config
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "exact-online": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.praatmetjeboekhouding.nl/mcp"]
    }
  }
}
EOF

Stap 4: Start Claude Desktop

# Open Claude Desktop
open -a "Claude"

Alles-in-een commando

Kopieer dit hele blok en plak in Terminal:

# Alles-in-een: stop Claude, maak config, start Claude
pkill -9 "Claude" 2>/dev/null || true
mkdir -p ~/Library/Application\ Support/Claude
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "exact-online": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.praatmetjeboekhouding.nl/mcp"]
    }
  }
}
EOF
echo "Config aangemaakt:"
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
sleep 2
open -a "Claude"
echo "Claude Desktop wordt gestart..."

Windows Setup

Open PowerShell (zoek naar "PowerShell" in het startmenu)

Stap 1: Sluit Claude Desktop

# Stop Claude Desktop proces
Stop-Process -Name "Claude" -Force -ErrorAction SilentlyContinue

Stap 2: Maak de config

# Maak directory aan indien nodig
New-Item -ItemType Directory -Force -Path "$env:APPDATA\Claude" | Out-Null

# Schrijf config (UTF8 zonder BOM!)
$json = @'
{
  "mcpServers": {
    "exact-online": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.praatmetjeboekhouding.nl/mcp"]
    }
  }
}
'@
$utf8 = New-Object System.Text.UTF8Encoding $false
[IO.File]::WriteAllText("$env:APPDATA\Claude\claude_desktop_config.json", $json, $utf8)

Stap 3: Start Claude Desktop

Start Claude Desktop via het startmenu of:

# Start Claude Desktop
Start-Process "$env:LOCALAPPDATA\Programs\Claude\Claude.exe"

Alles-in-een script

# Alles-in-een script
Stop-Process -Name "Claude" -Force -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force -Path "$env:APPDATA\Claude" | Out-Null
$json = '{"mcpServers":{"exact-online":{"command":"npx","args":["-y","mcp-remote","https://api.praatmetjeboekhouding.nl/mcp"]}}}'
$utf8 = New-Object System.Text.UTF8Encoding $false
[IO.File]::WriteAllText("$env:APPDATA\Claude\claude_desktop_config.json", $json, $utf8)
Write-Host "Config aangemaakt:"
Get-Content "$env:APPDATA\Claude\claude_desktop_config.json"
Start-Sleep -Seconds 2
Start-Process "$env:LOCALAPPDATA\Programs\Claude\Claude.exe"

Linux Setup

Stap 1: Sluit Claude Desktop

# Stop Claude
pkill -9 claude 2>/dev/null || true

Stap 2: Maak de config

# Schrijf config
mkdir -p ~/.config/Claude
cat > ~/.config/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "exact-online": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.praatmetjeboekhouding.nl/mcp"]
    }
  }
}
EOF

Stap 3: Start Claude Desktop

# Start Claude Desktop (afhankelijk van installatie)
claude-desktop &

Eerste keer inloggen

Na het starten van Claude Desktop, stel een vraag over je boekhouding:

"Welke administraties heb ik in Exact Online?"

Claude zal je vragen om in te loggen. Er opent een browser venster waar je:

  1. Inlogt met je Exact Online account
  2. De toegang goedkeurt
  3. Terugkeert naar Claude

Na de eerste keer onthouden we je login. Je hoeft niet elke keer opnieuw in te loggen. Na langere inactiviteit (meer dan een dag) kan het zijn dat je opnieuw moet inloggen via je browser.

Problemen oplossen

MCP server verschijnt niet

  • Zorg dat Claude Desktop volledig is afgesloten (niet geminimaliseerd)
  • Check via Taakbeheer/Activity Monitor dat geen Claude processen draaien
  • Controleer of de config JSON geldig is (geen komma's of quotes fout)

Browser opent niet voor login

  • Controleer of je standaard browser correct is ingesteld
  • Probeer de MCP server te verwijderen en opnieuw toe te voegen
  • Herstart Claude Desktop volledig

npx command not found

Node.js is niet geinstalleerd. Installeer via:

# macOS (met Homebrew)
brew install node

# Windows: download installer van https://nodejs.org

# Linux (Ubuntu/Debian)
sudo apt install nodejs npm

"Server disconnected" of "Verbinding verbroken"

Dit kan gebeuren als je login-token is verlopen (na langere inactiviteit). Volg deze stappen:

  • Sluit Claude Desktop volledig af (via Taakbeheer/Activity Monitor, niet alleen het venster)
  • Wis de opgeslagen login: verwijder de map ~/.mcp-auth/ (macOS/Linux) of %USERPROFILE%\.mcp-auth (Windows)
  • Start Claude Desktop opnieuw en stel een vraag. Je browser opent voor een nieuwe login.

Tip: als de browser niet opent, wacht 2 minuten en probeer opnieuw. Soms moet een achtergrondproces eerst stoppen.

Login lukt niet

  • Controleer of je Exact Online account actief is
  • Probeer in een incognito/private venster in te loggen
  • Clear je browser cookies voor Exact Online

Alternatief: Claude Code (CLI)

Claude Code is de command-line versie en werkt vaak betrouwbaarder met MCP servers:

# Voeg MCP server toe
claude mcp add exact-online https://api.praatmetjeboekhouding.nl/mcp

# Start Claude Code
claude

Testen of het werkt

Na het inloggen, vraag:

"Wat is mijn omzet van afgelopen maand?"

Of:

"Welke facturen staan nog open?"

Als je een antwoord krijgt met data uit je boekhouding, werkt de koppeling!

Terug naar dashboard Alle documentatie