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 Authentifizierungs-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

# 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

​

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.

​

Aus einer URL

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

​

Aus einem npx-, uvx- oder Binary-Befehl

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

​

Aus einem mcpServers-JSON-Block

• 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"]}'

​

Verwalten Ihrer Server

# 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 projektgesteuerten 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>. Führen Sie claude interaktiv aus, um ihn zu überprü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 benennt. 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. Vor v2.1.238 verbanden sich beide Befehle mit einem deaktivierten Server, um ihn zu überprüfen, und meldeten das Verbindungsergebnis.

​

Genehmigungen von Projektservern und Workspace-Vertrauen

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

​

Serverstatus-Detail

• Reconnect: Bei einem cached-Server verbindet Claude Code ihn jetzt statt beim ersten Tool-Aufruf und behält den Eintrag. Bei einem verbundenen oder fehlgeschlagenen Server verbindet Claude Code ihn erneut und verwirft auch den Eintrag.
• Clear authentication: Claude Code widerruft die Authentifizierung des Servers und verwirft auch den Eintrag.

• Der Pfad und die Abfrage erscheinen niemals in dieser Nachricht.
• Für einen Server im lokalen, Projekt- oder Benutzer-Bereich oder in verwalteter MCP-Konfiguration zeigt der Ursprung den Host, wie er in dieser Konfiguration geschrieben ist, daher wird eine ${VAR}-Referenz im Host nicht in der Nachricht 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 benennt die betroffenen Felder, ohne ihre Werte zu wiederholen, zum Beispiel Leading or trailing whitespace in: headers.Authorization. Claude Code trimmt das Leerzeichen nicht und verwendet die Werte genau wie geschrieben, daher bearbeiten Sie die Konfiguration, um es zu entfernen.
• Gleicher Name in mehr als einem Bereich: Wenn Sie den gleichen 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, immer noch separat in einem Projekt anmelden, in dem eine andere Definition geladen wird. 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 er in Ihrer Konfiguration geschrieben ist, 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 der Claude Code Desktop-App-Vorschaubereich verwendet. Vor v2.1.205 war Claude Browser nicht reserviert, daher konnte ein benutzerkonfigurierter Server sich unter diesem Namen registrieren.
• Fehlende Umgebungsvariable: Wenn eine ${VAR}-Referenz in der Konfiguration eines Servers eine Variable benennt, die nicht gesetzt ist und keinen :-default hat, warnt Claude Code in der claude mcp list-Ausgabe und in /mcp, benennt 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.

​

Tool-Verfügbarkeit

• Mit Tool-Suche, der Standardeinstellung: Das Warten erfolgt innerhalb des ToolSearch-Aufrufs.
• Ohne Tool-Suche: Claude verwendet stattdessen das WaitForMcpServers-Tool. Konfigurationen ohne Tool-Suche enthalten eine benutzerdefinierte ANTHROPIC_BASE_URL, ENABLE_TOOL_SEARCH=false und ein Modell früher als die Claude 4.5-Generation auf Google Cloud’s Agent Platform.
• Bei einer Microsoft Foundry-Bereitstellung auf Azure gehostet: Claude startet auf dem Tool-Suche-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 Tools von einem Server, der die Verbindung beendet, 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-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 in diese Liste unter seinem Anzeigenamen, 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

• Auf Amazon Bedrock, Claude Platform auf AWS, Google Cloud’s Agent Platform oder Microsoft Foundry, es sei denn, eine Host-Plattform, die Claude Code einbettet, setzt CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Angemeldet über ein Claude-Apps-Gateway
• Mit Feature-Flag-Abruf deaktiviert

• Fragt HTTP- und claude.ai-Connector-Server, ob sie die neuere Revision unterstützen, und verwendet sie mit denen, die das tun. Es fragt Stdio-Server nur, wenn Sie MCP_PROTOCOL_NEGOTIATION auf auto setzen, und verbindet sich mit jedem anderen Server wie v1.
• Empfängt list_changed-Benachrichtigungen von Servern auf der neueren Revision über einen Stream, den es offen hält.
• Registriert keinen Kanal-Server, der sich auf der neueren Revision verbindet, da diese Revision keine Kanal-Nachrichten tragen kann.
• Schlägt eine MCP-OAuth-Anmeldung fehl, deren Autorisierungsantwort einen unerwarteten Aussteller benennt.

​

Dynamische Tool-Updates

