Claude Code mit Tools über MCP verbinden

​

Was Sie mit MCP tun können

• Funktionen aus Issue-Trackern implementieren: „Füge die in JIRA-Issue ENG-4521 beschriebene Funktion hinzu und erstelle einen PR auf GitHub.“
• Überwachungsdaten analysieren: „Überprüfe Sentry und Statsig, um die Nutzung der in ENG-4521 beschriebenen Funktion zu überprüfen.“
• Datenbanken abfragen: „Finde E-Mail-Adressen von 10 zufälligen Benutzern, die die Funktion ENG-4521 verwendet haben, basierend auf unserer PostgreSQL-Datenbank.“
• Designs integrieren: „Aktualisiere unsere Standard-E-Mail-Vorlage basierend auf den neuen Figma-Designs, die in Slack gepostet wurden“
• Workflows automatisieren: „Erstelle Gmail-Entwürfe, die diese 10 Benutzer zu einer Feedback-Sitzung zur neuen Funktion einladen.“
• Auf externe Ereignisse reagieren: Ein MCP-Server kann auch als Kanal fungieren, der Nachrichten in Ihre Sitzung pusht, sodass Claude auf Telegram-Nachrichten, Discord-Chats oder Webhook-Ereignisse reagiert, während Sie weg sind.

​

MCP-Server finden und erstellen

/plugin install mcp-server-dev@claude-plugins-official

/mcp-server-dev:build-mcp-server

​

MCP-Server installieren

​

Option 1: Einen Remote-HTTP-Server hinzufügen

# Grundlegende Syntax
claude mcp add --transport http <name> <url>

# Echtes Beispiel: Mit Notion verbinden
claude mcp add --transport http notion https://mcp.notion.com/mcp

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

​

Option 2: Einen Remote-SSE-Server hinzufügen

# Grundlegende Syntax
claude mcp add --transport sse <name> <url>

# Echtes Beispiel: Mit Asana verbinden
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Beispiel mit Authentifizierungsheader
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

​

Option 3: Einen lokalen Stdio-Server hinzufügen

# Grundlegende Syntax
claude mcp add [options] <name> -- <command> [args...]

# Echtes Beispiel: Airtable-Server hinzufügen
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

​

Wie Claude Code einen Stdio-Server stoppt

• Unter macOS und Linux: Claude Code sendet SIGINT, dann SIGTERM, wenn der Prozess 100 Millisekunden später noch läuft, und nach weiteren 400 Millisekunden SIGKILL.
• Unter Windows: Claude Code schließt stdin des Servers und beendet dann den Prozessbaum des Servers, wenn der Prozess 300 Millisekunden später noch läuft.

​

Option 4: Einen Remote-WebSocket-Server hinzufügen

claude mcp add-json events-server \
  '{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

​

Einen Server aus Setupanweisungen hinzufügen, die für einen anderen Client geschrieben wurden

• Eine URL wie https://mcp.example.com/mcp: Der Server ist Remote.
• Ein Startbefehl wie npx -y @example/mcp-server: Der Server wird auf Ihrem Computer ausgeführt.
• Ein mcpServers-JSON-Block: Konfiguration, die für die Einstellungsdatei eines anderen Clients geschrieben wurde.

​

Einen Server aus einer URL hinzufügen

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

​

Einen Server aus einem npx-, uvx- oder Binärbefehl hinzufügen

claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

​

Einen Server aus einem mcpServers-JSON-Block hinzufügen

• Eine url ohne type: Fügen Sie "type": "http", "type": "sse" oder "type": "ws" hinzu, um dem Endpunkt zu entsprechen. Claude Code liest einen Eintrag ohne type als Stdio-Server, daher schlägt ein url-Eintrag ohne type fehl.
• Ein Schlüssel mit Zeichen außer Buchstaben, Zahlen, Bindestrichen und Unterstrichen: Wählen Sie einen Servernamen, der nur diese Zeichen verwendet. Andernfalls ist der Schlüssel der Servername.

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"]
    }
  }
}

claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

​

Ihre Server verwalten

# Alle konfigurierten Server auflisten
claude mcp list

# Details für einen bestimmten Server abrufen
claude mcp get notion

# Einen Server entfernen
claude mcp remove notion

# (innerhalb von Claude Code) Serverstatus überprüfen
/mcp

​

Serverstatus

• ⏸ Pending approval (run `claude` to approve): ein projektbezogener Server aus .mcp.json, den Sie noch nicht genehmigt haben. Claude Code zeigt ihn sowohl in claude mcp list als auch in claude mcp get <name> an. Führen Sie claude interaktiv aus, um ihn zu prüfen und zu genehmigen.
• ✘ Rejected (see disabledMcpjsonServers in settings): ein .mcp.json-Server, den ein disabledMcpjsonServers-Eintrag ablehnt. Claude Code zeigt ihn nur in claude mcp get <name>.
• ⊘ Disabled for this project (re-enable via /mcp): ein Server, den die disabledMcpServers-Liste des Projekts nennt. Claude Code zeigt ihn sowohl in claude mcp list als auch in claude mcp get <name>. Schalten Sie den Server über das /mcp-Panel wieder ein.
• ✘ Blocked by enterprise managed policy: ein Server, den eine der Richtlinien Ihrer Organisation ablehnt. Claude Code zeigt ihn sowohl in claude mcp list als auch in claude mcp get <name> an. Ein Server, der durch eine Allowlist, eine Denylist oder eine andere Einschränkung in der verwalteten MCP-Konfiguration blockiert wird, ist in beiden Befehlen ausgeblendet, statt mit diesem Status angezeigt zu werden. Fragen Sie Ihren Administrator, welche Richtlinie den Server blockiert.

​

Genehmigungen von Projektservern und Workspace-Vertrauen

• Ihre Benutzer-~/.claude/settings.json
• verwaltete Einstellungen
• Einstellungen, die mit --settings übergeben werden

​

Serverstatus-Detail

• Der Pfad und die Abfrage erscheinen niemals in dieser Meldung.
• Für einen Server im lokalen, Projekt- oder Benutzer-Bereich oder in verwalteter MCP-Konfiguration zeigt der Ursprung den Host wie in dieser Konfiguration geschrieben, daher wird eine ${VAR}-Referenz im Host in der Meldung nicht erweitert.
• Bei einem Fehler ohne Status oder Fehlercode zeigt Claude Code den Fehlertext ohne den Ursprung.

