Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Das Model Context Protocol (MCP) ermöglicht Claude Code die Verwendung von Tools über seinen integrierten Satz hinaus, wie z. B. die Suche in einem Issue-Tracker, das Abfragen einer Datenbank oder die Steuerung eines Webbrowsers. Diese Tools stammen von MCP-Servern, die auf Ihrem Computer oder als gehostete Dienste ausgeführt werden. Diese Anleitung führt Sie durch die End-to-End-Verbindung eines MCP-Servers mit der Claude Code CLI. Am Ende haben Sie einen verbundenen und reagierenden Server, wissen, wo seine Konfiguration auf der Festplatte gespeichert ist, und wissen, wie Sie die häufigsten Verbindungsfehler beheben.
Sie können MCP-Server auch von anderen Oberflächen aus hinzufügen, einschließlich der Desktop-App, VS Code und dem Web. Siehe Von anderen Oberflächen verbinden.
Für alle Möglichkeiten zum Verbinden und Konfigurieren von MCP-Servern in Claude Code siehe die MCP-Referenz.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie haben:
  • Claude Code installiert und authentifiziert
  • Ein Terminal in einem Projektverzeichnis geöffnet. Jedes Verzeichnis funktioniert, auch ein leeres.

Einen Server hinzufügen und überprüfen

Das folgende Beispiel verbindet sich mit dem Claude Code-Dokumentations-MCP-Server, einem gehosteten Server mit Volltextsuche über die Claude Code-Dokumentation. Er erfordert keine Authentifizierung oder spezielle Konfiguration, daher funktioniert er gut als erster Server zum Testen des Setup-Ablaufs. Die Schritte sind für jeden Server gleich: fügen Sie ihn hinzu, überprüfen Sie den Verbindungsstatus, verwenden Sie ihn dann in einer Sitzung, mit einem optionalen Bereinigungsschritt am Ende. Einige Server fügen einen Schritt hinzu, wie z. B. eine Browser-Anmeldung, die in Zusätzliche MCP-Server-Beispiele gezeigt wird. Weitere Server zum Verbinden finden Sie im Anthropic-Verzeichnis.
1

Fügen Sie den MCP-Server hinzu

Registrieren Sie den Server bei Claude Code. Führen Sie dies in Ihrem Terminal aus, nicht in einer claude-Sitzung: Sie konfigurieren den Server vor dem Starten einer Konversation.
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
Die Teile des Befehls:
  • claude mcp add: registriert einen Server bei Claude Code.
  • --transport http: Der Server wird unter einer URL gehostet, anstatt als lokaler Prozess ausgeführt zu werden.
  • claude-code-docs: ein Name, den Sie sich ausdenken. Das Aufrufen desselben Servers als docs würde identisch funktionieren. Claude Code verwendet den Namen, den Sie wählen, um die Tools des Servers in Claudes Ausgabe zu kennzeichnen und um auf den Server in Befehlen wie claude mcp remove zu verweisen.
  • https://code.claude.com/docs/mcp: die URL, unter der der Server gehostet wird.
Der Befehl gibt eine Bestätigung wie Added HTTP MCP server claude-code-docs with URL: https://code.claude.com/docs/mcp to local config aus. Der Teil local config bedeutet, dass der Server bei Ihnen in diesem Projekt registriert ist: Wenn Sie Claude Code in einem anderen Projekt starten, ist dieser Server dort nicht aktiv. Um einen Server einmal für alle Ihre Projekte zu registrieren, fügen Sie ihn im Benutzerbereich hinzu, was in Server-Bereich ändern behandelt wird.
2

Überprüfen Sie den Verbindungsstatus

Bestätigen Sie, dass der Server in Ihrer Serverliste angezeigt wird, und überprüfen Sie seinen Status:
claude mcp list
Der Server wird mit einem Statusindikator angezeigt:
StatusBedeutung
✓ ConnectedEinsatzbereit. Das sollten Sie für claude-code-docs sehen
! Needs authenticationDer Server ist erreichbar, benötigt aber eine Browser-Anmeldung oder ein Token, das mit --header übergeben wird. Siehe Verbinden Sie einen Server, der eine Anmeldung erfordert
✗ Failed to connectServer hat nicht reagiert. Siehe Fehlerbehebung
✗ Connection errorDer Verbindungsversuch hat einen Fehler ausgelöst. Siehe Fehlerbehebung
⏸ Pending approvalEin projektbezogener Server, den Sie noch nicht genehmigt haben. Siehe Bearbeiten Sie .mcp.json direkt
3

Verwenden Sie den Server