​

Benachrichtigungs-Streams 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, dann schließt, wie 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

​

Verbindungstrennung eines Remote-Servers während einer Sitzung

• 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. Sie können manuell von /mcp aus erneut versuchen.
• In claude -p-Läufen und Agent SDK-Sitzungen: Claude Code verbindet sich nach dem gleichen Zeitplan erneut, ohne /mcp-Panel, um die Versuche anzuzeigen.

​

Fehlgeschlagene erste Verbindungen

• Eine WebSocket-Server-Verbindung
• Ein Authentifizierungs- oder Not-Found-Fehler, da er eine Konfigurationsänderung erfordert, um behoben zu werden. Wenn ein headersHelper die einzige Quelle des Authorization-Headers des Servers ist, versucht Claude Code einen Authentifizierungsfehler trotzdem erneut, da er den Helper bei jedem Versuch erneut ausführt und eine frische Anmeldedaten abholen kann

​

Fehlgeschlagene Discovery-Anfragen

​

Wie Claude erfährt, dass ein Server fehlgeschlagen ist

• Mit Tool-Suche teilt Claude Code Claude mit, welcher Server fehlgeschlagen ist und sein Verbindungsfehler, daher meldet Claude den Verbindungsfehler in seiner Antwort. Claude Code enthält die gleichen Informationen in ToolSearch-Ergebnissen, die kein passendes Tool finden.
• In jeder Konfiguration ohne Tool-Suche meldet Claude Code fehlgeschlagene Server-Verbindungen nicht an Claude.

​

Push-Nachrichten mit Kanälen

​

Automatisches Backgrounding von langen Tool-Aufrufen

• Aufrufe von Subagenten; Claude Code verschiebt nur Hauptkonversations-Aufrufe
• 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

​

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, starten seine MCP-Server automatisch
• Claude Code bietet Plugin-MCP-Tools neben manuell konfigurierten MCP-Tools an
• Sie fügen Plugin-Server hinzu und entfernen sie durch Installation oder Deinstallation des Plugins, nicht mit /mcp-Befehlen. Sie können einen installierten Plugin-Server immer noch ohne Entfernung ausschalten in /mcp, 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, den cached-Status statt anzeigen; Claude Code verbindet ihn, wenn Claude eines seiner Tools zum ersten Mal aufruft
  • Wenn Sie ein Plugin während einer Sitzung aktivieren oder deaktivieren, verbindet Claude Code seine MCP-Server oder trennt sie, 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 Plugin-MCP-Server nicht; 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 das gleiche, wenn Sie die MCP-Server-Liste der Sitzung vom Agent SDK ersetzen, ohne sie zu benennen
  • Wenn Sie die Sitzung mit /cd in ein anderes Verzeichnis verschieben bei v2.1.246 oder später, 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 Web-Sitzungen startet ein MCP-Aufruf an einen Plugin-Server, der noch nicht verbunden ist, wie direkt nach einer Idle-Sitzung, die aufwacht, den Server bei Bedarf und wartet auf die Verbindung
• Pfad-Platzhalter: ${CLAUDE_PLUGIN_ROOT} wird in das Installationsverzeichnis des Plugins aufgelöst, ${CLAUDE_PLUGIN_DATA} in sein persistentes Zustandsverzeichnis, und ${CLAUDE_PROJECT_DIR} in das stabile Projektstammverzeichnis. Die Substitution gilt für:
  • stdio-Server: command, args, env
  • http-, sse- und ws-Server: url, headers und headersHelper. Vor v2.1.195 übergab headersHelper den Platzhalter als Literal-String
• Zugriff auf Benutzerumgebung: Zugriff auf die gleichen Umgebungsvariablen wie manuell konfigurierte Server
• Mehrere Transporttypen: Unterstützung für Stdio-, SSE-, HTTP- und WebSocket-Transporte, wobei die Transportunterstützung je nach Server variieren kann

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}: erweitert sich zu VAR, wenn gesetzt, andernfalls wird default verwendet

• command: der Server-Ausführungspfad
• args: Befehlszeilenargumente
• env: Umgebungsvariablen, die an den Server übergeben werden
• url: für HTTP-Server-Typen
• headers: für HTTP-Server-Authentifizierung

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