​

Konfigurationswarnungen

• Versteckte Leerzeichen: Claude Code warnt, wenn ein MCP-Konfigurationswert versteckte führende oder nachfolgende Leerzeichen trägt, die oft vom Einfügen eines Tokens mit einem nachfolgenden Zeilenumbruch stammen. Claude Code überprüft command, url, jeden args-Eintrag und die Werte und Schlüsselnamen unter env und headers. Claude Code zeigt die Warnung in der claude mcp list-Ausgabe und in /mcp an und nennt die betroffenen Felder, ohne ihre Werte auszugeben, zum Beispiel Leading or trailing whitespace in: headers.Authorization. Claude Code trimmt die Leerzeichen nicht und verwendet die Werte genau wie geschrieben, daher bearbeiten Sie die Konfiguration, um sie zu entfernen.
• Gleicher Name in mehr als einem Bereich: Wenn Sie denselben Servernamen in mehr als einem Bereich mit verschiedenen Endpunkten definieren, warnt Claude Code vor dem Konflikt in der claude mcp list-Ausgabe und in /mcp. Claude Code speichert OAuth-Anmeldungen pro Endpunkt, daher müssen Sie sich, wenn Sie die Definition authentifizieren, die in einem Projekt geladen wird, in einem Projekt, in dem eine andere Definition geladen wird, immer noch separat anmelden. Behalten Sie den Endpunkt, den Sie möchten, und entfernen Sie die anderen mit claude mcp remove <name> --scope <scope>. In der Warnung zitiert Claude Code den Endpunkt jedes Bereichs wie in Ihrer Konfiguration geschrieben, mit ${VAR}-Referenzen nicht erweitert, daher zeigt es niemals einen aufgelösten Wert wie einen API-Schlüssel.
• Reservierte Namen: Claude Code reserviert die Namen seiner integrierten Server, einschließlich workspace, claude-in-chrome, computer-use, Claude Preview und Claude Browser. Wenn Ihre Konfiguration einen Server mit einem reservierten Namen definiert, überspringt Claude Code ihn beim Laden und zeigt eine Warnung an, die Sie auffordert, ihn umzubenennen. claude mcp add lehnt einen reservierten Namen mit einem Fehler ab. Claude Preview und Claude Browser benennen beide den integrierten Server, den das Vorschau-Panel der Claude Code Desktop-App verwendet.
• Fehlende Umgebungsvariable: Wenn eine ${VAR}-Referenz in der Konfiguration eines Servers eine Variable nennt, die nicht gesetzt ist und keinen :-default hat, warnt Claude Code in der claude mcp list-Ausgabe und in /mcp, nennt die Variable und lädt den Server immer noch mit dem ${VAR}-Text nicht erweitert. Setzen Sie die Variable oder fügen Sie einen ${VAR:-default}-Fallback hinzu. In der url und headers eines Remote-Servers lesen einige Anmeldungsvariablen stattdessen als leer, ohne Warnung.

​

Werkzeugverfügbarkeit

• Mit Werkzeugsuche, der Standard: Das Warten geschieht innerhalb des ToolSearch-Aufrufs.
• Ohne Werkzeugsuche: Claude verwendet stattdessen das WaitForMcpServers-Werkzeug. Konfigurationen ohne Werkzeugsuche umfassen ENABLE_TOOL_SEARCH=false und ein Modell, das älter als Claude Opus 4.5, Claude Sonnet 4.5 und Claude Haiku 4.5 ist, auf Google Clouds Agent Platform. Für ein ANTHROPIC_BASE_URL-Gateway siehe Werkzeugsuche über ein LLM-Gateway.
• Bei einer Microsoft Foundry-Bereitstellung auf Azure gehostet: Claude startet auf dem Werkzeugsuche-Pfad statt mit WaitForMcpServers, da Claude Code die serverseitige Ablehnung der Bereitstellung nur von der API entdeckt. Nachdem Claude Code diese Bereitstellung auf vorausgehendes Laden umschaltet, werden Werkzeuge von einem Server, der seinen Verbindungsaufbau abschließt, bei Claudes nächster Anfrage verfügbar.

​

Einen Server deaktivieren, ohne ihn zu entfernen

• disabledMcpServers: eine Opt-out-Liste für benutzerkonfigurierte Server, Plugin-Server, Server, die Ihre Organisation durch verwaltete Einstellungen bereitstellt, die claude.ai-Connectoren, die Claude Code selbst abruft, und integrierte Server, die standardmäßig aktiviert sind. Claude Code verbindet sich nicht mit einem Server, den Sie hier auflisten. Wenn Sie einen claude.ai-Connector mit dem pro-Projekt-/mcp-Umschalter deaktivieren, der in claude.ai-Connectoren deaktivieren beschrieben ist, schreibt Claude Code ihn unter seinem Anzeigenamen in diese Liste, zum Beispiel claude.ai Slack.
• enabledMcpServers: eine Opt-in-Liste für integrierte Server, die standardmäßig deaktiviert sind, wie computer-use. Claude Code verbindet sich mit einem standardmäßig deaktivierten Server nur, wenn Sie ihn hier auflisten.

​

MCP-Client-Runtimes

• Sitzungen auf Amazon Bedrock, Claude Platform auf AWS, Google Clouds Agent Platform oder Microsoft Foundry, es sei denn, eine Host-Plattform, die Claude Code einbettet, setzt CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Sitzungen, die sich über ein Claude-Apps-Gateway anmelden
• Sitzungen, in denen Sie Telemetrie oder Feature-Flag-Abruf deaktivieren, zum Beispiel mit DISABLE_TELEMETRY

