SpyBara
Go Premium

mcp-quickstart.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 215 additions and 249 deletions.

2026
Thu 1 23:59 Thu 15 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57 Fri 30 23:01

Mit MCP-Servern verbinden

Fügen Sie einen MCP-Server zu Claude Code hinzu, überprüfen Sie die Verbindung und finden Sie die Konfiguration auf der Festplatte.

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.

[!NOTE]

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, gefolgt von einer File modified:-Zeile, die die Konfigurationsdatei anzeigt, die er geschrieben hat. 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:

Status Bedeutung
✔ Connected Einsatzbereit. Das sollten Sie für claude-code-docs sehen
! Connected · tools fetch failed Der Server hat sich verbunden, konnte aber seine Tools nicht auflisten. Führen Sie claude mcp get <name> aus, um die Fehlerdetails zu erhalten
! Needs authentication Der 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 connect Server hat nicht reagiert. Siehe Fehlerbehebung
✘ Connection error Der Verbindungsversuch hat einen Fehler ausgelöst. Siehe Fehlerbehebung
⏸ Pending approval (run `claude` to approve) Ein projektbezogener Server, den Sie noch nicht genehmigt haben. Siehe Bearbeiten Sie .mcp.json direkt
⊘ Disabled for this project (re-enable via /mcp) Ein Server, der für dieses Projekt durch die disabledMcpServers-Liste des Projekts deaktiviert wurde. Siehe Deaktivieren Sie einen Server, ohne ihn zu entfernen

Einige ältere Windows-Konsolen, wie die Standardkonsole unter Windows 10, unterstützen diese Unicode-Glyphen nicht und zeigen stattdessen √ und × anstelle von ✔ und ✘.

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

[!NOTE]

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 Code zum ersten Mal den Server aufruft, fragt es um Genehmigung. Genehmigen Sie es. 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

Der Befehl bestätigt mit Removed MCP server "claude-code-docs" from local config und einer File modified:-Zeile, die die aktualisierte Datei anzeigt.

[!NOTE]

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.

[!NOTE]

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 jeweils einen eigenen Abschnitt haben:

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.

Bereich Datei Verfügbar für
local ~/.claude.json, unter dem Eintrag für dieses Projekt Nur Sie, nur dieses Projekt. Der Standard
project .mcp.json im Projektstammverzeichnis Jeder, der das Projekt klont
user ~/.claude.json, unter dem Top-Level-Schlüssel mcpServers Nur 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.

Der Befehl gibt eine Bestätigung wie Added stdio MCP server playwright with command: npx -y @playwright/mcp@latest to local config aus, gefolgt von einer File modified:-Zeile, die die Konfigurationsdatei anzeigt, die er geschrieben hat.

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. Sobald der Download abgeschlossen ist, ändert sich der Status zu ✔ Connected. Wenn es nach ein paar Versuchen immer noch ✘ Failed to connect anzeigt, siehe Fehlerbehebung.

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.

/mcp shows No MCP servers configured

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/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json oder %APPDATA%\Claude\mcp.json. Für benutzerbereichsbegrenzte Server führen Sie claude mcp add --scope user aus, das in den mcpServers-Schlüssel in ~/.claude.json schreibt; für projektbereichsbegrenzte Server bearbeiten Sie .mcp.json im Projektstammverzeichnis.
  • Sie haben einen fehlerhaften Eintrag in .mcp.json geschrieben. Claude Code überspringt diesen Eintrag und lädt die anderen trotzdem. Führen Sie claude mcp list aus Ihrer Shell aus und suchen Sie nach der Parse-Warnung, die das betroffene Feld benennt.

Status shows Failed to connect or Connection error

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 das Token ablehnen, das Sie in headers.Authorization konfiguriert haben; ein Server, der ein Token benötigt, das Sie nicht konfiguriert haben, zeigt stattdessen ! Needs authentication an, was in Verbinden Sie einen Server, der eine Anmeldung erfordert behandelt wird.

Ihr erster Schritt hängt davon ab, welcher Status angezeigt wird:

  • Failed to connect: Beginnen Sie mit dem Fehlerdetail auf dem Status selbst. claude mcp list und claude mcp get <name> zeigen den HTTP-Status oder Fehlercode und jeden Fehlertext, den der Server zurückgegeben hat, was oft das Problem direkt benennt, wie z. B. einen fehlenden Header oder ein abgelehntes Token. Vor v2.1.219 zeigte Failed to connect nur den bloßen Status an, und Sie benötigten die curl- und Befehlsprüfungen später in diesem Abschnitt, um die Ursache zu finden.
  • Connection error: Claude Code fügt diesem Status auf keiner Version ein Detail hinzu, daher gehen Sie direkt zu den curl- und Befehlsprüfungen später in diesem Abschnitt.

Wenn das Detail auf eine Anmeldeinformation oder URL hinweist, überprüfen Sie auch die Warnungen in der claude mcp list-Ausgabe. Claude Code kennzeichnet Konfigurationswerte mit verstecktem führendem oder nachfolgendem Leerzeichen, eine häufige Ursache für Authentifizierungsfehler nach dem Einfügen eines Tokens.

Wenn ein HTTP-Server 404 Not Found zurückgibt, zeigt Claude Code MCP endpoint not found at <origin>. Check the URL in your MCP config. an, wenn Sie den Server in /mcp auswählen. Die Nachricht benennt den Ursprung der URL, wie z. B. https://mcp.example.com, ohne seinen Pfad, daher führen Sie claude mcp get <name> aus, um die vollständige URL zu sehen, die Sie konfiguriert haben. Vergleichen Sie seinen Pfad mit dem dokumentierten MCP-Endpunkt-Pfad des Servers, führen Sie dann claude mcp remove <name> aus und fügen Sie ihn mit der korrekten URL erneut hinzu. Vor v2.1.219 enthielt die Nachricht auch den Pfad der URL, und vor v2.1.191 zeigte ein 404 eine generische Error POSTing to endpoint-Nachricht ohne die URL an.

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. Vor v2.1.285 druckte claude mcp get keine Command-Zeile für einen stdio-Eintrag aus, der ohne ein type-Feld gespeichert wurde, wie z. B. einen von Hand geschriebenen .mcp.json-Eintrag. Führen Sie auf diesen Versionen stattdessen claude mcp list aus, das die Befehlszeile in jedem Fall druckt.

  • Der Befehl gibt einen Fehler aus: Die Nachricht nennt, was fehlt, wie z. B. Node.js oder ein Browser.

Connection timed out at startup

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

Vor v2.1.299 kam es bei einigen Verbindungen zu erreichbaren HTTP-Servern unabhängig von MCP_TIMEOUT beim Start zu einer Zeitüberschreitung. Wenn Sie eine dieser Versionen verwenden und bei einem erreichbaren HTTP-Server auch nach dem Erhöhen des Limits weiterhin eine Zeitüberschreitung auftritt, aktualisieren Sie Claude Code.

Server already exists

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.

Server connects but no tools appear

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.

Vor v2.1.302 zeigte /mcp den Status tools fetch failed für einen Server an, der die Protokollrevision 2026-07-28 verwendet und resultType, ttlMs oder cacheScope in seinen Antworten weggelassen hat. Wenn Sie eine dieser Versionen verwenden und ein Server diesen Status anzeigt, aktualisieren Sie Claude Code.

Changes to .mcp.json don't take effect

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 claude mcp list aus und suchen Sie nach einer Parse-Warnung. Claude Code überspringt fehlerhafte Einträge und zeigt das betroffene 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

OAuth sign-in fails or browser doesn't open

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: