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

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Example with 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

# Basic syntax
claude mcp add --transport sse <name> <url>

# Real example: Connect to Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Example with authentication header
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

# Basic syntax
claude mcp add [options] <name> -- <command> [args...]

# Real example: Add Airtable server
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Wie Claude Code einen stdio-Server beendet

• Unter macOS und Linux: Claude Code sendet SIGINT, dann SIGTERM, falls 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, falls 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 Einrichtungsanleitungen für einen anderen Client hinzufügen

• Eine URL wie https://mcp.example.com/mcp: Der Server ist remote.
• Ein Startbefehl wie npx -y @example/mcp-server: Der Server läuft auf Ihrem Rechner.
• Ein mcpServers-JSON-Block: eine 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 passend zum Endpunkt "type": "http", "type": "sse" oder "type": "ws" hinzu. Claude Code liest einen Eintrag ohne type als stdio-Server, daher schlägt ein url-Eintrag ohne type fehl.
• Ein Schlüssel mit anderen Zeichen als Buchstaben, Ziffern, 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

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get notion

# Remove a server
claude mcp remove notion

# (within Claude Code) Check server status
/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> an.
• ⊘ Disabled for this project (re-enable via /mcp): ein Server, der in der Liste disabledMcpServers des Projekts steht. Claude Code zeigt ihn sowohl in claude mcp list als auch in claude mcp get <name> an. 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, wird 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 Benutzerdatei ~/.claude/settings.json
• verwaltete Einstellungen
• mit --settings übergebene Einstellungen

Details zum Serverstatus

Verbindungsfehler und nicht konfigurierte Server

• Pfad und Query erscheinen nie in dieser Meldung.
• Bei einem Server im lokalen, Projekt- oder Benutzer-Geltungsbereich oder in der verwalteten MCP-Konfiguration zeigt der Ursprung den Host so, wie er in dieser Konfiguration geschrieben ist, sodass eine ${VAR}-Referenz im Host in der Meldung nicht expandiert wird.
• Bei einem Fehler ohne Status oder Fehlercode zeigt Claude Code den Fehlertext ohne den Ursprung an.

Konfigurationswarnungen

• Versteckte Leerzeichen: Claude Code warnt, wenn ein MCP-Konfigurationswert versteckte führende oder nachgestellte Leerzeichen enthält, was oft vom Einfügen eines Tokens mit einem nachgestellten Zeilenumbruch herrührt. Claude Code prüft command, url, jeden args-Eintrag sowie die Werte und Schlüsselnamen unter env und headers. Claude Code zeigt die Warnung in der Ausgabe von claude mcp list und in /mcp an und nennt die betroffenen Felder, ohne ihre Werte wiederzugeben, zum Beispiel Leading or trailing whitespace in: headers.Authorization. Claude Code entfernt die Leerzeichen nicht und verwendet die Werte genau wie geschrieben. Bearbeiten Sie daher die Konfiguration, um sie zu entfernen.
• Gleicher Name in mehr als einem Geltungsbereich: Wenn Sie denselben Servernamen in mehr als einem Geltungsbereich mit unterschiedlichen Endpunkten definieren, warnt Claude Code in der Ausgabe von claude mcp list und in /mcp vor dem Konflikt. Claude Code speichert OAuth-Anmeldungen pro Endpunkt. Wenn Sie also die Definition authentifizieren, die in einem Projekt geladen wird, müssen Sie sich in einem Projekt, in dem eine andere Definition geladen wird, dennoch separat anmelden. Behalten Sie den gewünschten Endpunkt und entfernen Sie die anderen mit claude mcp remove <name> --scope <scope>. In der Warnung zitiert Claude Code den Endpunkt jedes Geltungsbereichs so, wie er in Ihrer Konfiguration geschrieben ist, mit nicht expandierten ${VAR}-Referenzen, sodass es nie einen aufgelösten Wert wie einen API-Schlüssel anzeigt.
• Reservierte Namen: Claude Code reserviert die Namen seiner integrierten Server, darunter 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 bezeichnen beide den integrierten Server, den der Vorschaubereich 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 Ausgabe von claude mcp list und in /mcp unter Nennung der Variable und lädt den Server trotzdem mit dem nicht expandierten ${VAR}-Text. Setzen Sie die Variable oder fügen Sie einen ${VAR:-default}-Fallback hinzu. In url und headers eines Remote-Servers werden einige Anmeldedaten-Variablen stattdessen ohne Warnung als leer gelesen.

Verfügbarkeit von Tools