• Es fragt HTTP-, Stdio- und claude.ai-Konnektor-Server, ob sie die neuere Revision unterstützen, und verwendet sie mit denen, die dies tun. Dazu gehören die Konnektoren von Cloud- und Remote Control-Sitzungen. Es verbindet sich mit jedem anderen Server wie v1.
• Es empfängt list_changed-Benachrichtigungen von Servern auf der neueren Revision über einen Stream, den es offen hält.
• Es registriert keinen Channel-Server, der sich auf der neueren Revision verbindet, da diese Revision keine Channel-Nachrichten tragen kann.
• Es lässt eine MCP-OAuth-Anmeldung fehlschlagen, deren Autorisierungsantwort einen unerwarteten Aussteller nennt.
• Es sendet MCP-OAuth-Anmeldedaten nur an einen Token-Endpunkt, der über HTTPS oder bei localhost, 127.0.0.1 oder ::1 bereitgestellt wird. Die Anmeldung schlägt für einen Server fehl, dessen Token-Endpunkt einfaches http:// irgendwo anders ist, wie ein Gerät in Ihrem lokalen Netzwerk. Siehe Refusing to send credentials to non-https token endpoint.

​

Dynamische Werkzeugaktualisierungen

• In einer interaktiven Terminal-Sitzung ruft Claude Code die aktualisierte Liste von diesem Server ab, sodass Sie ihn nicht erneut verbinden müssen.
• Im nicht interaktiven Modus mit dem Flag -p und im Agent SDK aktualisiert Claude Code bei diesen Benachrichtigungen nur die Tool-Liste.

​

Benachrichtigungsströme auf der v2-Runtime

• Der Stream schließt innerhalb von 10 Sekunden erneut: Claude Code öffnet ihn bis zu dreimal erneut, dann stoppt es für diese Verbindung.
• Der Stream bleibt länger als 10 Sekunden offen und schließt dann, wie es Streams zu serverlosen Hosts häufig tun: Nach fünf Wiederöffnungen in einer Stunde wartet Claude Code etwa sechs Stunden vor der nächsten.

​

Automatische Wiederverbindung

​

Mitten in der Sitzung abbrechende Remote-Server

• In einer interaktiven Sitzung: /mcp zeigt den Server als ausstehend an, während Claude Code erneut verbindet. Nach fünf fehlgeschlagenen Versuchen markiert Claude Code den Server als fehlgeschlagen oder als Authentifizierung erforderlich, wenn der Server erneut autorisiert werden muss. Wenn es den Server als fehlgeschlagen markiert, sehen Sie eine MCP server "<name>" disconnected · open /mcp to reconnect-Benachrichtigung. Sie können es manuell von /mcp aus erneut versuchen.
• In claude -p-Läufen und Agent SDK-Sitzungen: Claude Code unternimmt dieselben fünf Versuche, ohne /mcp-Panel, um sie anzuzeigen. Wenn alle fünf fehlschlagen, läuft der Lauf ohne die Tools des Servers weiter:
  • Nach einem vorübergehenden Fehler, etwa einer 5xx-Antwort oder einem Timeout: Claude Code versucht es bei einem HTTP- oder SSE-Server im Hintergrund weiter. Die Wiederholungsversuche dauern bis zu etwa einer halben Stunde, und die Tools des Servers werden wieder verfügbar, wenn einer davon eine Verbindung herstellt. Bis dahin meldet eine Agent SDK-Sitzung den Status failed, und Ihr Code kann den Server erneut verbinden. Um ihn in claude -p erneut zu verbinden, starten Sie den Lauf neu.
  • Wenn der Server eine erneute Anmeldung von Ihnen erfordert: Claude Code beendet die Wiederholungsversuche, und eine Agent SDK-Sitzung meldet den Status des Servers als needs-auth. Melden Sie sich in Ihrer Shell mit claude mcp login <name> an. Starten Sie dann den Lauf neu oder verbinden Sie den Server in einer Agent SDK-Sitzung stattdessen erneut.

​

Fehlgeschlagene erste Verbindungen

• Die erste Verbindung eines Stdio-Servers. Um es erneut zu versuchen, siehe Stdio-Server, die beendet werden oder nicht starten
• Die erste Verbindung eines WebSocket-Servers. Um es in einer interaktiven Terminal-Sitzung erneut zu versuchen, wählen Sie im Menü des Servers in /mcp Reconnect aus
• Ein Authentifizierungs- oder Not-Found-Fehler, da er eine Konfigurationsänderung erfordert, um ihn zu beheben. Wenn ein headersHelper die einzige Quelle des Authorization-Headers des Servers ist, versucht Claude Code einen Authentifizierungsfehler trotzdem erneut, da es den Helper bei jedem Versuch erneut ausführt und frische Anmeldedaten abholen kann

​

Stdio-Server, die beendet werden oder nicht starten

​

Fehlgeschlagene Erkennungsanfragen

​

Fehlgeschlagene Server selbst erneut versuchen

​

Wie Claude erfährt, dass ein Server fehlgeschlagen ist

• Mit Werkzeugsuche teilt Claude Code Claude mit, welcher Server fehlgeschlagen ist und welchen Verbindungsfehler er hatte, daher meldet Claude den Verbindungsfehler in seiner Antwort. Claude Code nimmt dieselben Informationen in ToolSearch-Ergebnisse auf, die kein passendes Werkzeug finden.
• In jeder Konfiguration ohne Werkzeugsuche meldet Claude Code fehlgeschlagene Serververbindungen nicht an Claude.

​

Nachrichten mit Channels pushen

​

Zeitlimits für MCP-Tool-Aufrufe

• Pro Server: Fügen Sie dem Konfigurationseintrag dieses Servers ein Feld timeout in Millisekunden hinzu
• Serverübergreifend: Setzen Sie MCP_TOOL_TIMEOUT

​

Automatisches Backgrounding von langen Werkzeugaufrufen

• Setzen Sie die Umgebungsvariable CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS in Millisekunden, um den Schwellenwert zu ändern, oder setzen Sie sie auf 0, um das automatische Verschieben auszuschalten. Mit 0 wartet Claude in einer interaktiven Sitzung außerdem auf MCP-Tasks
• Setzen Sie CLAUDE_CODE_DISABLE_BACKGROUND_TASKS auf 1, um das automatische Verschieben in den Hintergrund und Hintergrundbefehle auszuschalten

• Aufrufe von Subagenten; Claude Code verschiebt nur Aufrufe der Hauptkonversation in den Hintergrund
• Aufrufe an IDE-Server
• Aufrufe im nicht interaktiven Modus, es sei denn, CLAUDE_AUTO_BACKGROUND_TASKS ist auf 1 gesetzt, da ein One-Shot-Lauf enden kann, bevor das Ergebnis ankommt

