Claude Code MCP: Server hinzufügen, verwalten und sicher nutzen

Kurzantwort: MCP (Model Context Protocol) ist ein offener Standard, über den Claude Code externe Werkzeuge und Daten anbindet, etwa GitHub, eine Datenbank oder dein Ticketsystem. Einen Server fügst du im Terminal mit claude mcp add hinzu: Remote-Server mit claude mcp add --transport http <name> <url>, lokale Programme mit claude mcp add <name> -- <befehl>. In der laufenden Sitzung zeigt /mcp den Status und startet die Anmeldung per OAuth.

Stand: 20. Oktober 2026. Alle Befehle stammen aus der MCP-Dokumentation von Claude Code, abgerufen an diesem Tag. Die Quellen stehen am Ende. Mehr zu Claude Code allgemein findest du im Claude-Code-Überblick.

Was MCP ist und wofür du es brauchst

Ohne MCP sieht Claude Code nur dein Projekt und das Terminal. Mit MCP-Servern kann es zum Beispiel Pull Requests auf GitHub lesen, Fehler aus Sentry abrufen, eine Postgres-Datenbank abfragen oder Designs aus Figma einbeziehen. Jeder Server bringt eigene Werkzeuge mit, die Claude bei Bedarf aufruft.

MCP ist nicht auf Claude Code beschränkt. Derselbe Server funktioniert auch in anderen MCP-fähigen Werkzeugen wie Claude Desktop oder Cursor. Fertige, geprüfte Server findest du im Anthropic-Verzeichnis, viele weitere bei den jeweiligen Anbietern.

Die drei Arten von MCP-Servern

Art	Wann	Befehl
HTTP (Remote)	Dienst im Netz, etwa Notion, Sentry, GitHub	claude mcp add --transport http <name> <url>
stdio (lokal)	Programm auf deinem Rechner, oft per npx	claude mcp add <name> -- <befehl> [argumente]
SSE (Remote, veraltet)	ältere Server ohne HTTP	claude mcp add --transport sse <name> <url>

Anthropic empfiehlt für Remote-Server HTTP und nennt SSE veraltet. Ab Version 2.1.265 versucht Claude Code bei --transport http zuerst HTTP und wechselt selbst zu SSE, wenn der Server HTTP nicht annimmt.

Einen Server hinzufügen

Ein Remote-Server, hier Notion:

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

Braucht der Server einen festen Schlüssel, gibst du ihn als Header mit:

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

Ein lokaler Server mit Umgebungsvariable:

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

Zwei Stolperstellen aus der Dokumentation:

• Das doppelte Minus -- trennt die Optionen von Claude Code vom Befehl des Servers. Ohne -- würde Claude Code Optionen wie --port des Servers als eigene lesen.
• Steht der Servername direkt hinter --env, liest Claude Code ihn als weiteres Paar und bricht ab. Setze deshalb eine andere Option wie --transport stdio dazwischen.

Ob die Verbindung steht, siehst du mit claude mcp get <name> oder in der Sitzung mit /mcp: Ein Häkchen heißt verbunden, ein ✘ zeigt einen Fehler, zum Beispiel 401 bei falschem Schlüssel. Denn claude mcp add speichert nur die Konfiguration und prüft die Zugangsdaten nicht.

Scopes: für dich, für das Projekt oder überall

Scope	Option	Gilt in	Geteilt	Gespeichert in
Lokal (Standard)	--scope local	nur diesem Projekt	nein	~/.claude.json
Projekt	--scope project	diesem Projekt	ja, über Git	.mcp.json im Projektordner
Nutzer	--scope user	allen deinen Projekten	nein	~/.claude.json

Mit --scope project legt Claude Code eine .mcp.json an, die du ins Repository einchecken kannst. So haben alle im Team dieselben Server:

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

In der .mcp.json darfst du Umgebungsvariablen mit ${VAR} oder ${VAR:-standard} verwenden, etwa für Schlüssel, die nicht ins Repository gehören. Aus Sicherheitsgründen fragt Claude Code nach, bevor es Server aus einer .mcp.json nutzt. Ein frisch geklontes Repository kann seine Server also nicht selbst freischalten.

Ist derselbe Server mehrfach eingetragen, gewinnt lokal vor Projekt vor Nutzer.

Server verwalten

claude mcp list            # alle Server anzeigen
claude mcp get notion      # Details zu einem Server
claude mcp remove notion   # Server entfernen

In der laufenden Sitzung zeigt /mcp alle Server mit Status, ihre Werkzeuge und die Anmeldung. Beim Entfernen eines Remote-Servers löscht Claude Code auch die gespeicherten OAuth-Token.

Hast du Server schon in Claude Desktop eingerichtet, übernimmt claude mcp add-from-claude-desktop sie. Das geht laut Dokumentation nur auf macOS und in WSL.

Anmelden mit OAuth