​

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-Connector kennzeichnet ein 401, das durch die Ablehnung Ihres Sitzungs-Tokens durch claude.ai verursacht wird, den Connector nicht, da eine erneute Autorisierung des Connectors 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.
• Für einen Connector, der an eine Cloud-Sitzung übermittelt wird, führt Claude Code keinen Anmeldungsfluss aus, da die Proxy der Sitzung sich beim Connector mit der Autorisierung authentifiziert, die Sie in claude.ai gewährt haben. Wenn ein Connector 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-Bereiche

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

​

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 gibt ihn nach 10 Sekunden auf
• Claude Code wählt das Arbeitsverzeichnis des Befehls nach wo Sie den Server konfiguriert haben, daher geben Sie das Skript als absoluten Pfad an oder setzen Sie es auf 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, und ein Inline-Server in einer Agent-Datei aus Ihrem Projekt oder aus einem --add-dir-Verzeichnis
• Nicht entfernt: ein Server bei User Scope oder Local Scope, in verwaltetes MCP, von einem claude.ai-Connector, oder bereitgestellt von der SDK oder --mcp-config, und 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 den Ordner vertrauen: Claude Code verbindet den Server nur mit seinen statischen headers. In einer claude -p- oder SDK-Sitzung druckt es auch eine headersHelper not run-Zeile pro Server auf stderr, die Ihnen sagt, wie Sie das Vertrauen gewähren.
• Vertrauen ohne Dialog: setzen Sie projects["<path>"].hasTrustDialogAccepted auf true in ~/.claude.json. <path> ist der Ordner, auf den Project allow rules and workspace trust sagt, dass Claude Code das Vertrauen basiert.

​

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 Verbundfariablen 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 Connector erneut von /mcp.

​

Wie Connectors Claude Code erreichen

• Cloud-Sitzungen: allowedMcpServers- und deniedMcpServers-Einträge, die die Sitzung erreichen, beispielsweise durch Server-verwaltete Einstellungen, filtern auch die bereitgestellten Connectors. Der Proxy der Sitzung schreibt die URL jedes Connectors um, daher passt ein serverUrl-Muster, das für die eigene URL des Connectors geschrieben wurde, nicht dazu. Um bereitgestellte Connectors neben einer URL-Allowlist in einer selbstgehosteten Umgebung zuzulassen, fügen Sie die serverUrl-Einträge hinzu, die unter Connector-Datenverkehr verlässt Ihr Netzwerk aufgelistet sind. Claude Code verwirft die bereitgestellten Connectors, 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.
• Desktop-App lokale und SSH-Sitzungen: Die Desktop-App registriert die Connectors als prozessinterne type: "sdk"-Server, und keine MCP-Einstellung oder managed-mcp.json erreicht sie. Ein Benutzer hält einen Connector aus seinen eigenen Sitzungen heraus, indem er ihn unter claude.ai/customize/connectors trennt. Eine Organisation blockiert die Tools eines Connectors oder schaltet Claude Code in der Desktop-App ganz aus.

​

Organisationskontrollen für Connector-Tools

• Tool auf ask gesetzt: Claude Code fragt bei jedem Aufruf mit dem Grund Your organization requires approval for this tool nach. Die Aufforderung wird auch in acceptEdits-, auto- und bypassPermissions-Berechtigungsmodi angezeigt und bietet niemals eine Option, Ihre Wahl zu merken. Allow-Regeln, die das Tool abgleichen, überspringen die Aufforderung auch nicht. Im dontAsk-Modus, der niemals fragt, 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 der Tool-Liste angezeigt. Die Desktop-App und der claude.ai-Chat wenden die gleiche blocked-Einstellung an, daher kann Claude das Tool dort auch nicht verwenden, und Sie können ein Tool nicht von den Sitzungen der Desktop-App fernhalten, während Sie es im Chat verfügbar halten. Die Desktop-App überspringt einen Connector, dessen Tools alle blockiert sind.

​

claude.ai-Connectors 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": {}
    }
  }
}

​

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 Ergebnis ohne Bildinhalt die Begrenzung überschreitet, speichert Claude Code es in einer Datei und ersetzt es im Gespräch 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/.

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
  }
}

​

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

​

Genehmigung für ein bestimmtes Tool erforderlich

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": 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 öffnet eine Browser-URL für Authentifizierung oder Genehmigung. Schließen Sie den Ablauf im Browser ab und bestätigen Sie dann in der CLI.

​

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

​

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

​

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"]
  }
}

​

Einen Server vom Aufschub ausnehmen

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

​

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