Claude Code MCP Integration: Tools mit dem Agenten verbinden

Zuletzt aktualisiert: June 28, 2026

Out of the box liest und bearbeitet Claude Code Dateien und führt Shell-Befehle aus. Es kann nicht Ihre GitHub Issues lesen, Ihre Datenbank abfragen oder einen Browser steuern. Das Model Context Protocol (MCP) schließt diese Lücke: es ist der Standardstecker, der dem Agenten ermöglicht, mit externen Tools und Daten zu kommunizieren. Dieser Leitfaden zeigt die genauen claude mcp add Befehle, wann man einen lokalen gegenüber einem entfernten Server wählen sollte, wie Scopes funktionieren, welche Server sich lohnen, um eine Verbindung herzustellen, und welche Sicherheitsüberprüfungen vor dem Vertrauen in einen Server durchgeführt werden müssen.

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

Sie registrieren einen Server mit dem claude mcp add Befehl, dann kann Claude Code seine Tools während einer Sitzung aufrufen.

Für einen lokalen Server, der als Prozess auf Ihrer Maschine läuft:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Für einen entfernten Server, der über HTTPS erreicht wird:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Nach dem Hinzufügen eines Servers führen Sie /mcp in Claude Code aus, um seinen Verbindungsstatus zu sehen und eventuelle OAuth-Anmeldeverfahren abzuschließen. Verwenden Sie claude mcp list, um die Registrierung zu bestätigen. Die offizielle Befehlsreferenz befindet sich in den Claude Code MCP docs.

Was ist MCP und warum es mit Claude Code verbinden?

MCP ist ein offenes Protokoll, das ursprünglich von Anthropic veröffentlicht wurde und definiert, wie ein AI-Client und ein Tool-Server Fähigkeiten austauschen. Ein Server bewirbt Tools (Aktionen, die der Agent durchführen kann), Ressourcen (Daten, die er lesen kann) und Prompts. Jeder MCP-fähige Client kann jeden MCP-Server verwenden, sodass ein GitHub-Server in Claude Code, einer IDE oder einem anderen Agenten ohne benutzerdefinierten Kleber funktioniert. Die Spezifikation und das Serververzeichnis finden Sie unter modelcontextprotocol.io.

Der praktische Nutzen: Anstatt einen Issue-Body in den Chat einzufügen, verbinden Sie einmal den GitHub-Server und bitten den Agenten, Issues direkt zu lesen, zu labeln und darauf zu antworten. Für den tieferen Hintergrund zum Protokoll selbst sehen Sie sich unseren MCP Explainer an und für den vollständigen Tool-Kontext die Claude Code Ultimate Guide.

Ein Server kann ein winziges stdio-Skript sein, das Sie geschrieben haben, ein Docker-Image oder ein SaaS-Endpunkt, der von einem Anbieter gehostet wird. Claude Code behandelt sie alle gleich, sobald sie MCP sprechen.

Welchen Transport sollten Sie verwenden: lokal oder entfernt?

Der Transport ist wie Claude Code den Server erreicht. Lokale Server laufen auf Ihrer Maschine über stdio; entfernte Server laufen woanders und antworten über HTTP oder SSE. Die Wahl folgt normalerweise dem Speicherort der Daten.

Verwenden Sie einen lokalen stdio-Server, wenn das Tool auf Dateien oder Dienste auf Ihrem Laptop zugreifen muss, wie z. B. ein Ordner mit Projekt-Assets oder eine Postgres-Instanz auf localhost. Verwenden Sie einen entfernten HTTP- oder SSE-Server, wenn ein Anbieter ihn bereits hostet, da Sie die Installation überspringen und Updates erhalten, ohne Ihre Konfiguration zu berühren. Entfernte Server melden sich fast immer über OAuth an, was Sie im Menü /mcp auslösen.

Auswahl eines Scopes: lokal, Projekt oder Benutzer

Der Scope entscheidet wer den Server sieht und wo die Konfiguration gespeichert wird. Claude Code unterstützt drei Modi, und die Wahl des richtigen Modus hält Geheimnisse aus Ihrem Repo fern, während gleichzeitig sichere Server mit dem Team geteilt werden können.

