Claude verbinden met een MCP-server

Om Claude te verbinden met een MCP-server zoals mcp-core, wijs je de client naar http://localhost:3200/mcp en stuur je bij elk verzoek het token van een van je seats mee. Claude Code kan de pluginbundel uit je download gebruiken. Claude Desktop gebruikt een aangepaste connector. Beide zien alleen de tools die die seat mag gebruiken.

Wat heb je nodig om Claude te verbinden met een MCP-server?

Je hebt een draaiende mcp-core-container nodig en een seat-token. Draait de container nog niet, volg dan eerst MCP Self-hosted installeren. Tokens staan in Mijn account → MCP Self-hosted, op het tabblad Seats van je licentie: elke rij heeft een kopieerknop in de kolom Token. Je eerste seat, “Default install”, wordt aangemaakt wanneer je download wordt gebouwd; het token daarvan is ook de waarde van BEARER_TOKEN in .env.

Gebruik één seat per persoon of apparaat. Zo kun je één token opnieuw genereren of intrekken zonder de andere te breken. MCP-seats legt uit hoe je ze toevoegt.

Welke URL gebruik je om Claude te verbinden met een MCP-server?

Gebruik /mcp, het Streamable HTTP-endpoint. mcp-core houdt ook het legacy SSE-transport aan op /sse voor oudere clients. Gebruik Streamable HTTP zodra de client het ondersteunt.

Streamable HTTP:  http://localhost:3200/mcp
Legacy SSE:       http://localhost:3200/sse

Het compose-bestand bindt poort 3200 aan 127.0.0.1, dus deze URL’s werken alleen op de machine waarop de container draait. Wil je verbinden vanaf een andere machine, zet dan een reverse proxy met HTTPS voor de container en zet SERVER_URL in .env op het publieke adres. mcp-core gebruikt die waarde in zijn discovery-antwoorden, die sommige clients lezen voordat ze authenticeren.

Hoe stuur je het token mee?

Elk verzoek heeft het token van één seat nodig. De standaardmanier om het mee te sturen is een Authorization-header:

Authorization: Bearer YOUR_CONNECTION_TOKEN

Sommige connectorschermen laten je alleen kiezen uit een vaste lijst headernamen. mcp-core accepteert het kale token, zonder het voorvoegsel Bearer, ook in elk van deze headers: X-Api-Key, Api-Key, ApiKey, Api-Token, X-Auth-Token of X-Access-Token.

Hoe verbind je Claude Code met de pluginbundel?

Elke download bevat een map claude-plugin/ en een bestand INSTALL-CLAUDE-PLUGIN.md. De plugin is vooraf ingevuld met de lokale URL en je token van “Default install”, dus je verbindt Claude met een MCP-server zonder JSON te bewerken. Start Claude Code in de bundelmap en draai:

/plugin marketplace add ./claude-plugin
/plugin install mcp-core@claude-plugin

Vraag Claude daarna om mcp_status te draaien. Je krijgt de licentiestatus en de tools en modi van je seat terug. De pluginconfiguratie staat in claude-plugin/.mcp.json:

{
  "mcpServers": {
    "mcp-core": {
      "type": "http",
      "url": "http://localhost:3200/mcp",
      "headers": { "Authorization": "Bearer YOUR_CONNECTION_TOKEN" }
    }
  }
}

Genereer je het token van die seat later opnieuw, werk dan de header in dit bestand bij en herstart Claude Code.

Hoe voeg je de server handmatig toe aan Claude Code?

Gebruik het commando claude mcp add met het HTTP-transport en de token-header. Via deze route verbind je Claude met een MCP-server met elke andere seat dan “Default install”:

claude mcp add --transport http mcp-core http://localhost:3200/mcp \
  --header "Authorization: Bearer YOUR_CONNECTION_TOKEN"

Hoe verbind je Claude Desktop?

Om Claude vanuit Claude Desktop met een MCP-server te verbinden, voeg je een aangepaste connector toe en vul je de /mcp-URL van je server in. De connector doorloopt een OAuth-achtige setup en vraagt om een Client ID. Plak daar je seat-token. mcp-core rondt de setup voor die seat dan direct af.

Laat je de Client ID leeg, dan toont mcp-core een pagina met de titel “Choose a connection” met de labels van alle seats op je licentie. Die pagina heeft geen wachtwoord. Plak op een licentie met meerdere seats dus het token, zodat niemand anders die de URL bereikt een seat kan kiezen die niet van hem is. De pagina MCP-authenticatie legt uit waarom deze handshake bestaat.

Kunnen andere clients verbinden?

Ja. Elke MCP-client die Streamable HTTP of SSE ondersteunt, gebruikt dezelfde URL en token-header. De toollijst hangt af van de seat, niet van de client.

Wat als je Claude niet kunt verbinden met een MCP-server?

Begin bij de oorzaak die past bij wat je ziet:

• Connection refused: de container draait niet, of je zit niet op de host. Controleer docker ps en de poortbinding.
• 401 Unauthorized: het token klopt niet, is opnieuw gegenereerd of ingetrokken, of de licentie heeft helemaal geen seats. Het containerlog toont Token rejected voor elk geweigerd verzoek.
• Verbonden, maar er ontbreken tools: de tool staat niet op je licentie, of deze seat heeft hem niet aangevinkt. Zie entitlements vs. toolmodi.
• Alleen leestools: de modus van de seat voor die tool is read-only, de standaard voor elke tool behalve Brain.
• Een wijziging aan token of tool heeft geen effect: de draaiende server hoort pas bij de volgende licentiecheck van wijzigingen. Draai docker exec mcp-core npm run refresh-license om ze nu toe te passen.

Zonder client toont curl http://localhost:3200/health de licentiestatus en de actieve tools.

Heb je Claude op deze manier met een MCP-server verbonden, dan verschijnt elke nieuwe tool op je licentie in dezelfde connector zonder herinstallatie. Volgende stap: geef iedereen een eigen token via MCP-seats.