Tool-Anzahlen in einer Cloud-Sitzung

• Eine Deny-Regel in der .claude/settings.json Ihres Repositorys nennt das Tool oder seinen gesamten Server: Entfernen Sie die Regel, sofern Ihre Sitzung diese Datei liest
• Der vollständige Name des Tools ist länger als 128 Zeichen: Folgen Sie den Schritten für einen zu langen Namen
• Der Server listet das Tool für seine eigene Oberfläche und nicht für Claude auf: Wenn Sie den Server pflegen, fügen Sie model zu _meta.ui.visibility des Tools hinzu, um Claude das Tool zu geben. Andernfalls gibt es nichts zu beheben.

Tools von einem Server, der sich noch verbindet

• Mit Tool-Suche, der Standardeinstellung: Das Warten findet innerhalb des ToolSearch-Aufrufs statt.
• Ohne Tool-Suche: Claude verwendet stattdessen das Tool WaitForMcpServers. Zu den Konfigurationen ohne Tool-Suche gehören ENABLE_TOOL_SEARCH=false und ein Modell, das älter ist als Claude Opus 4.5, Claude Sonnet 4.5 und Claude Haiku 4.5, auf der Agent Platform von Google Cloud. Für ein ANTHROPIC_BASE_URL-Gateway siehe Tool-Suche über ein LLM-Gateway.
• Bei einem Microsoft Foundry-Deployment, das auf Azure gehostet wird: Claude startet auf dem Tool-Suche-Pfad statt mit WaitForMcpServers, da Claude Code die serverseitige Ablehnung des Deployments erst über die API feststellt. Nachdem Claude Code dieses Deployment auf vorab geladene Tools umgestellt hat, werden Tools von einem Server, der seine Verbindung 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 über verwaltete Einstellungen bereitstellt, die claude.ai-Konnektoren, die Claude Code selbst abruft, sowie integrierte Server, die standardmäßig eingeschaltet sind. Claude Code verbindet sich nicht mit einem Server, den Sie hier aufführen. Wenn Sie einen claude.ai-Konnektor mit dem projektbezogenen /mcp-Schalter deaktivieren, der unter claude.ai-Konnektoren 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 ausgeschaltet sind, etwa computer-use. Claude Code verbindet sich mit einem standardmäßig ausgeschalteten Server nur, wenn Sie ihn hier aufführen.

MCP-Client-Laufzeitumgebungen

• Sitzungen auf Amazon Bedrock, Claude Platform on AWS, der Agent Platform von Google Cloud oder Microsoft Foundry, sofern nicht eine Host-Plattform, die Claude Code einbettet, CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST setzt
• Sitzungen, die über ein Claude Apps Gateway angemeldet sind
• Sitzungen, in denen Sie Telemetrie oder das Abrufen von Feature-Flags ausschalten, 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 den Servern, die dies tun. Dazu gehören die Konnektoren von Cloud- und Remote Control-Sitzungen. Mit allen anderen Servern verbindet sich Claude Code wie unter v1.
• Es empfängt list_changed-Benachrichtigungen von Servern mit der neueren Revision über einen Stream, den es offen hält.
• Es registriert keinen Channel-Server, der sich mit der neueren Revision verbindet, da diese Revision keine Channel-Nachrichten übertragen 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 unter localhost, 127.0.0.1 oder ::1 bereitgestellt wird. Die Anmeldung schlägt bei einem Server fehl, dessen Token-Endpunkt an anderer Stelle einfaches http:// ist, etwa ein Gerät in Ihrem lokalen Netzwerk. Siehe Refusing to send credentials to non-https token endpoint.

Dynamische Tool-Aktualisierungen

• In einer interaktiven Terminal-Sitzung ruft Claude Code die aktualisierte Liste von diesem Server ab, sodass Sie ihn nicht neu 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.

Benachrichtigungs-Streams in der v2-Laufzeitumgebung

• Der Stream schließt sich innerhalb von 10 Sekunden erneut: Claude Code öffnet ihn bis zu dreimal erneut und hört dann für diese Verbindung auf.
• Der Stream bleibt länger als 10 Sekunden offen und schließt sich dann, wie es bei Streams zu Serverless-Hosts häufig der Fall ist: Nach fünf erneuten Öffnungen innerhalb einer Stunde wartet Claude Code etwa sechs Stunden bis zur nächsten.

Automatische Wiederverbindung

Verbindungsabbrüche eines Remote-Servers während der Sitzung