Setzen Sie den Scope mit dem --scope-Flag, zum Beispiel claude mcp add --scope project .... Der Project-Scope schreibt ein commitetes .mcp.json, daher niemals einen Roh-Token dort speichern; verweisen Sie stattdessen auf eine Umgebungsvariable. Der Local-Scope ist der Standard und der sicherste Ort, um einen neuen Server zu testen, bevor Sie sich entscheiden, ihn zu teilen. Wenn Sie auch Claude Code Skills erstellen, halten Sie den Server-Scope und den Skill-Scope konsistent, damit ein Teamkollege, der das Repo zieht, eine funktionierende Einrichtung erhält.

Wie füge ich einen Server mit claude mcp add hinzu?

Das Muster ist für jeden Server dasselbe: ein Name, ein optionales Transport-Flag und der Befehl oder die URL. Der Trenner -- markiert den Beginn des lokalen Befehls und seiner Argumente.

Fügen Sie einen lokalen Dateisystemserver hinzu, der auf einen Ordner begrenzt ist, damit der Agent nur darauf zugreifen kann, was Sie erlauben:

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

Übergeben Sie Geheimnisse als Umgebungsvariablen und nicht hartkodiert:

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

Fügen Sie einen entfernten Server mit seinem Transport und seiner URL hinzu:

claude mcp add --transport sse linear https://mcp.linear.app/sse

Verwalten Sie dann, was Sie haben:

• claude mcp list zeigt jeden registrierten Server und seinen Status.
• claude mcp get <name> gibt die Konfiguration eines Servers aus.
• claude mcp remove <name> entregistriert ihn.
• /mcp (in einer Sitzung eingegeben) zeigt den Live-Verbindungsstatus und führt OAuth durch.

Halten Sie sich bei der Verwendung von Flags an die offiziellen Dokumentationen; Anbieter ändern gelegentlich den Paketnamen oder die URL eines Servers, daher kopieren Sie stattdessen den aktuellen Wert aus der README des Servers selbst, anstatt zu raten.

Häufige MCP-Server, die es wert sind, verbunden zu werden

Beginnen Sie mit einem Server, der einen echten Aufwand eliminiert, testen Sie ihn und fügen Sie dann mehr hinzu. Dies sind diejenigen, nach denen Entwickler zuerst greifen, und was jeder davon freischaltet.

Der Playwright MCP server ist herausragend für Frontend-Arbeiten: Der Agent öffnet Ihre Seite, klickt durch einen Flow und meldet, was gebrochen ist, zusammen mit einem Screenshot. Ein Datenbankserver ist praktisch für Leseabfragen zum Schema, aber begrenzen Sie ihn auf einen Read Replica, damit eine versehentliche Abfrage niemals schreiben kann. Wenn Sie beginnen, mehrere Server miteinander zu verketten, leiten Sie die schwere Arbeit an einen dedizierten Worker über Claude Code subagents weiter, damit die Hauptsitzung reaktionsfähig bleibt.

Szenario: Verbindung eines GitHub MCP-Servers zum Öffnen von PRs

Angenommen, Sie möchten, dass der Agent Issues vorsortiert und Pull Requests in einem Repo öffnet. GitHub hostet einen offiziellen entfernten MCP-Server, daher müssen Sie nichts lokal installieren.

1. Den gehosteten Server registrieren:

   claude mcp add --transport http github https://api.githubcopilot.com/mcp/
   

2. Geben Sie in Claude Code /mcp ein, wählen Sie github und schließen Sie das OAuth-Anmeldeverfahren in Ihrem Browser ab. Der Token bleibt bei GitHub; Sie fügen ihn niemals in eine Datei ein.

3. Bestätigen Sie die geladenen Tools mit claude mcp list.

4. Fragen Sie nun in normaler Sprache:

   • "Liste offene Issues, die mit bug markiert sind, und fasse die Top drei zusammen."
   • "Öffne einen Draft PR von fix/login-redirect zu main mit einer kurzen Beschreibung."
   • "Lies PR #214 und kennzeichne alles, was die Authentifizierung betrifft."

Der Agent liest Issue-Threads, erstellt den PR-Body und verlinkt das richtige Issue, alles ohne dass Sie das Terminal verlassen müssen. Gewähren Sie dem GitHub App zunächst Zugriff auf ein einziges Repository, überprüfen Sie, was der Agent vorschlägt, und erweitern Sie den Zugriff erst, wenn Sie dem Workflow vertrauen. Die vollständige Toolliste des Servers und die Option zur Selbst-Hosting sind in GitHub MCP server repo dokumentiert.

Ist es sicher, einen MCP-Server zu verbinden?