​

MCP-Tasks, die auf dem Server laufen

​

Einen MCP-Task stoppen oder sein Ergebnis abrufen

MCP task <server task id> (<server>/<tool>) completed.

​

Eine Frage eines MCP-Tasks beantworten

​

Beenden, Leeren oder Fortsetzen, während ein MCP-Task läuft

​

Was ein Aufruf benötigt, um zu einem MCP-Task zu werden

• Der Server unterstützt Tasks
• Der Server ist ein HTTP-, stdio- oder claude.ai-Konnektor-Server, der über die Protokollrevision 2026-07-28 verbunden ist. Das Setzen von MCP_SDK_GENERATION=v1 oder MCP_PROTOCOL_NEGOTIATION=legacy schließt dies aus
• Die Sitzung ruft Feature-Flags ab, also nicht bei einem Drittanbieter wie Amazon Bedrock und nicht bei ausgeschalteter Telemetrie oder ausgeschaltetem Abruf von Flags
• Anthropic hat MCP-Tasks für Ihre Art von Sitzung eingeschaltet. Ab v2.1.304 umfasst das Terminal-CLI-Sitzungen, Agent SDK-Sitzungen und GitHub Actions-Ausführungen. Andere Oberflächen wie die VS Code-Erweiterung und die Desktop-App haben keine MCP-Tasks
• Der Aufruf stammt aus der Hauptkonversation, nicht von einem Subagenten
• Entweder ist die Sitzung interaktiv, oder eine Agent SDK-Sitzung bzw. eine claude -p-Ausführung, die --input-format stream-json liest, hat:
  • CLAUDE_AUTO_BACKGROUND_TASKS auf 1
  • CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND nicht auf 1
  • CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS nicht auf 0

​

Statusmeldungen zu einem MCP-Task

​

Zeitlimits für MCP-Tasks

​

Claude auf das Ergebnis eines MCP-Tasks warten lassen

• CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS auf 0 gesetzt: Claude wartet bei jedem MCP-Tool-Aufruf, bis der Aufruf endet
• CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND auf 1 gesetzt: Claude wartet auf das Ergebnis eines Tasks. Solange das automatische Verschieben in den Hintergrund eingeschaltet ist, verschiebt es den Aufruf standardmäßig nach zwei Minuten, sodass kurze Tasks an Ort und Stelle abgeschlossen werden und lange Sie nicht blockieren. Der verschobene Aufruf ist ein gewöhnlicher Hintergrundaufruf und kein MCP-Task. Er überdauert das Beenden der Sitzung nicht

{
  "env": {
    "CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS": "0"
  }
}

​

MCP-Tasks für Serverautoren

​

Den Aufruf mit einem Task beantworten

{
  "resultType": "task",
  "taskId": "build-7f3a9c2e",
  "status": "working",
  "statusMessage": "Compiling, 40 of 212 files done",
  "createdAt": "2026-10-22T14:03:07Z",
  "lastUpdatedAt": "2026-10-22T14:03:07Z",
  "ttlMs": null,
  "pollIntervalMs": 5000
}

​

Status, Ergebnisse und Fragen melden

{
  "resultType": "complete",
  "taskId": "build-7f3a9c2e",
  "status": "completed",
  "createdAt": "2026-10-22T14:03:07Z",
  "lastUpdatedAt": "2026-10-22T14:09:41Z",
  "ttlMs": null,
  "result": {
    "content": [{ "type": "text", "text": "Build succeeded: 212 files, 0 warnings" }]
  }
}

​

Von Plugins bereitgestellte MCP-Server

• Plugins definieren MCP-Server in .mcp.json im Plugin-Root oder inline in plugin.json
• Wenn Sie ein Plugin aktivieren, startet Claude Code seine MCP-Server automatisch
• Claude Code bietet Plugin-MCP-Werkzeuge neben manuell konfigurierten MCP-Werkzeugen an
• Sie fügen Plugin-Server hinzu und entfernen sie, indem Sie das Plugin installieren oder deinstallieren, nicht mit /mcp-Befehlen. Sie können einen installierten Plugin-Server in /mcp weiterhin ausschalten, was Claude Code daran hindert, sich damit zu verbinden, ohne das Plugin zu entfernen

