Een MCP-server toevoegen aan Claude Code

Een externe server via HTTP toevoegen

Een externe server is een URL. Claude Code spreekt er streamable HTTP mee, dus de hele registratie is één regel:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp

Het eerste argument na het transport is de naam die u terugziet in /mcp en in de toolnamen; het tweede is het eindpunt. Servers die met OAuth authenticeren, hebben op de commandoregel niets extra's nodig: de eerste keer dat u /mcp opent, selecteert u de server en opent Claude Code de browser voor de aanmelding en toestemming, waarna het het verkregen token opslaat en zelf ververst. Vanaf Claude Code 2.1.186 kunt u de aanmelding ook buiten de interactieve sessie uitvoeren, met claude mcp login hosttracker, en op een machine zonder browser --no-browser toevoegen om een URL te krijgen die u elders kunt plakken.

Servers die in plaats daarvan een statisch token verwachten, nemen dat als header aan:

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

Een paar oudere servers spreken nog het SSE-transport. Dat is verouderd ten gunste van HTTP, en sinds Claude Code 2.1.265 probeert --transport http eerst HTTP en wijkt pas naar SSE uit als de server dat weigert, dus --transport sse is nog maar zelden nodig.

Een lokale server toevoegen

Een lokale server is een programma dat Claude Code voor u start en aanspreekt via standaard in- en uitvoer. Zet het commando en de argumenten achter een dubbel streepje, zodat de eigen vlaggen van Claude Code niet worden verward met die van de server:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

Omgevingsvariabelen die de server nodig heeft, geeft u mee via --env (korte vorm -e), herhaald voor elke variabele. Eén gedocumenteerde valkuil: de optieparser leest alles wat op --env KEY=value volgt als nog een paar, zet de servernaam dus niet direct erachter; plaats er een andere optie tussen, of zet --env vóór --transport:

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

Als u de configuratie van de server al als JSON heeft, bijvoorbeeld uit de README, neemt claude mcp add-json <name> '<json>' die ongewijzigd over, inclusief type, command, args en env.

Een scope kiezen: dit project, het team, of overal

Standaard wordt een server toegevoegd in de lokale scope, wat betekent alleen dit project, opgeslagen in uw eigen ~/.claude.json. Er bestaan twee andere scopes:

• --scope project schrijft de vermelding naar een bestand .mcp.json in de root van de repository. Commit het en elke medewerker krijgt dezelfde server; Claude Code vraagt elke persoon de eerste keer om goedkeuring.
• --scope user maakt de server beschikbaar in elk project op uw machine, maar blijft alleen voor u zichtbaar.

Bestaat dezelfde naam in meer dan één scope, dan wint lokaal van project, en project van user. De hele vermelding komt uit de winnende scope; velden worden nooit tussen scopes samengevoegd. Een verstandige verdeling is --scope user voor diensten die aan uw eigen account zijn gebonden, zoals een monitoring- of ticketingserver, en --scope project voor tooling die het hele team moet delen.

Controleren of het werkt

Voer claude mcp list uit buiten een sessie. Elke server toont een van enkele statussen: verbonden, authenticatie vereist, verbinding mislukt (sinds 2.1.219 met de HTTP-status of foutmelding erbij), goedkeuring in behandeling voor een niet-goedgekeurde projectserver, of uitgeschakeld voor dit project. Binnen een sessie toont /mcp dezelfde servers met hun aantal tools, en kunt u voor een server die dat nodig heeft de aanmelding starten, de authenticatie wissen, of de server voor het huidige project uitschakelen zonder hem te verwijderen.

Een snelle functionele test is een verzoek dat alleen de server kan beantwoorden. Met de HostTracker-server verbonden vraagt u bijvoorbeeld "welke van mijn monitors zijn nu down?" of "voer een HTTP-controle op example.com uit vanaf drie locaties"; de assistent moet dan een tool aanroepen die naar de server is vernoemd en een resultaat citeren dat hij niet kon weten. Gebeurt er niets, dan ligt dat meestal aan de toollijst: /mcp toont nul tools voor een server die wel verbonden is maar bij autorisatie is mislukt.

Verwijderen, inspecteren en importeren

claude mcp get <name> toont de volledige configuratie en scope van één server. claude mcp remove <name> verwijdert hem samen met alle opgeslagen OAuth-tokens. Heeft u servers eerst in Claude Desktop ingesteld, dan importeert claude mcp add-from-claude-desktop ze interactief; dat werkt op macOS en op Windows Subsystem for Linux, niet op native Windows of native Linux, en slaat een Desktop-server over wiens naam tekens bevat die Claude Code niet toestaat (alleen letters, cijfers, streepjes en underscores).

Een monitoringserver als eerste test

Een monitoringdienst is een goede eerste server om aan te sluiten, omdat het resultaat van een toolaanroep meteen te verifiëren is: de assistent zegt dat een site bereikbaar is, en u kunt hem openen. De server van HostTracker heeft geen lokale installatie nodig, authenticeert met OAuth in de browser, en biedt directe controles vanaf 300 of meer locaties plus de monitors, incidenten, onderhoudsvensters en statuspagina's van uw account, zodat "staat productie online?" wordt beantwoord vanuit echte controlepunten in plaats van trainingsdata. De verwante handleiding over .mcp.json-configuratie en probleemoplossing behandelt het bestandsformaat, omgevingsvariabelen en de fouten die in de praktijk voorkomen.