MCP-servers koppelen aan Claude Code

Wat is MCP?

MCP staat voor Model Context Protocol. Het is een open standaard waarmee AI-tools verbinding maken met externe systemen. Een MCP-server geeft Claude Code toegang tot een extern systeem, zoals een database of een API.

De documentatie geeft een handig signaal voor wanneer je een server koppelt: als je merkt dat je steeds gegevens uit een ander systeem in het gesprek plakt. Na het koppelen leest Claude die gegevens zelf en kan het in dat systeem aan de slag.

Wat kun je ermee?

De documentatie noemt onder meer deze voorbeelden:

• Een feature bouwen op basis van een ticket in je issuetracker.
• Een database bevragen.
• Concepten klaarzetten in Gmail.

Welke koppeling je nodig hebt, hangt af van de systemen waarmee je dagelijks werkt.

Een MCP-server toevoegen

Voor een server op afstand gebruik je HTTP. Dat is volgens de documentatie de aanbevolen manier:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Een lokale server draait als proces op je eigen computer. Die voeg je toe met --transport stdio. Alles na de dubbele streep -- is het commando dat de server start:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Die dubbele streep is belangrijk. Zonder -- probeert Claude Code de opties van de server als eigen opties te lezen. Het oudere SSE-transport is volgens de documentatie verouderd. Gebruik HTTP waar dat kan.

Welke scope kies je?

De scope bepaalt in welke projecten een server laadt en of je team hem ook krijgt.

Scope	Laadt in	Gedeeld met team	Opgeslagen in
local (standaard)	Alleen het huidige project	Nee	~/.claude.json
project	Alleen het huidige project	Ja, via versiebeheer	.mcp.json in de projectmap
user	Al je projecten	Nee	~/.claude.json

Je kiest de scope met --scope, bijvoorbeeld:

claude mcp add --transport http shared-server --scope project https://example.com/mcp

Servers met inloggegevens die niet in je repository horen, zet je in de scope local. Staat dezelfde server in meer scopes, dan wint local, daarna project, daarna user.

API-sleutels buiten je repository houden

Deel je een server met je team via .mcp.json, dan wil je geen sleutels in dat bestand. Claude Code vult omgevingsvariabelen in op plekken als de url en de headers. Met ${VAR} gebruik je de waarde van een variabele en met ${VAR:-standaard} geef je een terugvaloptie mee:

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

Iedereen in het team zet dan zijn eigen API_KEY op zijn eigen computer. Zo bevat het gedeelde bestand zelf geen sleutels.

Servers beheren en inloggen

Met deze commando's beheer je je servers vanuit de terminal:

claude mcp list
claude mcp get notion
claude mcp remove notion

Binnen een sessie typ je /mcp. Je ziet dan de status van elke server. Vraagt een server om in te loggen, dan start je daar de inlogstap via OAuth en rond je die af in je browser. Vanuit de terminal kan dat ook met claude mcp login <naam>.

Wil je een server even niet gebruiken? Zet hem uit in het overzicht van /mcp. Claude Code maakt dan geen verbinding meer. Je instellingen blijven bewaard en later zet je hem daar weer aan.

Gebruik je Claude Code met een claude.ai-account? Dan zijn de connectors die je op claude.ai hebt toegevoegd ook in Claude Code beschikbaar.

Voorbeeld: GitHub koppelen

De GitHub-server werkt met een persoonlijk toegangstoken in een header:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Let op: claude mcp add controleert het token niet bij het opslaan. Check daarom met /mcp of de server echt verbonden is. Daarna vraag je bijvoorbeeld om alle open pull requests die aan jou zijn toegewezen.

Waar let je op bij beveiliging?

• Vertrouw de bron. Anthropic raadt aan om zelf servers te schrijven of servers te gebruiken van aanbieders die je vertrouwt. Anthropic beoordeelt connectors voordat ze in de Anthropic Directory komen. Een beveiligingsaudit van MCP-servers doet Anthropic zelf niet.
• Prompt injection. Servers die externe inhoud ophalen, kunnen je blootstellen aan prompt injection. Daarbij probeert tekst van buitenaf Claude andere opdrachten te geven.
• Projectservers. In een interactieve sessie vraagt Claude Code eerst om goedkeuring voor servers uit een .mcp.json. Met claude mcp reset-project-choices zet je die keuzes terug. In een claude -p-run laadt Claude Code projectservers zonder te vragen.
• Servers buiten .mcp.json. Servers uit andere scopes, plugins en claude.ai-connectors staan buiten de repository. Wil je weten wat er echt geladen is, kijk dan in /mcp.

Wil je MCP-tools extra bewaken, dan kun je een hook instellen met een matcher als mcp__github__.*.

Leg ook in je CLAUDE.md vast welke servers er in een project zijn en waarvoor je ze gebruikt. Dan weet Claude aan het begin van elke sessie welke koppeling bij welke taak hoort.

Je eigen koppelingen inrichten

Welke servers je koppelt en hoe je ze afschermt, hangt af van je werk. In een 1-op-1 Claude Code-coachsessie van 3 uur loopt Tarik Eraslan je setup met je door, op locatie in Amsterdam-Zuid of digitaal via Microsoft Teams, vanaf €449 ex btw. Met het pakket training plus een week ondersteuning via WhatsApp krijg je daarna een week hulp bij het bouwen, voor €850 ex btw.