{
  "mcpServers": {
    "database-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

• Automatischer Lebenszyklus: Server verbinden und trennen sich an diesen Punkten:
  • Beim Sitzungsstart verbindet Claude Code die Server für aktivierte Plugins automatisch. In /mcp kann ein Remote-(HTTP- oder SSE-)Plugin-Server, den Sie zuvor verwendet haben, stattdessen den cached-Status anzeigen; Claude Code verbindet ihn, wenn Claude eines seiner Werkzeuge zum ersten Mal aufruft. Wenn die Verbindung eines Stdio-Plugin-Servers vor weniger als 15 Minuten fehlgeschlagen ist, überspringt Claude Code die Verbindung
  • Wenn Sie ein Plugin während einer Sitzung aktivieren oder deaktivieren, verbindet oder trennt Claude Code seine MCP-Server, wenn die Änderung angewendet wird. Plugin-Änderungen ohne Neustart anwenden beschreibt, wann das ist. In einer Sitzung ohne interaktives Terminal verbindet oder trennt /reload-plugins keine Plugin-MCP-Server; diese Änderungen treten in Ihrer nächsten Sitzung in Kraft
  • Wenn Sie neu laden, behält Claude Code die Live-Verbindungen von Plugin-Servern, deren Konfiguration unverändert ist, und macht dasselbe, wenn Sie die MCP-Serverliste der Sitzung vom Agent SDK ersetzen, ohne sie zu nennen
  • Wenn Sie die Sitzung auf v2.1.246 oder später mit /cd in ein anderes Verzeichnis verschieben, verbindet Claude Code die Server von Plugins, die die Einstellungen des neuen Verzeichnisses aktivieren, und trennt die Server von Plugins, die nicht mehr aktiviert sind, daher müssen Sie /reload-plugins nach der Verschiebung nicht ausführen
  • In Cloud-Sitzungen startet ein MCP-Aufruf an einen Plugin-Server, der noch nicht verbunden ist, etwa direkt nachdem eine inaktive Sitzung aufwacht, den Server bei Bedarf und wartet auf die Verbindung
• Pfad-Platzhalter: ${CLAUDE_PLUGIN_ROOT} wird zum Installationsverzeichnis des Plugins aufgelöst, ${CLAUDE_PLUGIN_DATA} zu seinem Verzeichnis für persistenten Zustand und ${CLAUDE_PROJECT_DIR} zum stabilen Projektstammverzeichnis. Die Substitution gilt für:
  • stdio-Server: command, args, env
  • http-, sse- und ws-Server: url, headers und headersHelper
• Zugriff auf Benutzerumgebung: Zugriff auf dieselben Umgebungsvariablen wie manuell konfigurierte Server
• Mehrere Transporttypen: Unterstützung für Stdio-, SSE-, HTTP- und WebSocket-Transporte, obwohl die Transportunterstützung je nach Server variieren kann

• Stdio-Server: Es gibt Command: stdio, eine leere Args:-Zeile und jede Umgebungsvariable als NAME=[REDACTED] aus
• WebSocket-Server: Es gibt URL: ws und jeden Header als <name>: [REDACTED] aus, und claude mcp list zeigt ws anstelle der URL

mcp__plugin_my-plugin_database-tools__query

​

MCP-Installationsbereiche

​

Lokaler Bereich

# Einen lokal begrenzten Server hinzufügen (Standard)
claude mcp add --transport http stripe https://mcp.stripe.com

# Lokalen Bereich explizit angeben
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

​

Projektbereich

# Einen projektbegrenzten Server hinzufügen
claude mcp add --transport http shared-server --scope project https://example.com/mcp

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

• Fügen Sie ihn zu disabledMcpjsonServers hinzu, was ihn in jedem Berechtigungsmodus blockiert.
• Schließen Sie Projekteinstellungen vollständig mit --setting-sources oder der SDK-Option settingSources aus.
• Starten Sie die Sitzung mit --strict-mcp-config. Claude Code verwendet dann nur die MCP-Server, die Sie mit --mcp-config übergeben. Das Überspringen der Genehmigungsaufforderung für die projektbegrenzten Server, die Claude Code nicht lädt, erfordert Claude Code v2.1.246 oder später; vor v2.1.246 wartete eine strikte Sitzung immer noch auf Genehmigung für diese, was Hintergrundsitzungen beim Start wartend ließ. Siehe Exklusive Kontrolle mit managed-mcp.json für das, was das Flag unter einer verwalteten MCP-Datei tut.

​

Benutzerbereich

# Einen Benutzer-Server hinzufügen
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​

Bereichshierarchie und Vorrang

1. Lokaler Bereich
2. Projektbereich
3. Benutzerbereich
4. Von Plugins bereitgestellte Server
5. claude.ai-Connectoren

​

Umgebungsvariablen-Erweiterung in .mcp.json

• ${VAR}: erweitert sich zum Wert der Umgebungsvariablen VAR
• ${VAR:-default}: wird zum Wert von VAR erweitert, wenn VAR gesetzt ist, oder zu default, wenn sie nicht gesetzt ist

​

Beispiel mit Variablenerweiterung

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

​

Nicht gesetzte Variablen ohne Standard

​

Auf eine leere Zeichenfolge gesetzte Variablen

​

Anmeldedatenvariablen, die als leer gelesen werden

• Claude Code’s eigene Anmeldedaten, wie ANTHROPIC_API_KEY und ANTHROPIC_AUTH_TOKEN
• Ihre Cloud-Provider-Anmeldedaten, wie AWS_BEARER_TOKEN_BEDROCK
• Andere Anmeldedaten, die Ihre Umgebung trägt, wie HTTPS_PROXY und NPM_TOKEN

​

Wie Referenzen in /mcp und CLI-Ausgabe angezeigt werden

• Die URL oder Befehlszeile in der Detailansicht eines Servers unter /mcp
• claude mcp list und claude mcp get Ausgabe

​

Praktische Beispiele

​

Beispiel: Mit GitHub für Code-Reviews verbinden

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

Review PR #456 and suggest improvements

Create a new issue for the bug we just found

Show me all open PRs assigned to me

​

Beispiel: Ihre PostgreSQL-Datenbank abfragen

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

What's our total revenue this month?

Show me the schema for the orders table

Find customers who haven't made a purchase in 90 days

​

Mit Remote-MCP-Servern authentifizieren

• Für einen Server, bei dem Sie sich nicht angemeldet haben, kennzeichnet jeder dieser Statuscodes den Server in /mcp, damit Sie den OAuth-Fluss abschließen können.
• Für einen claude.ai-Konnektor kennzeichnet ein 401, das durch die Ablehnung Ihres Sitzungs-Tokens durch claude.ai verursacht wird, den Konnektor nicht, da eine erneute Autorisierung des Konnektors Ihre Anmeldung nicht beheben kann. Claude Code zeigt stattdessen den Zustand „Sitzungs-Token abgelehnt“ an.
• Für einen Server, dessen Authorization-Header Sie konfiguriert haben, in headers oder über einen headersHelper, kennzeichnet ein 401 oder 403 beim Verbinden den Server nicht, da die Anmeldedaten, die behoben werden müssen, diejenigen sind, die Sie konfiguriert haben. Claude Code meldet die Verbindung stattdessen als fehlgeschlagen. Wenn Sie diesen Header aus einer ${VAR}-Referenz gesetzt haben, überprüfen Sie, ob diese Variable eine ist, die Claude Code als leer liest.
• Für einen Konnektor, der an eine Cloud-Sitzung übermittelt wird, führt Claude Code keinen Anmeldungsfluss aus, da der Proxy der Sitzung sich beim Konnektor mit der Autorisierung authentifiziert, die Sie in claude.ai gewährt haben. Wenn ein Konnektor dort erneut autorisiert werden muss, verbinden Sie ihn erneut unter claude.ai/customize/connectors, anstatt aus der Sitzung.

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

/mcp

​

Authentifizieren Sie sich über die Befehlszeile

claude mcp login sentry

claude mcp login sentry --no-browser

​

Verwenden Sie einen festen OAuth-Callback-Port

# Fester Callback-Port mit dynamischer Client-Registrierung
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Verwenden Sie vorkonfigurierte OAuth-Anmeldedaten

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Überschreiben Sie die OAuth-Metadaten-Erkennung

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

​

Beschränken Sie OAuth-Scopes

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

​

Verwenden Sie OAuth mit einem Server hinter einem authentifizierenden Proxy

• Der Header des Proxys: Übergeben Sie ihn mit --header, dem Feld headers oder einem headersHelper, unter dem Namen, den der Proxy liest
• Die OAuth-Anmeldung: Halten Sie Authorization aus den konfigurierten Headern heraus und melden Sie sich dann mit claude mcp login <name> in Ihrer Shell an. Wenn Sie einen Authorization-Header konfigurieren, verwendet Claude Code ihn als Anmeldedaten des Servers und greift für diesen Server nicht auf OAuth zurück.

​

Verwenden Sie dynamische Header für benutzerdefinierte Authentifizierung

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

• Der Befehl muss ein JSON-Objekt mit String-Schlüssel-Wert-Paaren auf stdout schreiben
• Claude Code führt den Befehl in einer Shell aus und bricht ihn nach 10 Sekunden ab
• Claude Code wählt das Arbeitsverzeichnis des Befehls danach, wo Sie den Server konfiguriert haben, geben Sie das Skript daher als absoluten Pfad an oder legen Sie es in den PATH
• Dynamische Header überschreiben alle statischen headers mit dem gleichen Namen

​

Wo der Helper ausgeführt wird

​

Welche Variablen ein Helper lesen kann

• Entfernt: ein Server in einer Projekt-.mcp.json oder in einem Plugin sowie ein Inline-Server in einer Agent-Datei aus Ihrem Projekt oder aus einem --add-dir-Verzeichnis
• Nicht entfernt: ein Server im Benutzer- oder lokalen Geltungsbereich, in verwaltetem MCP, von einem claude.ai-Konnektor oder bereitgestellt vom SDK oder über --mcp-config sowie ein Inline-Server in einer Agent-Datei aus ~/.claude/agents/, aus verwalteten Einstellungen oder übergeben mit --agents

​

Vertrauen Sie einem Ordner, bevor sein headersHelper ausgeführt wird

• Vertrauen, das nicht zählt: das Vertrauen eines übergeordneten Ordners und das automatische Vertrauen, das eine claude -p- oder SDK-Sitzung für Hooks in Einstellungsdateien erhält
• Bis Sie dem Ordner vertrauen: Claude Code verbindet den Server nur mit seinen statischen headers. In einer claude -p- oder SDK-Sitzung gibt es außerdem pro Server eine headersHelper not run-Zeile auf stderr aus, die Ihnen mitteilt, wie Sie das Vertrauen gewähren.
• Vertrauen ohne Dialog: Setzen Sie projects["<path>"].hasTrustDialogAccepted in ~/.claude.json auf true. <path> ist der Ordner, an den Claude Code das Vertrauen laut Project allow rules and workspace trust bindet.

​

Melden Sie sich bei einem MCP-Server hinter einem Gateway an, das einen Header erfordert

• Ein Server, dessen Konfiguration Sie bearbeiten können: Setzen Sie ihn in headers oder geben Sie ihn aus einem headersHelper zurück
• Ein Server, den verwaltetes MCP oder ein Plugin bereitstellt: Bitten Sie Ihren Administrator oder den Autor des Plugins, den Header zum Eintrag des Servers hinzuzufügen

• Die Autorisierungsseite: Sie melden sich auf dieser Seite in Ihrem Browser an, der die konfigurierten Header nicht sendet. Wenn Ihr Browser statt der Seite den Fehler des Gateways erhält, bitten Sie die für das Gateway verantwortliche Person, die Seite ohne den Header durchzulassen.
• Ein Autorisierungsserver auf einem anderen Origin: Wenn ein Gateway vor diesem Server den Header ebenfalls erfordert, schlägt die Anmeldung dort fehl. Bitten Sie die für dieses Gateway verantwortliche Person, OAuth-Anfragen ohne den Header durchzulassen.

​

MCP-Server aus JSON-Konfiguration hinzufügen

# Grundlegende Syntax
claude mcp add-json <name> '<json>'

# Beispiel: Hinzufügen eines HTTP-Servers mit JSON-Konfiguration
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Beispiel: Hinzufügen eines Stdio-Servers mit JSON-Konfiguration
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# Beispiel: Hinzufügen eines HTTP-Servers mit vorkonfigurierten OAuth-Anmeldedaten
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

claude mcp get weather-api

​

MCP-Server aus Claude Desktop importieren

# Grundlegende Syntax 
claude mcp add-from-claude-desktop 

claude mcp list 

​

MCP-Server von claude.ai verwenden

/mcp

• ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN oder apiKeyHelper aktiv ist
• Ein Drittanbieter wie Amazon Bedrock oder Google Cloud’s Agent Platform aktiv ist
• ANTHROPIC_PROFILE, die Federation-Variablen oder ein aktives Anthropic-Profil die Anmeldedaten bereitstellt
• CLAUDE_CODE_OAUTH_TOKEN ein Token von claude setup-token enthält, das nur Modellanfragen stellen kann

1. Führen Sie /login aus, um sich erneut anzumelden.
2. Verbinden Sie den Konnektor erneut von /mcp.

​

Wie Konnektoren Claude Code erreichen

• Cloud-Sitzungen: allowedMcpServers- und deniedMcpServers-Einträge, die die Sitzung erreichen, beispielsweise durch Server-verwaltete Einstellungen, filtern auch die bereitgestellten Konnektoren. Der Proxy der Sitzung schreibt die URL jedes Konnektors um, daher passt ein serverUrl-Muster, das für die eigene URL des Konnektors geschrieben wurde, nicht dazu. Um bereitgestellte Konnektoren neben einer URL-Allowlist in einer selbstgehosteten Umgebung zuzulassen, fügen Sie die serverUrl-Einträge hinzu, die unter Konnektor-Datenverkehr verlässt Ihr Netzwerk aufgelistet sind. Claude Code verwirft die bereitgestellten Konnektoren, wenn eine managed-mcp.json auf dem Host vorhanden ist, der die Sitzung ausführt, z. B. ein selbstgehosteter Runner-Host, unabhängig davon, ob Sie allowAllClaudeAiMcps setzen.
• Lokale und SSH-Sitzungen der Desktop-App: Die Desktop-App registriert die Konnektoren als prozessinterne type: "sdk"-Server, und keine MCP-Einstellung oder managed-mcp.json erreicht sie. Ein Benutzer hält einen Konnektor aus seinen eigenen Sitzungen heraus, indem er ihn unter claude.ai/customize/connectors trennt. Eine Organisation blockiert die Tools eines Konnektors oder schaltet Claude Code in der Desktop-App ganz aus.

​

Organisationskontrollen für Konnektor-Tools

• Tool auf ask gesetzt: Claude Code fragt bei jedem Aufruf mit dem Grund Your organization requires approval for this tool nach. Die Berechtigungsabfrage wird auch in den Berechtigungsmodi acceptEdits, auto und bypassPermissions angezeigt. Im Terminal bietet die Berechtigungsabfrage keine Option, Ihre Wahl zu merken. allow-Regeln, die auf das Tool zutreffen, überspringen die Berechtigungsabfrage auch nicht. Im dontAsk-Modus, der niemals nachfragt, lehnt Claude Code den Aufruf stattdessen ab.
• Tool auf blocked gesetzt: Claude Code filtert das Tool heraus, bevor Claude es sieht, daher wird es nie in Claudes Tool-Liste angezeigt. In Sitzungen, in denen Claude Code Konnektoren selbst abruft, zeigt die /mcp-Tool-Liste das Tool immer noch an, markiert als disabled by your organization.

​

claude.ai-Konnektoren deaktivieren

{
  "disableClaudeAiConnectors": true
}

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

Claude Code als MCP-Server verwenden

# Claude als stdio MCP-Server starten
claude mcp serve

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Die Ausgabe eines Hintergrundbefehls als MCP-Client lesen

• Um die bisherige Ausgabe zu lesen: Öffnen Sie die Datei unter diesem Pfad von Ihrem Client aus, oder übergeben Sie den Pfad als file_path an das Read-Tool des Servers
• Um zu erkennen, wann der Befehl abgeschlossen ist: Hängen Sie ein echo einer festen Zeichenfolge an den Wert von command an, etwa npm test; echo DONE. Der Befehl ist abgeschlossen, sobald diese Zeichenfolge in der Datei erscheint. Ohne die Zeichenfolge markiert nichts das Ende, da Claude Code der Datei keine abschließende Zeile hinzufügt und Ihren Client nicht benachrichtigt.
• Um das Ende einer langen Ausgabe zu lesen: Read nur mit file_path gibt die erste Seite zurück oder schlägt fehl, wenn die Datei die Größenbeschränkung überschreitet. Übergeben Sie zusätzlich offset und limit, was bei jeder Dateigröße funktioniert:
  1. Rufen Sie Read mit offset und limit jeweils auf 1 gesetzt auf, und entnehmen Sie totalLines dem Ergebnis
  2. Rufen Sie Read erneut auf, mit offset auf totalLines minus neun und limit auf 10 gesetzt
  3. Suchen Sie Ihre echo-Zeichenfolge in den letzten zehn Zeilen, die der zweite Aufruf zurückgibt

​

MCP-Ausgabebegrenzungen und Warnungen

• Warnungsschwelle für Ausgaben: Claude Code zeigt eine Warnung an, wenn eine MCP-Tool-Ausgabe 10.000 Token überschreitet
• Konfigurierbare Begrenzung: Sie können die maximale zulässige MCP-Ausgabe-Token-Menge mithilfe der Umgebungsvariablen MAX_MCP_OUTPUT_TOKENS anpassen
• Standardbegrenzung: Das Standardmaximum beträgt 25.000 Token
• Geltungsbereich: Die Umgebungsvariable gilt für Tools, die keine eigene Begrenzung deklarieren. Tools, die anthropic/maxResultSizeChars setzen, verwenden diesen Wert stattdessen für Textinhalte, unabhängig davon, auf welchen Wert MAX_MCP_OUTPUT_TOKENS gesetzt ist. Tools, die Bilddaten zurückgeben, unterliegen weiterhin MAX_MCP_OUTPUT_TOKENS
• Über der Begrenzung: Wenn ein erfolgreiches Ergebnis ohne Bildinhalt die Token-Begrenzung überschreitet, speichert Claude Code es in einer Datei und ersetzt es in der Konversation durch eine Nachricht, die den Dateipfad benennt, damit Claude die Datei liest, wenn sie den Inhalt benötigt. Die Datei befindet sich im Verzeichnis tool-results der Sitzung unter ~/.claude/projects/.
• Antwortgröße von HTTP- und SSE-Servern: Wenn eine Antwort von einem HTTP- oder SSE-Server 16 MiB überschreitet, beendet Claude Code das Lesen und die Anfrage schlägt fehl. Die Begrenzung gilt nach der Dekomprimierung für einen einzelnen JSON-Response-Body oder ein einzelnes Ereignis eines Event-Streams. Wenn Sie den Server betreuen, geben Sie pro Antwort weniger Daten zurück, um unter der Begrenzung zu bleiben, zum Beispiel durch Paginierung der Ergebnisse
• Nachrichtengröße von WebSocket-Servern: Wenn ein WebSocket-Server eine einzelne Nachricht über 16 MiB sendet, schließt Claude Code die Verbindung, und laufende Aufrufe an diesen Server schlagen fehl. Wenn Sie den Server betreuen, geben Sie pro Nachricht weniger Daten zurück, um unter der Begrenzung zu bleiben

• Zeichenbegrenzung für Textergebnisse: Bei einem Tool, das anthropic/maxResultSizeChars nicht deklariert, speichert Claude Code ein erfolgreiches Ergebnis ohne Bildinhalt in einer Datei, sobald es länger als 50.000 Zeichen ist, unabhängig von seiner Token-Anzahl. Das Setzen von MAX_MCP_OUTPUT_TOKENS ändert diesen Schwellenwert nicht
• Fehlerergebnisse: Wenn ein Tool ein Ergebnis zurückgibt, das mit isError: true markiert ist, erhält Claude den Text des Ergebnisses als Fehlermeldung des Tools. Bei Fehlertext, der länger als etwa 11.000 Zeichen ist, bleiben nur die ersten 5.000 und die letzten 5.000 Zeichen erhalten, mit einer Markierung dazwischen, die angibt, wie viele Zeichen entfernt wurden

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

Erhöhen Sie die Begrenzung für ein bestimmtes Tool

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

​

Bilder in Tool-Ergebnissen

​

Tool-Eingabeschemas mit einem Kombinator auf Root-Ebene

• allOf: Eigenschaften aus jedem Branch werden zusammengeführt, und die required-Liste jedes Branchs gilt weiterhin
• anyOf und oneOf: Eigenschaften aus jedem Branch werden zusammengeführt, und die required-Liste jedes Branchs wird stattdessen in der Tool-Beschreibung beschrieben, anstatt vom Schema erzwungen zu werden

​

Tools mit ungültigen Eingabeschemas

• Namen von Eigenschaften auf der obersten Ebene müssen 1 bis 64 Zeichen lang sein und dürfen nur ASCII-Buchstaben und Ziffern, _, . und - verwenden
• Das Schema muss gegen das JSON-Schema-Draft-2020-12-Meta-Schema gültig sein. Claude Code wendet diese Überprüfung auf Schemas an, die kein $schema deklarieren, und auf Schemas, die Draft 2020-12 deklarieren. Ein Schema, das einen anderen Dialekt deklariert, überspringt diese Überprüfung, obwohl die obige Überprüfung der Eigenschaftsnamen weiterhin gilt

• Claude erhält das Tool unverändert, und das Log des Servers zeichnet dafür input schema would be rejected by the Anthropic API auf
• Wenn die API das Schema anschließend ablehnt, lesen Sie Tools, deren Eingabeschema die API ablehnt

​

Tools, deren Eingabeschema die API ablehnt

• Wenn Ihre Sitzung mit einem 400-Fehler fehlschlägt, der ein Tool nach seiner Position benennt: Folgen Sie den Schritten unter Tool input schema is invalid
• Wenn Sie den Server verwenden: Sie müssen nichts tun. Claude kann das Tool weiterhin aufrufen, sieht aber seine Parameter nicht
• Wenn Sie den Server pflegen: Korrigieren Sie das Eingabeschema des Tools auf dem Server. Die Log-Zeile endet mit The API said: und dem Grund, aus dem die API das Schema abgelehnt hat. Validieren Sie die Argumente, die der Server empfängt, da Claude das Tool aufruft, ohne seine Parameter zu sehen

​

Tools mit Namen, die länger als 128 Zeichen sind

​

Genehmigung für ein bestimmtes Tool erforderlich

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": true
  }
}

