Een MCP-server toevoegen aan Claude Code: commando's, scopes en oplossingen

De gebruikelijke manier om Claude Code aan een tool te koppelen is drie verschillende installatiepagina's lezen, een commando kopiëren dat net niet klopt voor jouw systeem en je afvragen waarom er niets verschijnt. In werkelijkheid is het één commando en één controle, zolang je weet welke soort server je toevoegt.

Deze gids geeft je de commando's voor de drie soorten servers, legt de scopes uit die bepalen wie de server krijgt en behandelt aanmelden, veiligheid en de oplossingen voor wat misgaat. Is MCP nieuw voor je, begin dan met Wat is MCP?.

Wat je nodig hebt

Koppel een server wanneer je merkt dat je gegevens uit een andere tool naar de chat kopieert. Zodra hij verbonden is, kan Claude uit dat systeem lezen en er rechtstreeks in handelen.

Drie soorten servers

Welk commando je gebruikt, hangt af van hoe de server met jou verbindt.

Externe HTTP-server

De basisvorm is voor elke dienst hetzelfde:

claude mcp add --transport http <name> <url>

Een echt voorbeeld koppelt Notion:

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

Heeft de server een token nodig, geef het dan mee als header:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Externe SSE-server (verouderd)

De SSE-methode is verouderd, dus gebruik HTTP wanneer de dienst dat aanbiedt. Heeft een dienst alleen SSE, dan gebruikt het commando een ander transport:

claude mcp add --transport sse asana https://mcp.asana.com/sse

Lokale stdio-server

Een stdio-server is een programma dat op je eigen machine draait en door Claude Code wordt gestart. De basisvorm heeft een dubbel streepje, en alles erna is het commando dat de server start:

claude mcp add [options] <name> -- <command> [args...]

Een voorbeeld dat een Airtable-server met een API-sleutel toevoegt:

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

Controleer of het gelukt is

Nadat je een server hebt toegevoegd, controleer je hem vanuit je terminal of vanuit Claude Code.

$ claude mcp list$ claude mcp get notion$ claude mcp remove notion

Typ in een sessie /mcp om de status van elke server te zien. Je ziet een van drie toestanden: verbonden, aanmelding nodig of verbinden mislukt.

Aanmelden met OAuth

Veel cloudservers gebruiken OAuth 2.0, de aanmeldmethode "log in met je account". De eenvoudigste weg heeft twee stappen.

Vanuit de shell kun je ook claude mcp login <name> en claude mcp logout <name> draaien. Tokens worden veilig opgeslagen en automatisch vernieuwd. Om toegang in te trekken gebruik je Clear authentication (Authenticatie wissen) in het menu van /mcp.

Scopes: wie krijgt de server

Wanneer je een server toevoegt, kies je zijn scope. De scope bepaalt welke projecten hem zien en of je team hem deelt.

Kies er een met de vlag --scope:

# Project scope: shared with your team
claude mcp add --transport http shared-server --scope project https://example.com/mcp

# User scope: available in all your projects
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

Een server met projectscope schrijft een bestand .mcp.json in de hoofdmap van je project, dat je commit zodat iedereen dezelfde verbinding krijgt:

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Komt dezelfde servernaam in meer dan één scope voor, dan verbindt Claude Code één keer, met de definitie van de bron met de hoogste voorrang: eerst local, dan project, dan user.

Open je een project met een .mcp.json van iemand anders, dan vraagt Claude Code in een interactieve sessie om je goedkeuring voordat het de servers ervan gebruikt. Om die keuzes te resetten draai je claude mcp reset-project-choices.

Populaire servers die je nu kunt toevoegen

Deze voorbeelden komen uit de officiële documentatie. Lees altijd de eigen pagina van de dienst voor het actuele adres.

Let bij de database op de gebruikersnaam: readonly. Geef Claude een databaseaccount dat alleen kan lezen. Die ene keuze voorkomt de duurste fout die je kunt maken.