Starten Sie eine Sitzung und bitten Sie Claude, den neuen Server nach Name zu verwenden:
claude
Use the claude-code-docs server to look up what MCP_TIMEOUT does
Sie müssen normalerweise keinen Server in Ihrer Eingabeaufforderung benennen, da Claude relevante Tools automatisch auswählt. Das Benennen hier garantiert, dass die Demonstration über den neuen Server läuft, anstatt über ein anderes Tool wie Web-Abruf, das die gleiche Frage beantworten könnte.
Wenn Claude den Server zum ersten Mal aufruft, fragt es um Erlaubnis, das neue Tool zu verwenden. Genehmigen Sie es, um fortzufahren. Der Tool-Aufruf in Claudes Ausgabe ist mit dem Servernamen gekennzeichnet, anhand dessen Sie bestätigen, dass die Antwort vom MCP-Server und nicht von Claudes integriertem Wissen stammt.
4

Entfernen Sie den Server

Dieser Schritt ist optional. Wenn Sie mit dem Experimentieren fertig sind, können Sie den Server entfernen:
claude mcp remove claude-code-docs
Jeder verbundene Server nimmt Platz in Claudes Kontextfenster ein, da seine Tool-Namen und Server-Anweisungen in jede Sitzung geladen werden. Das Entfernen von Servern, die Sie nicht mehr verwenden, hält diesen Platz frei.

Wo Server gespeichert werden

Der Befehl claude mcp add schreibt die Details des Servers in eine Konfigurationsdatei. Standardmäßig registriert er den Server im local-Bereich: privat für Sie, aktiv nur im aktuellen Projekt. Übergeben Sie --scope user, um ihn einmal für alle Ihre Projekte zu registrieren, oder --scope project, um ihn mit Ihrem Team zu teilen. Server-Bereich ändern führt Sie durch beide.
claude mcp add funktioniert in jeder Shell gleich, einschließlich PowerShell und Command Prompt. Verwenden Sie in einer claude-Sitzung den Befehl /mcp, um bereits hinzugefügte Server zu überprüfen und zu verwalten.
Es gibt andere Möglichkeiten, einen Server hinzuzufügen, die später auf dieser Seite behandelt werden:

Finden Sie Ihre Konfiguration auf der Festplatte

Der Befehl claude mcp add schreibt den Server in einen von drei Bereichen, die über zwei Dateien verteilt sind, je nach dem Flag --scope. Sie müssen diese Dateien nicht direkt bearbeiten, aber zu wissen, wo sie sich befinden, hilft beim Debuggen und bei der Versionskontrolle.
BereichDateiVerfügbar für
local~/.claude.json, unter dem Eintrag für dieses ProjektNur Sie, nur dieses Projekt. Der Standard
project.mcp.json im ProjektstammverzeichnisJeder, der das Projekt klont
user~/.claude.json, unter dem Top-Level-Schlüssel mcpServersNur Sie, alle Projekte
Unter Windows wird ~/.claude.json zu %USERPROFILE%\.claude.json, typischerweise C:\Users\YourName\.claude.json. Wenn Sie CLAUDE_CONFIG_DIR gesetzt haben, liest Claude Code .claude.json stattdessen aus diesem Verzeichnis. Führen Sie claude mcp get claude-code-docs aus, um zu sehen, welcher Bereich die Definition eines Servers enthält. Wie die Bereiche interagieren, wenn derselbe Server in mehr als einem definiert ist, siehe MCP-Installationsbereiche.

Server-Bereich ändern

Der Bereich eines Servers ist beim Hinzufügen festgelegt, daher bedeutet das Ändern des Bereichs, den Eintrag zu entfernen und ihn im neuen Bereich erneut hinzuzufügen. Beide Fälle unten beginnen damit, den lokalen Eintrag aus der ersten Anleitung zu entfernen, damit der Server nur eine Definition hat. Wenn Sie ihn bereits am Ende dieser Anleitung entfernt haben, überspringen Sie diesen Befehl:
claude mcp remove claude-code-docs --scope local

Verwenden Sie einen Server in allen Ihren Projekten

Fügen Sie den Server im user-Bereich erneut hinzu, um ihn in jedem Projekt aktiv zu machen, das Sie öffnen, immer noch privat für Sie:
claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp

Teilen Sie einen Server mit Ihrem Team

Fügen Sie den Server im project-Bereich erneut hinzu, der in .mcp.json im Projektstammverzeichnis schreibt:
claude mcp add --scope project --transport http claude-code-docs https://code.claude.com/docs/mcp
Committen Sie .mcp.json zur Versionskontrolle. Teamkollegen, die das Repository klonen und Claude Code starten, sehen eine Aufforderung zur Genehmigung des Servers, dann verbindet er sich auch für sie.