​

Tools markieren, die sicher zweimal aufgerufen werden können

• idempotentHint: Das Tool kann etwas ändern, und ein erneuter Aufruf mit denselben Argumenten ist sicher
• readOnlyHint: Das Tool ändert nichts. Claude Code führt die Aufrufe des Tools außerdem parallel zu anderen nur lesenden Aufrufen aus.

{
  "name": "set_issue_status",
  "annotations": {
    "idempotentHint": true
  }
}

​

Auf MCP-Elicitierungsanfragen reagieren

• Formularmodus: Claude Code zeigt einen Dialog mit Formularfeldern an, die vom Server definiert werden (beispielsweise eine Aufforderung für Benutzernamen und Passwort). Füllen Sie die Felder aus und senden Sie sie ab.
• URL-Modus: Claude Code fragt, ob ein Link in Ihrem Browser geöffnet werden soll. Server verwenden diesen Modus für einen Ablauf, der außerhalb des Terminals abgeschlossen wird, z. B. für die Anmeldung.

​

Von Claude Code deklarierte Elicitierungsmodi

• Verbindungen, die Protokollrevision 2026-07-28 verwenden
• Verbindungen mit den früheren Protokollrevisionen, 2025-11-25 und älter, zu den stdio-, sse-, http- und ws-Servern in der Claude Code-MCP-Konfiguration eines Benutzers. Erfordert Claude Code v2.1.287 oder höher

