Verbinden in één minuut

1. 1 Ga in Claude naar Customize → Connectors
2. 2 Klik op + en daarna op Add custom connector
3. 3 Plak de server-URL: https://mcp.herkend.nl/bedrijfsdata
4. 4 Laat de velden onder Advanced settings leeg en bevestig met Add
5. 5 Klik Connect en log in met je Herkend-account

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

De twee velden onder Advanced settings zijn OAuth client id en secret, geen headernaam en -waarde. Een API-sleutel die je daar invult komt binnen als client_id, waarna Claude een OAuth-server gaat zoeken die niet bestaat. Op een Team- of Enterprise-account zet de eigenaar de connector eerst klaar via Organization settings → Connectors; daarna staat hij bij de leden onder Customize.

1. 1 Voeg de server toe met het commando hieronder, in je terminal en niet in een claude-sessie
2. 2 Controleer met claude mcp list: er staat ! Needs authentication, en dat hoort zo
3. 3 Start een sessie met claude en typ /mcp
4. 4 Kies herkend, druk op enter en kies Authenticate
5. 5 Je browser opent; log in met je Herkend-account. Daarna staat de server op connected

In je terminal

claude mcp add --transport http herkend https://mcp.herkend.nl/bedrijfsdata

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

Sinds v2.1.186 kan het ook zonder sessie: claude mcp login herkend. Werk je op een machine zonder browser — een server via SSH — dan zijn er twee wegen: claude mcp login herkend --no-browser toont een URL die je zelf ergens anders opent, of je geeft een sleutel mee bij het toevoegen: claude mcp add --transport http herkend https://mcp.herkend.nl/bedrijfsdata --header "X-API-Key: JOUW_SLEUTEL". Voeg je de server toe met --scope user, dan staat hij in al je projecten in plaats van alleen in dit ene.

1. 1 Zet in ChatGPT Developer mode aan. Waar die schakelaar staat verschilt per account — zoek in je instellingen op Developer mode; hij staat onder Apps of onder Security and login
2. 2 Maak de server aan via Apps → Create
3. 3 Plak de server-URL: https://mcp.herkend.nl/bedrijfsdata
4. 4 Kies de manier van inloggen, klik Scan Tools en daarna Create
5. 5 Doorloop de OAuth-inlogflow

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

ChatGPT verbindt via OAuth, niet via een API-sleutel. Onze server ondersteunt OAuth 2.1 met PKCE. Koppelen kan alleen in de browser, niet in de mobiele app, en wat je mag hangt af van je abonnement: volgens het helpcentrum van OpenAI is volledige MCP-ondersteuning in bèta voor Business, Enterprise en Edu, en kan een Pro-account alleen servers koppelen die lezen en ophalen.

In ~/.cursor/mcp.json

{
  "mcpServers": {
    "herkend-bedrijfsdata": {
      "type": "http",
      "url": "https://mcp.herkend.nl/bedrijfsdata"
    }
  }
}

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

In .vscode/mcp.json in je project

{
  "servers": {
    "herkend-bedrijfsdata": {
      "type": "http",
      "url": "https://mcp.herkend.nl/bedrijfsdata"
    }
  }
}

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

Wil je de server in élk project, zet hem dan niet in .vscode/mcp.json maar in het mcp.json van je gebruikersprofiel — te openen met MCP: Open User Configuration in het opdrachtenpalet.

In ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "herkend-bedrijfsdata": {
      "serverUrl": "https://mcp.herkend.nl/bedrijfsdata"
    }
  }
}

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

Dit pad hoort bij de Cascade-agent. Werk je met de nieuwere standaardagent (Devin Local), dan leest die .devin/mcp_config.json in je project, met "url" en "transport": "http" in plaats van serverUrl. Kijk dus eerst welke agent je gebruikt, anders bewerk je het verkeerde bestand.

In je Zed settings.json

{
  "context_servers": {
    "herkend-bedrijfsdata": {
      "url": "https://mcp.herkend.nl/bedrijfsdata"
    }
  }
}

Je logt in met je Herkend-account. Je maakt zelf geen geheim aan en kopieert niets: je client regelt de toegang en vernieuwt hem, en je trekt de koppeling in vanuit je account.

Liever klikken? Settings → AI → MCP Servers → Add Server → Add Remote Server schrijft hetzelfde blok voor je weg. Laat je de headers weg, dan start Zed zelf de inlogflow.

Rechtstreeks via JSON-RPC, om het kaal te proberen

curl -s -X POST https://mcp.herkend.nl/bedrijfsdata \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: JOUW_SLEUTEL" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"herkend_market_saturation",
                 "arguments":{"branche":"kapper","gebied_code":"Amsterdam"}}}'