Viele Remote-Server melden dich per OAuth an, ohne dass ein Schlüssel in der Konfiguration steht. Das Beispiel Sentry:

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Danach in Claude Code /mcp aufrufen und den Schritten im Browser folgen. Alternativ meldest du dich in der Shell mit claude mcp login sentry an und mit claude mcp logout sentry wieder ab. Wichtig für Automatisierung: In claude -p gibt es kein /mcp, die Anmeldung musst du vorher in einer normalen Sitzung erledigen.

Zwei Beispiele aus der Praxis

GitHub für Code-Reviews. Lege in den GitHub-Einstellungen ein fein granuliertes Token nur für die nötigen Repositories an und füge den Server hinzu:

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

Danach geht zum Beispiel „Prüfe PR #456 und schlage Verbesserungen vor“ oder „Zeig mir alle offenen PRs, die mir zugewiesen sind“.

Postgres-Datenbank abfragen. Die Dokumentation nutzt DBHub und rät ausdrücklich zu einem Datenbanknutzer, der nur lesen darf:

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

Dann fragst du in normaler Sprache: „Wie hoch war der Umsatz in diesem Monat?“ oder „Zeig mir das Schema der Tabelle orders“.

MCP-Ressourcen und Befehle

Manche Server bieten Ressourcen an, die du wie Dateien mit @ einbindest, etwa @github:issue://123. Tippst du @, erscheinen sie neben deinen Dateien. Andere Server bringen fertige Prompts mit, die als Befehl erscheinen, zum Beispiel /mcp__github__pr_review 456.

Viele Server mit vielen Werkzeugen belasten den Kontext kaum: Claude Code lädt standardmäßig nur die Namen der Werkzeuge und sucht die Beschreibung erst, wenn es ein Werkzeug braucht (Tool Search).

Grenzen und Sicherheit

• Vertraue nur Servern, die du kennst. Anthropic warnt, dass Server, die fremde Inhalte abrufen, dich für Prompt Injection angreifbar machen: Text auf einer Webseite oder in einem Ticket könnte versuchen, Claude Anweisungen zu geben.
• Rechte klein halten. Nur-Lese-Nutzer für Datenbanken, Tokens nur für die nötigen Repositories.
• Schlüssel nicht einchecken. In der .mcp.json mit ${VAR} arbeiten statt mit dem Klartext.
• Große Antworten. Ab 10.000 Token warnt Claude Code, Standardgrenze sind 25.000 Token. Mit MAX_MCP_OUTPUT_TOKENS=50000 claude hebst du sie an.

Claude Code selbst als MCP-Server

Umgekehrt geht es auch: claude mcp serve startet Claude Code als MCP-Server, den andere Programme wie Claude Desktop nutzen können. Der Befehl gibt beim Start nichts aus und wartet auf einen Client.

Quellen und Stand

Alle Angaben geprüft am 20. Oktober 2026:

• Claude Code: Connect Claude Code to tools via MCP
• Claude Code: Überblick
• Model Context Protocol: offizielle Seite
• Anthropic-Verzeichnis für Connectoren

Häufige Fragen

Was ist MCP in Claude Code?

MCP steht für Model Context Protocol, einen offenen Standard für die Verbindung von KI-Werkzeugen mit externen Daten und Diensten. In Claude Code bindest du darüber zum Beispiel GitHub, Datenbanken oder Ticketsysteme an. Jeder MCP-Server bringt Werkzeuge mit, die Claude bei Bedarf nutzt.

Wie füge ich einen MCP-Server zu Claude Code hinzu?

Im Terminal mit claude mcp add. Für Remote-Server: claude mcp add --transport http <name> <url>. Für lokale Programme: claude mcp add <name> -- <befehl>. Mit claude mcp list prüfst du, ob er eingetragen ist, mit /mcp in der Sitzung, ob er verbunden ist.

Wo speichert Claude Code die MCP-Server?

Lokale und Nutzer-Server stehen in ~/.claude.json, Projekt-Server in der Datei .mcp.json im Projektordner. Nur die .mcp.json ist zum Teilen über Git gedacht.

Wie melde ich mich bei einem MCP-Server an?

Remote-Server mit OAuth meldest du in der Sitzung über /mcp an, der Rest läuft im Browser. In der Shell geht es mit claude mcp login <name>. Server mit festem Schlüssel bekommen ihn als --header beim Hinzufügen.

Sind MCP-Server sicher?

So sicher wie der Server und die Rechte, die du ihm gibst. Nutze nur vertrauenswürdige Server, gib Tokens und Datenbanknutzern nur die nötigen Rechte und denk an Prompt Injection, wenn ein Server fremde Inhalte wie Webseiten oder Tickets liest.

Brauche ich für MCP ein bestimmtes Claude-Abo?

Nein. MCP gehört zu Claude Code selbst und funktioniert mit jedem Zugang, mit dem Claude Code läuft: Pro, Max, Team, Enterprise oder einem Console-Konto. Was die Abos kosten, zeigt der Kostenrechner.