• In einer interaktiven Sitzung: /mcp zeigt den Server als ausstehend an, während Claude Code die Verbindung wiederherstellt. Nach fünf fehlgeschlagenen Versuchen markiert Claude Code den Server als fehlgeschlagen oder als authentifizierungsbedürftig, wenn der Server eine erneute Autorisierung benötigt. Wenn es den Server als fehlgeschlagen markiert, sehen Sie eine Benachrichtigung MCP server "<name>" disconnected · open /mcp to reconnect. Sie können es über /mcp manuell erneut versuchen.
• Bei claude -p-Ausführungen und Agent SDK-Sitzungen: Claude Code unternimmt dieselben fünf Versuche, ohne ein /mcp-Panel, das sie anzeigt. Wenn alle fünf fehlschlagen, läuft die Ausführung ohne die Tools des Servers weiter:
  • Nach einem vorübergehenden Fehler, etwa einer 5xx-Antwort oder einer Zeitüberschreitung: Claude Code versucht einen HTTP- oder SSE-Server im Hintergrund weiterhin erneut. 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 neu verbinden. Um ihn in claude -p neu zu verbinden, starten Sie die Ausführung erneut.
  • Wenn der Server eine erneute Anmeldung erfordert: Claude Code stellt die Wiederholungsversuche ein, und eine Agent SDK-Sitzung meldet den Status des Servers als needs-auth. Melden Sie sich mit claude mcp login <name> in Ihrer Shell an. Starten Sie dann die Ausführung erneut oder verbinden Sie den Server in einer Agent SDK-Sitzung stattdessen neu.

Fehlgeschlagene erste Verbindungen

• Der erste Verbindungsaufbau eines stdio-Servers. Um es erneut zu versuchen, siehe Stdio-Server, die sich beenden oder nicht starten
• Der erste Verbindungsaufbau eines WebSocket-Servers. Um es in einer interaktiven Terminal-Sitzung erneut zu versuchen, wählen Sie im Menü des Servers in /mcp die Option Reconnect
• Ein Authentifizierungs- oder Not-found-Fehler, da zur Behebung eine Konfigurationsänderung nötig ist. 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 neu ausführt und so neue Anmeldedaten erhalten kann

Stdio-Server, die sich beenden oder nicht starten

Fehlgeschlagene Discovery-Anfragen

Fehlgeschlagene Server selbst erneut versuchen

Wie Claude erfährt, dass ein Server fehlgeschlagen ist

• Mit Tool-Suche teilt Claude Code Claude mit, welcher Server fehlgeschlagen ist und welchen Verbindungsfehler er hat, sodass Claude den Verbindungsfehler in seiner Antwort meldet. Claude Code fügt dieselben Informationen in ToolSearch-Ergebnisse ein, die kein passendes Tool finden.
• In jeder Konfiguration ohne Tool-Suche 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 Verschieben langer Tool-Aufrufe in den Hintergrund

• 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 in den Hintergrund auszuschalten. Mit 0 wartet Claude in einer interaktiven Sitzung außerdem auf MCP-Aufgaben
• 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, sofern CLAUDE_AUTO_BACKGROUND_TASKS nicht auf 1 gesetzt ist, da eine einmalige Ausführung enden kann, bevor das Ergebnis eintrifft

MCP-Aufgaben, die auf dem Server laufen

Eine MCP-Aufgabe stoppen oder ihr Ergebnis abrufen

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

Eine Frage einer MCP-Aufgabe beantworten

Beenden, Leeren oder Fortsetzen, während eine MCP-Aufgabe läuft

Was ein Aufruf benötigt, um zu einer MCP-Aufgabe zu werden

• Der Server unterstützt Aufgaben
• 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 mit ausgeschalteter Telemetrie oder ausgeschaltetem Abrufen von Flags
• Anthropic hat MCP-Aufgaben 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, etwa die VS Code-Erweiterung und die Desktop-App, haben keine MCP-Aufgaben
• 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 einer MCP-Aufgabe

Zeitlimits für MCP-Aufgaben

Claude auf das Ergebnis einer MCP-Aufgabe 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 einer Aufgabe. Solange das automatische Verschieben in den Hintergrund aktiviert ist, wird der Aufruf standardmäßig nach zwei Minuten verschoben, sodass kurze Aufgaben an Ort und Stelle abgeschlossen werden und lange Sie nicht blockieren. Der verschobene Aufruf ist ein einfacher Hintergrundaufruf und keine MCP-Aufgabe. Er überdauert das Beenden der Sitzung nicht

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

MCP-Aufgaben für Serverautoren

