Hoe voeg je MCP-servers toe aan Claude Code en deel je ze met je team?

Kort antwoord

Je voegt een MCP-server aan Claude Code toe met claude mcp add. Met --scope project komt hij in een .mcp.json in de repository, zodat iedereen die de repo kloont dezelfde servers krijgt na een akkoord. Sleutels blijven uit het bestand via ${VAR} of inloggen met OAuth per persoon. Beheerders leggen de servers voor de hele organisatie vast of filteren ze met managed-mcp.json, managedMcpServers en allow- en denylists.

Drie scopes, en welke deelt

Elke server die je toevoegt, komt in een scope. De scope bepaalt wie hem nog meer krijgt.

Scope Laadt in Gedeeld met het team Opgeslagen in
local (standaard) Dit project, alleen voor jou Nee ~/.claude.json
project Dit project, voor iedereen Ja, via git .mcp.json in de hoofdmap
user Al jouw projecten Nee ~/.claude.json

Je kiest met -s of --scope:

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project --transport stdio mijntool -- npx -y een-mcp-server

De -- scheidt de opties van Claude Code van het commando dat een lokale server start. Voor remote servers gebruik je http; SSE werkt nog maar is verouderd.

Staat dezelfde naam op meer plekken, dan neemt Claude Code het hele item van de hoogste bron: local, dan project, dan user, dan servers uit plugins, dan connectors uit claude.ai. Velden worden niet samengevoegd.

Delen via de repo, stap voor stap

  1. Voeg de server toe met --scope project. Claude Code schrijft hem in .mcp.json.
  2. Houd sleutels uit het bestand. Gebruik ${VAR} of ${VAR:-standaard} in url, headers, command, args of env. Elke ontwikkelaar zet de variabele op zijn eigen machine. Nog beter: een remote server met OAuth, dan heeft niemand een sleutel nodig.
  3. Commit .mcp.json. Collega’s krijgen hem bij de volgende pull.
  4. Iedereen geeft akkoord. In een interactieve sessie vraagt Claude Code eerst toestemming voor servers uit de projectscope. Tot dan toont claude mcp list ze als wachtend.
  5. Iedereen logt zelf in. Bij OAuth-servers via /mcp of claude mcp login <naam>, als zichzelf.

Let op: bij niet-interactief gebruik (claude -p), in Agent SDK-sessies en in sommige cloudsessies laden servers uit de projectscope zonder vraag. Een .mcp.json in een repo die je zonder mens laat draaien, wordt dus gewoon vertrouwd.

Wil je een server alleen voor één taak en niet in elke sessie van het team, dan kan dat met een subagent. In de frontmatter van een subagent staat het veld mcpServers: een inline definitie verbindt pas als de subagent start en gaat weer weg als hij klaar is, en de hoofdconversatie krijgt de tools niet te zien. Volgens de documentatie voorkom je zo ook dat de tooldescripties van die server ruimte in de hoofdcontext innemen. Zo’n inline server uit een map in de repo laadt pas nadat je die map vertrouwt, en voor subagents die uit een plugin komen wordt het veld genegeerd.

Beheer voor de hele organisatie

Standaard mag iedereen die Claude Code draait elke MCP-server koppelen. Anthropic schrijft zelf dat het connectors voor zijn directory beoordeelt, maar MCP-servers niet op veiligheid controleert of beheert. Beheerders hebben een paar patronen:

Patroon Wat het doet Hoe
Vaste set Jouw vaste set laadt, naast ondersteunde beheerde en door de host geleverde aanvullingen managed-mcp.json met jouw servers
MCP uit Gebruikersconfiguraties laden niet; beheerde en door de host geleverde uitzonderingen blijven managed-mcp.json met een lege mcpServers
Meegeleverde servers Iedereen krijgt jouw remote servers en houdt zijn eigen managedMcpServers in de beheerde instellingen
Goedgekeurde lijst Alleen servers op de lijst mogen erbij allowedMcpServers met allowManagedMcpServersOnly: true
Blokkeerlijst Bekende foute servers tegenhouden deniedMcpServers

managed-mcp.json staat op een systeempad (op Windows %ProgramFiles%\ClaudeCode\, op macOS /Library/Application Support/ClaudeCode/, op Linux /etc/claude-code/) en gaat meestal mee via Intune, Group Policy of ander apparaatbeheer. Match op serverUrl of serverCommand: Anthropic waarschuwt dat serverName geen beveiliging is, want iedereen kan elke server “github” noemen.

Het misverstand

“Staat het in .mcp.json, dan heeft het team dezelfde AI.” Het team heeft dezelfde koppelingen, niet dezelfde kennis. Elke sessie van Claude Code begint opnieuw, met de CLAUDE.md-bestanden en het eigen geheugen van die ene ontwikkelaar. Wat Claude gisteren van de correcties van een collega leerde, komt niet in jouw sessie. En .mcp.json werkt alleen in Claude Code: de collega in Cursor of Codex zet dezelfde servers in een ander bestand.

Wat dit voor een team betekent

.mcp.json is de goede manier om elke Claude Code-gebruiker dezelfde tools te geven: GitHub, je tracker, je documentatie. Combineer het met heldere afspraken over welke servers mogen schrijven, en met OAuth in plaats van gedeelde sleutels. Hoe je GitHub koppelt, lees je in de GitHub MCP-server. De aparte vraag is hoe wat één ontwikkelaar Claude leert bij de rest komt; daarover gaan heeft Claude Code een geheugen en Claude Code-context delen in een team. Risico’s van MCP staan in is MCP veilig voor bedrijfsgegevens.

Waar Bombos past

Bombos komt in Claude Code binnen als één extra MCP-koppeling, en op dezelfde manier in Cursor, Codex, Copilot, ChatGPT en de andere AI-tools van het team, zodat ze één geheugen delen: teamkennis, regels die de AI uit correcties leerde, en wat al in repo’s, documenten en mail staat, navolgbaar. Het draait in onze cloud of op je eigen server, en één ontwikkelaar kan het eerst zelf proberen met zijn eigen agents.

Vragen die hierbij horen

Waar bewaart Claude Code de MCP-servers?

De scopes local en user staan in ~/.claude.json. De scope project staat in .mcp.json in de hoofdmap van het project, en die zet je in git.

Waarom vraagt Claude Code om akkoord voor servers uit .mcp.json?

Uit veiligheid vraagt Claude Code in een interactieve sessie eerst akkoord voor servers uit de projectscope. Met claude mcp reset-project-choices zet je die keuzes terug.

Hoe log ik in bij een remote MCP-server?

Typ /mcp in Claude Code en rond de inlog in de browser af, of gebruik claude mcp login <naam> in de terminal. Claude Code bewaart en ververst de tokens.

Kan een beheerder MCP-servers blokkeren?

Ja. Een managed-mcp.json bepaalt exclusief welke servers laden, en allowedMcpServers en deniedMcpServers in de beheerde instellingen filteren wat gebruikers toevoegen. Een lege managed-mcp.json blokkeert gebruikersconfiguraties, maar beheerd toegevoegde en door de host geleverde servers kunnen blijven laden.

Bronnen

  1. Connect Claude Code to tools via MCP (Claude Code docs)
  2. Control MCP server access for your organization (Claude Code docs)
  3. Claude Code docs: Subagents
Het eerste half uur · kosteloos

Wat vergeet jullie AI?

  1. 01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
  2. 02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
  3. 03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.
Piet Baudoin
Piet BaudoinJe spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa
We reageren dezelfde werkdag.