Je kunt ook door beoordeelde connectors bladeren in de map van Anthropic op claude.ai/directory. En heb je een connector in claude.ai toegevoegd, dan is die al beschikbaar in Claude Code wanneer je je aanmeldt met je Claude-account.

Blijf veilig

Een MCP-server geeft Claude toegang tot een systeem, en sommige servers halen inhoud van buiten op, zoals webpagina's of tickets die vreemden hebben geschreven.

Dat laatste punt hangt samen met hoeveel Claude doet zonder te vragen. Zie Claude Code: permission modes en Plan-modus uitgelegd om dat te bepalen.

In Claude Tutorial

Een tool vertrouwen is een beslissing, geen standaard

Beoordelen welke systemen toegang verdienen, en voor welke acties, is een vaardigheid die ver buiten code reikt, en de app oefent die met echte scenario's.

Binnenkort

Download in deApp Store

DOWNLOAD VIAGoogle Play

Limieten en afstellen

Twee limieten helpen gedrag te verklaren dat anders vreemd lijkt.

• Grote resultaten. Claude Code toont een waarschuwing wanneer de uitvoer van een tool 10.000 tokens overschrijdt, en beperkt de uitvoer standaard tot 25.000 tokens. Om de limiet te verhogen zet je de variabele MAX_MCP_OUTPUT_TOKENS, bijvoorbeeld MAX_MCP_OUTPUT_TOKENS=50000.
• Trage servers. Om te wijzigen hoe lang Claude Code op het starten van een server wacht, zet je MCP_TIMEOUT. Bijvoorbeeld: MCP_TIMEOUT=10000 claude geeft tien seconden.

Tool search staat standaard aan, zodat je context niet vol raakt met alle toolbeschrijvingen tegelijk. Draai /context om te zien wat ruimte inneemt.

Als het niet werkt

Past niets hiervan, vraag Claude Code dan om hulp: plak de fout en vraag wat ze betekent. Met /doctor controleer je ook je installatie.

Veelgestelde vragen

Hoe voeg ik een MCP-server toe aan Claude Code?

Draai claude mcp add --transport http <name> <url> voor een externe server, of claude mcp add <name> -- <command> voor een lokale. Draai daarna /mcp in Claude Code om de status te controleren en je aan te melden.

Waar slaat Claude Code MCP-servers op?

Servers met local en user scope staan in ~/.claude.json. Servers met projectscope staan in een bestand .mcp.json in de hoofdmap van je project, dat je kunt committen.

Wat is het verschil tussen local, project en user scope?

Local geldt voor het huidige project en alleen voor jou. Project geldt voor het huidige project en wordt met je team gedeeld. User geldt voor al je projecten en alleen voor jou.

Hoe verwijder ik een MCP-server?

Draai claude mcp remove <name>. Om je af te melden bij een server zonder hem te verwijderen gebruik je claude mcp logout <name>.

Wat betekent het dubbele streepje in claude mcp add?

Het scheidt de eigen opties van Claude Code van het commando dat de server start. Alles erna wordt ongewijzigd aan de server doorgegeven.

Zijn MCP-servers veilig?

Alleen zo veilig als de servers die je kiest en de toegang die je geeft. Gebruik vertrouwde servers, databaseaccounts die alleen lezen en een permission mode waarin je ziet wat Claude doet.

Kan ik mijn claude.ai-connectors in Claude Code gebruiken?

Ja. Connectors die je in claude.ai toevoegt, zijn beschikbaar in Claude Code, in de terminal en in cloudsessies, wanneer je je aanmeldt met je Claude-account.

Je MCP-checklist voor Claude Code

Verder lezen

• Wat is MCP? Het Model Context Protocol eenvoudig uitgelegd voor het idee erachter.
• Connectors toevoegen in Claude: de map, een eigen URL en veiligheid voor hetzelfde in de Claude-apps.
• Claude Code: gewoonten voor betere resultaten om goed te werken zodra de tools gekoppeld zijn.
• CLAUDE.md uitgelegd: leer Claude Code je project één keer kennen om Claude te vertellen hoe het de gekoppelde tools in je project gebruikt.