​

MCP-Ressourcen verwenden

​

MCP-Ressourcen referenzieren

Can you analyze @github:issue://123 and suggest a fix?

Please review the API documentation at @docs:file://api/authentication

Compare @postgres:schema://users with @docs:file://database/user-model

​

Mit MCP-Tool-Suche skalieren

​

Tool-Suche für MCP-Server-Autoren

• Welche Kategorie von Aufgaben Ihre Tools verarbeiten
• Wann Claude nach Ihren Tools suchen sollte
• Wichtige Funktionen, die Ihr Server bietet

• Server-Anweisungen und die Beschreibung eines Tools, das vorab geladen wird: 4.096 Zeichen
• Die Beschreibung eines Tools, das Claude über die Tool-Suche lädt: 16.384 Zeichen

​

Die Längengrenzen für Beschreibungen ändern

​

Ein Tool vorab laden oder aufgeschoben lassen

{
  "name": "search_tickets",
  "description": "Searches the ticket tracker by keyword",
  "_meta": {
    "anthropic/alwaysLoad": true
  }
}

​

Tool-Suche konfigurieren

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 und neuere: Die Tool-Suche ist standardmäßig aktiviert, genauso wie bei der Anthropic API.
• Frühere Agent Platform-Modelle: Claude Code lädt alle MCP-Tools vorab, da ihre Serving-Stacks den erforderlichen Beta-Header ablehnen. ENABLE_TOOL_SEARCH=true überschreibt dies nicht.

# Verwenden Sie einen benutzerdefinierten 5%-Schwellenwert
ENABLE_TOOL_SEARCH=auto:5 claude

# Deaktivieren Sie die Tool-Suche vollständig
ENABLE_TOOL_SEARCH=false claude

{
  "permissions": {
    "deny": ["ToolSearch"]
  }
}

​

Tool-Suche über ein LLM-Gateway

​

Tools, die unterhalb des ENABLE_TOOL_SEARCH=auto-Schwellenwerts aufgeschoben bleiben

​

Einen Server vom Aufschub ausnehmen

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

​

Die Tools eines Servers aufschieben

​

MCP-Prompts als Befehle verwenden

​

MCP-Prompts ausführen

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue login-bug high

​

Verwaltete MCP-Konfiguration