Zusätzliche MCP-Server-Beispiele

Die erste Anleitung verwendete einen gehosteten Server, der sich ohne Anmeldung verbindet. Die folgenden Beispiele behandeln die anderen zwei häufigen Formen mit dem gleichen Hinzufügen-, Überprüfen-, Verwenden-Ablauf.

Fügen Sie einen lokalen Server hinzu

Ein lokaler stdio-Server ist ein Programm, das Claude Code als Unterprozess auf Ihrem Computer startet, anstatt es über eine URL zu erreichen. Verwenden Sie einen für Tools, die Zugriff auf lokale Ressourcen wie einen Browser, Ihr Dateisystem oder einen Datenbanksocket benötigen. Der Playwright MCP-Server ist ein guter zum Ausprobieren: Er gibt Claude einen Browser, den er navigieren, klicken und lesen kann, und benötigt kein Konto. Er läuft über npx, daher benötigt er Node.js 18 oder später.
1

Fügen Sie den Playwright-Server hinzu

Registrieren Sie den Server mit dem Befehl, den Claude Code ausführen soll, um ihn zu starten:
claude mcp add playwright -- npx -y @playwright/mcp@latest
Dieser Befehl unterscheidet sich vom gehosteten Beispiel auf drei Arten:
  • Es gibt kein --transport-Flag, da lokale Server das Standard-stdio-Transport verwenden.
  • Alles nach dem ---Trennzeichen ist der Befehl, den Claude Code ausführt, um den Server zu starten.
  • -y teilt npx mit, das Paket ohne Aufforderung zu installieren.
Playwright steuert, welcher Chrome bereits auf Ihrem Computer installiert ist. Um einen anderen Browser zu verwenden, fügen Sie --browser mit dem Browser-Namen an, z. B. --browser firefox, nach @playwright/mcp@latest.
2

Überprüfen Sie die Verbindung

Die Added-Bestätigung bedeutet, dass der Eintrag gespeichert wurde, nicht dass der Befehl ausgeführt wird. Überprüfen Sie die Verbindung:
claude mcp list
Die erste Überprüfung kann ✗ Failed to connect anzeigen, während npx das Paket herunterlädt, daher warten Sie einen Moment und führen Sie es erneut aus.
3

Verwenden Sie den Browser

Geben Sie Claude eine Aufgabe, die den Browser benötigt:
Use playwright to open https://example.com and tell me the page title
Ein Browserfenster öffnet sich, damit Sie sehen können, wie es funktioniert, und die Tool-Aufrufe in Claudes Ausgabe sind mit dem playwright-Servernamen und der Aktion gekennzeichnet, wie z. B. browser_navigate.Versuchen Sie, es auf Ihren lokalen Dev-Server zu verweisen, um zu überprüfen, dass eine Seite nach einer Änderung immer noch gerendert wird, oder lassen Sie es einen Fehlerbericht Schritt für Schritt durchgehen.

Verbinden Sie einen Server, der eine Anmeldung erfordert

Gehostete Dienste wie Sentry, Linear und Notion führen ihre MCP-Server hinter OAuth aus: Sie fügen die URL des Servers hinzu, dann melden Sie sich über Ihren Browser an. Die folgenden Schritte verwenden Sentry als Beispiel. Um einen anderen Dienst zu verbinden, ersetzen Sie seine URL, die Sie im Anthropic-Verzeichnis oder in der Dokumentation des Dienstes finden können.
1

Fügen Sie den Server hinzu

Der add-Befehl ist derselbe wie für den Dokumentationsserver, mit Sentrys URL:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Nach dem Hinzufügen zeigt claude mcp list den Server mit ! Needs authentication an. Das ist erwartet: Der nächste Schritt schließt die Anmeldung ab.
2

Authentifizieren Sie sich in Ihrem Browser

Starten Sie eine Claude Code-Sitzung und öffnen Sie das MCP-Panel:
/mcp
Wählen Sie sentry aus der Liste, drücken Sie Enter, und wählen Sie Authenticate. Ihr Browser öffnet sich auf Sentrys Anmeldeseite. Genehmigen Sie die Verbindung dort.Zurück in Claude Code ändert sich der Status des Servers zu verbunden. Wenn die Anmeldung fehlschlägt oder der Browser nicht öffnet, siehe Fehlerbehebung.
3

Verwenden Sie den Server