Den Aufruf mit einer Aufgabe 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 Stammverzeichnis des Plugins oder inline in plugin.json
• Wenn Sie ein Plugin aktivieren, startet Claude Code dessen MCP-Server automatisch
• Claude Code bietet Plugin-MCP-Tools neben manuell konfigurierten MCP-Tools 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 dennoch ausschalten, wodurch Claude Code keine Verbindung mehr zu ihm herstellt, ohne dass das Plugin entfernt wird

{
  "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 zu folgenden Zeitpunkten:
  • Beim Start der Sitzung verbindet Claude Code die Server aktivierter Plugins automatisch. In /mcp kann ein Remote-Plugin-Server (HTTP oder SSE), den Sie bereits verwendet haben, stattdessen den Status cached anzeigen; Claude Code verbindet ihn, wenn Claude zum ersten Mal eines seiner Tools aufruft. Wenn die Verbindung eines stdio-Plugin-Servers vor weniger als 15 Minuten fehlgeschlagen ist, überspringt Claude Code die Verbindung
  • Wenn Sie während einer Sitzung ein Plugin aktivieren oder deaktivieren, verbindet oder trennt Claude Code dessen MCP-Server, sobald die Änderung wirksam wird. Wann das der Fall ist, beschreibt Plugin-Änderungen ohne Neustart anwenden. In einer Sitzung ohne interaktives Terminal verbindet oder trennt /reload-plugins keine Plugin-MCP-Server; diese Änderungen werden in Ihrer nächsten Sitzung wirksam
  • Beim Neuladen behält Claude Code die aktiven Verbindungen von Plugin-Servern bei, deren Konfiguration unverändert ist, und verfährt ebenso, wenn Sie die MCP-Serverliste der Sitzung ersetzen, ohne diese Server über das Agent SDK zu benennen
  • Wenn Sie ab v2.1.246 die Sitzung mit /cd verschieben, verbindet Claude Code die Server der Plugins, die durch die Einstellungen des neuen Verzeichnisses aktiviert werden, und trennt die Server der Plugins, die nicht mehr aktiviert sind, sodass Sie nach dem Verschieben nicht /reload-plugins ausführen müssen
  • In Cloud-Sitzungen startet ein MCP-Aufruf an einen noch nicht verbundenen Plugin-Server, etwa direkt nach dem Aufwachen einer inaktiven Sitzung, den Server bei Bedarf und wartet, bis er verbunden ist
• Pfad-Platzhalter: ${CLAUDE_PLUGIN_ROOT} wird zum Installationsverzeichnis des Plugins aufgelöst, ${CLAUDE_PLUGIN_DATA} zu dessen Verzeichnis für persistenten Zustand und ${CLAUDE_PROJECT_DIR} zum stabilen Projektstammverzeichnis. Die Ersetzung gilt für:
  • stdio-Server: command, args, env
  • http-, sse- und ws-Server: url, headers und headersHelper
• Zugriff auf die Benutzerumgebung: Zugriff auf dieselben Umgebungsvariablen wie bei manuell konfigurierten Servern
• Mehrere Transportarten: Unterstützung für stdio-, SSE-, HTTP- und WebSocket-Transporte, wobei die Transportunterstützung je nach Server variieren kann

• stdio-Server: Ausgegeben werden Command: stdio, eine leere Args:-Zeile und jede Umgebungsvariable als NAME=[REDACTED]
• WebSocket-Server: Ausgegeben werden URL: ws und jeder Header als <name>: [REDACTED], 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.

• Ihre gespeicherte Anmeldung hat ein Refresh-Token: Claude Code aktualisiert das Token, verbindet sich erneut und wiederholt die Anfrage einmal. Der Server wird in /mcp nur gekennzeichnet, wenn dieser Wiederholungsversuch auch fehlschlägt.
• Ihre gespeicherte Anmeldung hat kein Refresh-Token: Claude Code verbindet sich einmal ohne das Token. Wenn der Server antwortet, funktionieren seine Tools, während Sie abgemeldet sind, und das abgelehnte Token wird gelöscht. Wenn der Server auch diese Verbindung ablehnt, zeigt /mcp an, dass der Server Authentifizierung benötigt.

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.

Eine Elicitierungsanfrage in einer Cloud-Sitzung beantworten

• Formularmodus: Füllen Sie die Felder aus und klicken Sie dann auf Submit
• URL-Modus: Klicken Sie auf Open link, schließen Sie den dadurch geöffneten Ablauf ab und klicken Sie dann auf der Karte auf I’m done, continue

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