Ein MCP-Server kann Code auf Ihrer Maschine ausführen oder mit Ihren Konten handeln, behandeln Sie ihn daher wie die Installation einer Abhängigkeit: Verbinden Sie nur Server, denen Sie vertrauen. Das Risiko ist real, da ein bösartiger oder fehlerhafter Server Dateien exfiltrieren oder destruktive Aktionen mit Ihren Anmeldedaten durchführen könnte.

Führen Sie vor dem Hinzufügen eines Servers diese Checkliste durch:

• Bestätigen Sie die Quelle. Bevorzugen Sie offizielle Vendor-Server (GitHub, Sentry) oder die veröffentlichten Referenzserver gegenüber einem unbekannten Paket.
• Lesen Sie, welche Tools es freigibt. Ein Server zum "Lesen meiner Issues" sollte keinen Schreibzugriff auf Ihre gesamte Festplatte anfordern.
• Scope eng halten. Richten Sie Dateisystemserver auf einen Projektordner und Datenbankserver auf einen Read Replica.
• Geheimnisse aus .mcp.json halten. Verwenden Sie Umgebungsvariablen und committen Sie niemals einen echten Token.
• Least privilege bei OAuth gewähren. Geben Sie einer GitHub App ein Repo, nicht Ihre gesamte Organisation, bis Sie ihr vertrauen.
• Aktionen vor der Genehmigung überprüfen. Lesen Sie den vorgeschlagenen PR oder die Abfrage des Agenten; genehmigen Sie keine Schreibvorgänge automatisch von einem neuen Server.

Anthropic weist auf das Risiko der Prompt-Injection für Server hin, die nicht vertrauenswürdige Webinhalte abrufen, seien Sie daher bei jedem Server, der willkürliche Seiten zieht, besonders vorsichtig. Die aktuelle Sicherheitsrichtlinie finden Sie in den Claude Code MCP docs.

Fehlerbehebung bei MCP-Verbindungen

Die meisten Ausfälle sind Konfigurations- oder Authentifizierungsfehler und keine Protokollprobleme. Arbeiten Sie diese in dieser Reihenfolge durch:

• Server nicht aufgelistet: Führen Sie claude mcp list erneut aus. Wenn er fehlt, ist der add-Befehl wahrscheinlich fehlgeschlagen; überprüfen Sie auf einen Tippfehler im ---Trenner oder im Paketnamen.

• Status zeigt Fehler in /mcp: Der Prozess konnte nicht gestartet werden. Bei stdio-Servern führen Sie den rohen Befehl (zum Beispiel die npx-Zeile) in Ihrem Terminal aus, um den tatsächlichen Fehler zu sehen.

• Authentifizierung fehlgeschlagen: Öffnen Sie /mcp, wählen Sie den Server und wiederholen Sie den OAuth-Flow. Bei Token-basierten Servern bestätigen Sie, dass die Umgebungsvariable in der Shell gesetzt ist, die Claude Code gestartet hat.

• Tools erscheinen nicht: Starten Sie die Claude Code Sitzung neu, damit sie die Serverfähigkeiten neu lädt, und überprüfen Sie dann, ob der Scope von dem aktuellen Projekt sichtbar sein sollte.

• Falscher Scope: Ein mit --scope local hinzugefügter Server wird für Teamkollegen nicht angezeigt; fügen Sie ihn bei Bedarf mit --scope project erneut hinzu.

Wenn ein entfernter Server seine URL ändert oder ein Paket umbenannt wird, veraltet Ihre gespeicherte Konfiguration. Ziehen Sie den aktuellen Wert aus der README des Servers und fügen Sie ihn neu hinzu, anstatt blind zu bearbeiten.

Kernbotschaft

MCP verwandelt Claude Code von einem Datei- und Shell-Agenten in einen, der mit Ihren echten Tools spricht. Fügen Sie Server mit claude mcp add hinzu, wählen Sie stdio für lokale Daten und HTTP/SSE für gehostete Dienste und legen Sie den Scope fest, wer den Server sehen soll. Verbinden Sie zunächst einen nützlichen Server; der GitHub-Server ist ein starker Anfang, und überprüfen Sie vor dem Vertrauen in jeden Server dessen Quelle und Berechtigungen. Behalten Sie Tokens in Umgebungsvariablen, begrenzen Sie den Dateisystem- und Datenbankzugriff und überprüfen Sie die Aktionen des Agenten, bis ein neuer Server sich das Vertrauen erarbeitet hat.