Fragen Sie Claude etwas, das den Dienst benötigt, wie z. B. What Sentry projects do I have access to?, und suchen Sie nach Tool-Aufrufen, die mit dem sentry-Servernamen in seiner Ausgabe gekennzeichnet sind.
Server, die sich mit einem statischen Token anstelle von OAuth authentifizieren, nehmen das Token zum Hinzufügungszeitpunkt mit --header "Authorization: Bearer <token>" an. Siehe das GitHub-Beispiel für eine durchgearbeitete Version.

Bearbeiten Sie .mcp.json direkt

Jede Datei in der Bereichstabelle verwendet das gleiche JSON-Format für Server-Einträge. Dieser Abschnitt bearbeitet .mcp.json, die projektbezogene Datei. Es ist die, die sich am meisten lohnt, von Hand zu schreiben, da sie im Repository eingecheckt wird, wo sie auch als Konfiguration-als-Code für Ihr Team dient. Erstellen Sie .mcp.json im Projektstammverzeichnis. Das folgende Beispiel definiert beide Server aus dieser Anleitung, den gehosteten Dokumentationsserver, der über HTTP erreichbar ist, und den Playwright-Server als lokalen stdio-Prozess:
{
  "mcpServers": {
    "claude-code-docs": {
      "type": "http",
      "url": "https://code.claude.com/docs/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}
Die Felder unterscheiden sich je nach Servertyp:
  • Für HTTP-Server ist url der Endpunkt, mit dem sich Claude Code verbindet.
  • Für stdio-Server sind command und args das Programm, das es ausführt.
Nach dem Speichern der Datei starten Sie eine neue Claude Code-Sitzung im Projekt. Claude Code liest .mcp.json beim Start. Wenn Claude Code zum ersten Mal einen projektbezogenen Server sieht, fragt es Sie, ihn zu genehmigen. Die Aufforderung existiert, damit ein Repository, das Sie klonen, keine Prozesse auf Ihrem Computer ohne Ihre Zustimmung starten kann. Genehmigen Sie die Aufforderung, oder führen Sie /mcp aus, um später zu genehmigen, wenn Sie sie verpasst haben. Nachdem Sie genehmigt haben, führen Sie /mcp aus und überprüfen Sie, dass die Server als verbunden angezeigt werden. Wenn einer stattdessen einen Fehler anzeigt, siehe Fehlerbehebung.

Von anderen Oberflächen verbinden

Diese Anleitung verwendet die claude mcp CLI-Befehle, aber jede Claude Code-Oberfläche kann sich mit MCP-Servern verbinden:

Fehlerbehebung

Wenn sich ein Server nicht verbindet, überprüfen Sie seinen Status mit /mcp in einer Sitzung oder claude mcp list aus Ihrer Shell, dann gleichen Sie das Symptom unten ab. Das /mcp-Panel ermöglicht es Ihnen auch, sich erneut zu verbinden oder zu authentifizieren, ohne die Sitzung zu verlassen.
Claude Code hat keine Server für das aktuelle Verzeichnis gefunden. Die häufigsten Ursachen:
  • Sie haben claude mcp add aus einem anderen Projekt ausgeführt. Lokal begrenzte Server sind an das Projekt gebunden, in dem Sie sie hinzugefügt haben: das Repository-Stammverzeichnis oder das genaue Verzeichnis, wenn Sie sich nicht in einem Git-Repository befanden. Fügen Sie den Server aus dem Projekt erneut hinzu, in dem Sie sich jetzt befinden, oder fügen Sie ihn mit --scope user hinzu, damit er nicht an ein Projekt gebunden ist.
  • Sie haben eine Konfigurationsdatei unter dem falschen Pfad bearbeitet. Die richtigen Dateien sind ~/.claude.json und <project>/.mcp.json. Claude Code liest keine Pfade wie ~/.claude/config/mcp.json, ~/.claude/mcp.json oder %APPDATA%\Claude\mcp.json.
Beide Status bedeuten, dass der Server nicht gestartet wurde oder die URL nicht reagiert hat. Sie können auch für HTTP-Server angezeigt werden, die ein Token erwarten, anstatt der Browser-Anmeldung, die in Verbinden Sie einen Server, der eine Anmeldung erfordert behandelt wird.Für HTTP-Server bestätigen Sie, dass die URL von Ihrem Computer aus erreichbar ist:
curl -I https://mcp.sentry.dev/mcp
In PowerShell verwenden Sie curl.exe anstelle von curl, damit die Anfrage zum echten curl-Binary geht, anstatt zum Invoke-WebRequest-Alias.Die Antwort sagt Ihnen, welche Art von Problem Sie haben:
  • Ein 404 oder 405: Der Server ist aktiv. Viele MCP-Endpunkte antworten nur auf POST-Anfragen, daher bestätigt dies immer noch, dass die URL von Ihrem Computer aus erreichbar ist.
  • Ein 401 oder 403: Der Server ist aktiv und Sie müssen sich authentifizieren. Verwenden Sie die Browser-Anmeldung in Verbinden Sie einen Server, der eine Anmeldung erfordert, oder für Server, die stattdessen ein Token annehmen, wie GitHubs, übergeben Sie es mit --header "Authorization: Bearer <token>" im claude mcp add-Befehl.
  • Keine Antwort: Überprüfen Sie die URL und Ihr Netzwerk.
Für stdio-Server führen Sie den konfigurierten Befehl direkt in Ihrem Terminal aus, um den zugrunde liegenden Fehler zu sehen. Für den Playwright-Server aus dieser Anleitung führen Sie aus:
npx -y @playwright/mcp@latest
Was danach passiert, sagt Ihnen, wo das Problem liegt:
  • Der Befehl startet und wartet auf Eingabe: Der Server selbst funktioniert. Führen Sie claude mcp get <name> aus und bestätigen Sie, dass der dort angezeigte Befehl dem entspricht, den Sie gerade ausgeführt haben. Wenn sich der angezeigte Befehl von dem unterscheidet, den Sie eingegeben haben, haben Sie wahrscheinlich das ---Trennzeichen vor dem Server-Befehl weggelassen. Entfernen Sie den Server und fügen Sie ihn mit -- an der richtigen Stelle erneut hinzu. Wenn Sie .mcp.json von Hand geschrieben haben, überprüfen Sie seine Syntax und seinen Speicherort.
  • Der Befehl gibt einen Fehler aus: Die Nachricht nennt, was fehlt, wie z. B. Node.js oder ein Browser.
Der Server hat länger als das Standard-30-Sekunden-Startup-Timeout gedauert. Der erste Lauf eines stdio-Servers kann langsam sein, während npx das Paket herunterlädt. Erhöhen Sie das Limit mit der Umgebungsvariablen MCP_TIMEOUT, in Millisekunden:
MCP_TIMEOUT=60000 claude
In PowerShell setzen Sie die Variable vor dem Befehl auf der gleichen Zeile:
$env:MCP_TIMEOUT = "60000"; claude
Sie haben bereits einen Server mit diesem Namen im gleichen Bereich hinzugefügt. Entfernen Sie entweder den vorhandenen Eintrag zuerst oder wählen Sie einen anderen Namen:
claude mcp remove claude-code-docs
Wenn der Name in mehr als einem Bereich existiert, meldet remove exists in multiple scopes. Übergeben Sie --scope, um zu wählen, welche Kopie gelöscht werden soll, z. B. claude mcp remove claude-code-docs --scope local.
Führen Sie /mcp in einer Sitzung aus und wählen Sie den Server, um seine Tool-Liste zu sehen. Wenn die Liste leer ist, ist der Server gestartet, hat aber keine Tools registriert, was normalerweise bedeutet, dass ihm eine erforderliche Umgebungsvariable wie ein API-Schlüssel fehlt.Übergeben Sie die Variable mit --env KEY=value im claude mcp add-Befehl, oder im env-Feld des Server-Eintrags in .mcp.json. Die Dokumentation des Servers listet die Variablen auf, die er benötigt.
Claude Code liest .mcp.json beim Sitzungsstart. Beenden Sie die Sitzung und starten Sie sie nach dem Bearbeiten der Datei neu.Wenn Ihre Server immer noch nicht angezeigt werden, führen Sie /mcp aus und suchen Sie nach einer Parse-Warnung. Claude Code überspringt fehlerhafte Einträge und zeigt das beleidigende Feld dort an.Wenn Sie den Server zuvor abgelehnt haben, wenn Sie dazu aufgefordert wurden, setzen Sie Projektgenehmigungen zurück:
claude mcp reset-project-choices
Führen Sie /mcp aus, wählen Sie den Server, und wählen Sie Authenticate erneut. Wenn der Browser nicht automatisch öffnet, kopieren Sie die im Terminal angezeigte URL und öffnen Sie sie manuell. Siehe Authentifizieren Sie sich mit Remote-MCP-Servern für feste Callback-Ports und vorkonfigurierte Anmeldedaten.

Nächste Schritte

Mit einem verbundenen Server erkunden Sie den Rest dessen, was MCP ermöglicht: