Die MCP-Unterstützung von Claude Code verwandelt Anthropics Coding-Agenten fürs Terminal in einen Client, der auf deine echten Tools zugreifen kann (GitHub, Sentry, eine Postgres-Datenbank, eine Figma-Datei), statt mit dem zu arbeiten, was du in den Chat einfügst. Du verbindest einen Model-Context-Protocol-(MCP-)Server mit einem einzigen claude mcp add-Befehl, wählst einen Bereich und Claude kann dieses System direkt lesen und darauf handeln. Dieser Leitfaden behandelt, wie man lokale und Remote-Server hinzufügt, die drei Bereiche, wie die Authentifizierung funktioniert, was MCP dein Kontextfenster tatsächlich kostet und wie du vermeidest, dir an einem nicht vertrauenswürdigen Server die Finger zu verbrennen. Wir betreiben diese Publishing-Pipeline auf Claude Code mit DataForSEO als MCP-Server, daher sind die untenstehenden Befehle genau die, die wir täglich verwenden – abgeglichen mit Anthropics offizieller Referenz.
Was ist MCP in Claude Code, und warum sollte man es nutzen?
Das Model Context Protocol ist ein offener Standard, um KI-Tools mit externen Systemen zu verbinden. Claude Code agiert als MCP-Client: Es verbindet sich mit MCP-Servern, und jeder Server stellt eine Reihe von Tools (Aktionen, die Claude aufrufen kann) und Ressourcen (Daten, die Claude lesen kann) bereit. Der praktische Auslöser, um einen zu verbinden, ist laut Anthropics Dokumentation einfach: In dem Moment, in dem du dich dabei ertappst, Daten aus einem Issue-Tracker, einem Monitoring-Dashboard oder einer Datenbank in den Chat zu kopieren, sollte dieses System wahrscheinlich stattdessen ein MCP-Server sein. Einmal verbunden, kannst du Dinge fragen wie "Füge das in JIRA-Issue ENG-4521 beschriebene Feature hinzu und öffne einen PR auf GitHub", und Claude arbeitet in einem einzigen Zug über beide Systeme hinweg. Falls das Konzept selbst neu für dich ist, beginne mit unserem verständlichen Leitfaden zu MCP-Servern, und wenn du deinen eigenen schreiben möchtest, siehe unseren Leitfaden zum Bau eines MCP-Servers. Dieser Beitrag setzt voraus, dass du weißt, was ein Server ist, und einen in Claude Code einbinden möchtest.
Wie man einen MCP-Server zu Claude Code hinzufügt
Es gibt drei Transportarten, und welche du wählst, hängt davon ab, wo der Server läuft. Für Remote-Server (Cloud) ist HTTP die empfohlene und am breitesten unterstützte Option:
# Remote-HTTP-Server (empfohlen für Cloud-Dienste)
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Mit einem Bearer-Token in einem Header
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer YOUR_GITHUB_PAT"
Der ältere SSE-Transport (Server-Sent Events) funktioniert noch, ist aber veraltet, verwende also HTTP, wo ein Server beides anbietet: claude mcp add --transport sse asana https://mcp.asana.com/sse.
Für einen lokalen Server, der als Prozess auf deinem Rechner läuft (der stdio-Transport), wird der Befehl durch einen doppelten Bindestrich von Claudes eigenen Flags getrennt:
# Lokaler stdio-Server: alles nach -- führt den Server aus
claude mcp add --transport stdio my-server -- npx -y some-mcp-server
Alles nach -- wird unverändert an den Server übergeben, daher gehören --env, --transport und --scope davor. Ein Fallstrick, den man kennen sollte: claude mcp add speichert die Konfiguration, ohne die Zugangsdaten zu validieren, sodass ein falscher Token beim Hinzufügen akzeptiert wird und erst als failed-Server auftaucht, wenn du /mcp ausführst. Lieber JSON? claude mcp add-json <name> '{...}' nimmt ein rohes Konfigurationsobjekt entgegen, und ein Eintrag mit einer url, aber ohne type-Feld wird als stdio-Server behandelt und übersprungen – setze also für Remote-Einträge immer "type": "http".
Die drei MCP-Bereiche: local, project und user
Der Bereich entscheidet, in welchen Projekten ein Server geladen wird und ob dein Team ihn ebenfalls bekommt. Das ist der Teil, den die Leute am häufigsten falsch machen.
| Bereich | Verfügbar in | Mit dem Team geteilt? | Gespeichert in |
|---|---|---|---|
| Local (Standard) | Nur aktuelles Projekt | Nein | ~/.claude.json |
| Project | Nur aktuelles Projekt | Ja, über Versionskontrolle | .mcp.json im Projektstammverzeichnis |
| User | Alle deine Projekte | Nein | ~/.claude.json |
Local ist der Standardbereich und bleibt privat für dich. Verwende --scope project, um den Server in eine .mcp.json-Datei im Repo-Stammverzeichnis zu schreiben, die du in Git committest, damit jeder Teamkollege dieselben Tools bekommt:
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
Verwende --scope user für persönliche Hilfsprogramme, die du überall haben möchtest. Wenn derselbe Servername an mehr als einer Stelle definiert ist, gewinnt local vor project, das wiederum vor user gewinnt, und der gesamte Eintrag aus der Quelle mit der höchsten Priorität wird verwendet – ohne dass Felder zusammengeführt werden. Ein großer Komfort für Teams: .mcp.json unterstützt die Expansion von Umgebungsvariablen, sodass du "Authorization": "Bearer ${API_KEY}" committen und jeden Rechner sein eigenes Geheimnis liefern lassen kannst, mit ${VAR:-default} für Fallbacks.
Server verwalten, inspizieren und importieren
Sobald Server existieren, decken eine Handvoll Befehle die tägliche Arbeit ab:
claude mcp list– zeigt jeden konfigurierten Server und seinen Statusclaude mcp get <name>– inspiziert die vollständige Konfiguration eines Serversclaude mcp remove <name>– löscht ihn/mcp– innerhalb einer Sitzung Verbindungen und Tool-Anzahl ansehen und die OAuth-Anmeldung durchführenclaude mcp add-from-claude-desktop– importiere Server, die du bereits in der Claude-Desktop-App eingerichtet hast
Projektbezogene Server aus .mcp.json verbinden sich nicht automatisch. Aus Sicherheitsgründen hält Claude Code sie bei ⏸ Pending approval, bis du das Projekt interaktiv öffnest und den Workspace-Vertrauensdialog akzeptierst, sodass ein geklontes Repo seine eigenen Server nicht stillschweigend genehmigen kann. Falls du diese Entscheidungen jemals neu treffen musst, setzt claude mcp reset-project-choices sie zurück.
Authentifizierung: OAuth ohne Jonglieren mit API-Schlüsseln
Die meisten Cloud-MCP-Server benötigen eine Authentifizierung, und Claude Code beherrscht OAuth 2.0. Wenn ein Server einen 401 oder 403 zurückgibt, wird er im /mcp-Panel markiert; wähle ihn aus, schließe die Browser-Anmeldung einmal ab, und Claude Code speichert und aktualisiert den Token für dich. "Keine API-Schlüssel zu verwalten und keine Zugangsdaten zu speichern", wie Anthropic es formulierte, als das Unternehmen im Juni 2025 die Remote-MCP-Unterstützung auslieferte. Ab Version 2.1.186 kannst du dich auch direkt aus deiner Shell mit claude mcp login <name> authentifizieren, statt eine Sitzung zu öffnen. Server, die sich über einen statischen Token authentifizieren (wie der von GitHub oben), überspringen OAuth vollständig und lesen den Header, den du übergeben hast.
Was MCP-Server dein Kontextfenster tatsächlich kosten
Hier ist die Frage, die die Ranking-Seiten auslassen: Bläht das Laden eines Stapels von MCP-Servern Claudes Kontext auf und verlangsamt es? Früher war das so. Jetzt wird Claude Code mit standardmäßig aktivierter Tool-Suche ausgeliefert, die die Tool-Definitionen jedes Servers zurückstellt, bis Claude sie tatsächlich braucht, sodass beim Sitzungsstart nur Tool-Namen und kurze Server-Anweisungen geladen werden. Laut Anthropics Dokumentation bedeutet das, dass das Hinzufügen weiterer Server nur minimale Auswirkungen auf dein Kontextfenster hat, und es gibt keine feste Obergrenze für Tools pro Server; dein echtes Limit ist dein Kontextbudget. Der andere Hebel ist die Ausgabe: Claude Code warnt, wenn eine einzelne MCP-Tool-Antwort 10,000 Tokens überschreitet, und begrenzt sie standardmäßig auf 25,000. Wenn eine berechtigterweise große Abfrage immer wieder abgeschnitten wird, erhöhe das Limit mit MAX_MCP_OUTPUT_TOKENS=50000, aber behandle einen chronisch lauten Server als Warnsignal, denn ein Tool, das 40,000 Tokens pro Aufruf ausspuckt, ist meist das falsche Tool.
Sind MCP-Server sicher? Vertrauen und Prompt Injection
Ein MCP-Server führt Code aus und tut dies im stdio-Fall auf deinem Rechner mit deiner Umgebung. Anthropics eigene Empfehlung ist unmissverständlich: Vergewissere dich, dass du jedem Server vertraust, bevor du ihn verbindest, denn jeder Server, der externe Inhalte abruft, kann dich Prompt Injection aussetzen, bei der ein bösartiges Issue, eine Webseite oder eine Datenbankzeile den Agenten heimlich anweist, Daten zu exfiltrieren oder einen zerstörerischen Befehl auszuführen. Drei Gewohnheiten halten das im Zaum. Erstens: Bevorzuge offizielle Erstanbieter-Server (den eigenen Endpunkt des Anbieters) und geprüfte Einträge im Anthropic Directory gegenüber beliebigen GitHub-Repos. Zweitens: Halte Geheimnisse aus committeten .mcp.json-Dateien heraus, indem du ${ENV_VAR}-Expansion nutzt, niemals fest codierte Tokens. Drittens: Behandle die Projektgenehmigungsaufforderung als echte Hürde, nicht als Ärgernis, denn sie existiert genau dafür, dass die kompromittierte .mcp.json eines Teamkollegen nicht automatisch gegen deine Zugangsdaten ausgeführt werden kann.
Wann du keinen MCP-Server hinzufügen solltest
MCP ist nicht kostenlos. Jeder Server ist ein weiteres bewegliches Teil, ein weiteres Zugangsdatum, eine weitere Vertrauensentscheidung. Wenn die eingebauten Datei-, Bash- und Web-Tools von Claude Code die Aufgabe bereits erledigen, ist das Hinzufügen eines Servers, nur um git auszuführen oder eine Datei zu lesen, überflüssiger Aufwand. Greife zu MCP, wenn ein System wirklich extern und zustandsbehaftet ist (dein Issue-Tracker, dein Fehler-Monitor, deine Produktionsdatenbank, deine Designdateien), und lass es sein, wenn ein einzeiliger Shell-Befehl oder ein vorhandenes Tool die Frage bereits beantwortet.
Häufig gestellte Fragen
Wo befindet sich die Konfigurationsdatei für Claude Code MCP?
Das hängt vom Bereich ab. Projektbezogene Server befinden sich in einer .mcp.json-Datei im Stammverzeichnis deines Repositorys (dafür gedacht, in Git committet zu werden). Server mit local- und user-Bereich werden in ~/.claude.json in deinem Home-Verzeichnis gespeichert. Beachte, dass der MCP-"local scope" getrennt von Claude Codes allgemeiner Einstellungsdatei .claude/settings.local.json ist.
Wie liste ich die MCP-Server in Claude Code auf?
Führe claude mcp list in deinem Terminal aus, um jeden konfigurierten Server und seinen Verbindungsstatus zu sehen, oder claude mcp get <name> für die vollständigen Details eines Servers. Tippe innerhalb einer Sitzung /mcp, um Verbindungen, die Tool-Anzahl pro Server und alle Server zu sehen, die auf eine OAuth-Anmeldung warten.
Ist MCP in Claude Code kostenlos?
Die MCP-Funktion selbst ist ohne Aufpreis in Claude Code integriert, und viele Server (Filesystem, GitHub, Postgres) sind kostenlose Open-Source-Projekte. Du zahlst weiterhin für das, womit der Server sich verbindet (eine kostenpflichtige API dahinter oder ein SaaS-Abonnement), und MCP-Tool-Aufrufe verbrauchen Tokens wie jeder andere Kontext.
Verlangsamen MCP-Server Claude Code?
Nicht so wie früher. Die Tool-Suche ist standardmäßig aktiviert und stellt die Tool-Definitionen zurück, bis sie benötigt werden, sodass das Hinzufügen von Servern kaum Auswirkungen auf dein Kontextfenster hat. Die größere Bremse ist ein einzelner Server, der riesige Ausgaben zurückgibt; achte auf die 10,000-Token-Warnung und entferne laute Tools.
Was ist der Unterschied zwischen einem lokalen und einem Remote-MCP-Server?
Ein lokaler (stdio-)Server läuft als Prozess auf deinem eigenen Rechner und wird mit einem Befehl nach -- hinzugefügt; ein Remote-Server läuft in der Cloud und wird über HTTP (oder das veraltete SSE) mit einer URL hinzugefügt. Remote-Server unterstützen OAuth und sind wartungsärmer, da der Anbieter Updates und Skalierung übernimmt, während lokale Server dir volle Kontrolle geben und die Daten auf deinem Rechner behalten.
Sources
- Claude Code – Claude Code über MCP mit Tools verbinden (Anthropic-Dokumentation) – genaue
claude mcp add-Syntax, Transportarten, die drei Bereiche,.mcp.json-Format, Tool-Suche und Ausgabelimits - Anthropic – Remote-MCP-Unterstützung in Claude Code – OAuth für Remote-Server, Tools vs. Ressourcen, Launch im Juni 2025
- Model Context Protocol – Einführung – der offene Standard hinter MCP-Clients und -Servern
- Anthropic Directory – geprüfte Konnektoren, die du mit
claude mcp addhinzufügen kannst
Waqas Ahmed Waseer
Waqas Ahmed Waseer ist Entwickler und Automation-Builder mit über 8 Jahren Erfahrung im Aufbau von Produktivsystemen, die von mehr als 100.000 Menschen genutzt werden. Er baut individuelle Multi-Tenant-SaaS, KI-Automatisierung (n8n, LLM-Workflows, WhatsApp-Bots) und Hosting-Infrastruktur (WHM/cPanel, CloudLinux) — und ist der Macher von WaSphere, FlowMaticX und der Hosting-Marke WaseerHost. Über 100 Projekte für KMU, Agenturen und finanzierte Start-ups umgesetzt.
