Model Context Protocol (MCP) ist ein offenes Protokoll, das LLMs den Zugriff auf externe Tools und Datenquellen ermöglicht. Für weitere Details zu MCP siehe die MCP-Dokumentation.

Verwenden Sie MCP-Server von Drittanbietern auf eigenes Risiko. Stellen Sie sicher, dass Sie den MCP-Servern vertrauen, und seien Sie besonders vorsichtig bei der Verwendung von MCP-Servern, die mit dem Internet kommunizieren, da diese Sie Prompt-Injection-Risiken aussetzen können.

​
MCP-Server konfigurieren

1

Einen MCP stdio Server hinzufügen

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

# Beispiel: Einen lokalen Server hinzufügen
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

Einen MCP SSE Server hinzufügen

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

# Beispiel: Einen SSE-Server hinzufügen
claude mcp add --transport sse sse-server https://example.com/sse-endpoint

# Beispiel: Einen SSE-Server mit benutzerdefinierten Headern hinzufügen
claude mcp add --transport sse api-server https://api.example.com/mcp -e X-API-Key=your-key
3

Einen MCP HTTP Server hinzufügen

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

# Beispiel: Einen streamfähigen HTTP-Server hinzufügen
claude mcp add --transport http http-server https://example.com/mcp

# Beispiel: Einen HTTP-Server mit Authentifizierungs-Header hinzufügen
claude mcp add --transport http secure-server https://api.example.com/mcp -e Authorization="Bearer your-token"
4

Ihre MCP-Server verwalten

# Alle konfigurierten Server auflisten
claude mcp list

# Details für einen bestimmten Server abrufen
claude mcp get my-server

# Einen Server entfernen
claude mcp remove my-server

Tipps:

  • Verwenden Sie das -s oder --scope Flag, um anzugeben, wo die Konfiguration gespeichert wird:
    • local (Standard): Nur für Sie im aktuellen Projekt verfügbar (wurde in älteren Versionen project genannt)
    • project: Für alle im Projekt über die .mcp.json Datei geteilt
    • user: Für Sie in allen Projekten verfügbar (wurde in älteren Versionen global genannt)
  • Setzen Sie Umgebungsvariablen mit -e oder --env Flags (z.B. -e KEY=value)
  • Konfigurieren Sie das MCP-Server-Startup-Timeout mit der MCP_TIMEOUT Umgebungsvariable (z.B. MCP_TIMEOUT=10000 claude setzt ein 10-Sekunden-Timeout)
  • Überprüfen Sie den MCP-Server-Status jederzeit mit dem /mcp Befehl in Claude Code
  • MCP folgt einer Client-Server-Architektur, bei der Claude Code (der Client) sich mit mehreren spezialisierten Servern verbinden kann
  • Claude Code unterstützt SSE (Server-Sent Events) und streamfähige HTTP-Server für Echtzeitkommunikation
  • Verwenden Sie /mcp zur Authentifizierung mit Remote-Servern, die OAuth 2.0-Authentifizierung erfordern

​
MCP-Server-Bereiche verstehen

MCP-Server können auf drei verschiedenen Bereichsebenen konfiguriert werden, die jeweils unterschiedliche Zwecke für die Verwaltung der Server-Zugänglichkeit und -Freigabe erfüllen. Das Verständnis dieser Bereiche hilft Ihnen dabei, die beste Art der Server-Konfiguration für Ihre spezifischen Bedürfnisse zu bestimmen.

​
Bereichshierarchie und Vorrang

MCP-Server-Konfigurationen folgen einer klaren Vorranghierarchie. Wenn Server mit demselben Namen in mehreren Bereichen existieren, löst das System Konflikte auf, indem es zuerst lokal-bereichsbezogene Server priorisiert, gefolgt von projekt-bereichsbezogenen Servern und schließlich benutzer-bereichsbezogenen Servern. Dieses Design stellt sicher, dass persönliche Konfigurationen bei Bedarf geteilte überschreiben können.

​
Lokaler Bereich

Lokal-bereichsbezogene Server stellen die Standard-Konfigurationsebene dar und werden in Ihren projektspezifischen Benutzereinstellungen gespeichert. Diese Server bleiben privat für Sie und sind nur beim Arbeiten im aktuellen Projektverzeichnis zugänglich. Dieser Bereich ist ideal für persönliche Entwicklungsserver, experimentelle Konfigurationen oder Server mit sensiblen Anmeldedaten, die nicht geteilt werden sollten.

# Einen lokal-bereichsbezogenen Server hinzufügen (Standard)
claude mcp add my-private-server /path/to/server

# Explizit lokalen Bereich angeben
claude mcp add my-private-server -s local /path/to/server

​
Projektbereich

Projekt-bereichsbezogene Server ermöglichen Teamzusammenarbeit, indem sie Konfigurationen in einer .mcp.json Datei im Stammverzeichnis Ihres Projekts speichern. Diese Datei ist dafür konzipiert, in die Versionskontrolle eingecheckt zu werden, um sicherzustellen, dass alle Teammitglieder Zugriff auf dieselben MCP-Tools und -Dienste haben. Wenn Sie einen projekt-bereichsbezogenen Server hinzufügen, erstellt oder aktualisiert Claude Code automatisch diese Datei mit der entsprechenden Konfigurationsstruktur.

# Einen projekt-bereichsbezogenen Server hinzufügen
claude mcp add shared-server -s project /path/to/server

Die resultierende .mcp.json Datei folgt einem standardisierten Format:

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

Aus Sicherheitsgründen fordert Claude Code eine Genehmigung an, bevor projekt-bereichsbezogene Server aus .mcp.json Dateien verwendet werden. Wenn Sie diese Genehmigungsauswahlen zurücksetzen müssen, verwenden Sie den claude mcp reset-project-choices Befehl.

​
Benutzerbereich

Benutzer-bereichsbezogene Server bieten projektübergreifende Zugänglichkeit und machen sie in allen Projekten auf Ihrem Computer verfügbar, während sie privat für Ihr Benutzerkonto bleiben. Dieser Bereich funktioniert gut für persönliche Utility-Server, Entwicklungstools oder Dienste, die Sie häufig in verschiedenen Projekten verwenden.

# Einen Benutzer-Server hinzufügen
claude mcp add my-user-server -s user /path/to/server

​
Den richtigen Bereich wählen

Wählen Sie Ihren Bereich basierend auf:

  • Lokaler Bereich: Persönliche Server, experimentelle Konfigurationen oder sensible Anmeldedaten spezifisch für ein Projekt
  • Projektbereich: Team-geteilte Server, projektspezifische Tools oder für die Zusammenarbeit erforderliche Dienste
  • Benutzerbereich: Persönliche Utilities, die in mehreren Projekten benötigt werden, Entwicklungstools oder häufig verwendete Dienste

​
Mit Remote-MCP-Servern authentifizieren

Viele Remote-MCP-Server erfordern eine Authentifizierung. Claude Code unterstützt OAuth 2.0-Authentifizierungsflow für sichere Verbindungen zu diesen Servern.

1

Einen Remote-Server hinzufügen, der Authentifizierung erfordert

# Einen SSE- oder HTTP-Server hinzufügen, der OAuth erfordert
claude mcp add --transport sse github-server https://api.github.com/mcp
2

Mit dem /mcp Befehl authentifizieren

Verwenden Sie in Claude Code den /mcp Befehl zur Verwaltung der Authentifizierung:

> /mcp

Dies öffnet ein interaktives Menü, in dem Sie können:

  • Verbindungsstatus für alle Server anzeigen
  • Mit Servern authentifizieren, die OAuth erfordern
  • Bestehende Authentifizierung löschen
  • Server-Fähigkeiten anzeigen
3

Den OAuth-Flow abschließen

Wenn Sie “Authentifizieren” für einen Server auswählen:

  1. Ihr Browser öffnet sich automatisch zum OAuth-Anbieter
  2. Schließen Sie die Authentifizierung in Ihrem Browser ab
  3. Claude Code empfängt und speichert das Zugriffstoken sicher
  4. Die Server-Verbindung wird aktiv

Tipps:

  • Authentifizierungstoken werden sicher gespeichert und automatisch aktualisiert
  • Verwenden Sie “Authentifizierung löschen” im /mcp Menü, um den Zugriff zu widerrufen
  • Wenn sich Ihr Browser nicht automatisch öffnet, kopieren Sie die bereitgestellte URL
  • OAuth-Authentifizierung funktioniert sowohl mit SSE- als auch HTTP-Transporten

​
Mit einem Postgres MCP-Server verbinden

Angenommen, Sie möchten Claude schreibgeschützten Zugriff auf eine PostgreSQL-Datenbank für Abfragen und Schema-Inspektion geben.

1

Den Postgres MCP-Server hinzufügen

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

Ihre Datenbank mit Claude abfragen

> beschreibe das Schema unserer Benutzertabelle

> was sind die neuesten Bestellungen im System?

> zeige mir die Beziehung zwischen Kunden und Rechnungen

Tipps:

  • Der Postgres MCP-Server bietet aus Sicherheitsgründen nur schreibgeschützten Zugriff
  • Claude kann Ihnen helfen, Datenbankstrukturen zu erkunden und analytische Abfragen auszuführen
  • Sie können dies verwenden, um Datenbankschemas in unbekannten Projekten schnell zu verstehen
  • Stellen Sie sicher, dass Ihr Verbindungsstring angemessene Anmeldedaten mit minimal erforderlichen Berechtigungen verwendet

​
MCP-Server aus JSON-Konfiguration hinzufügen

Angenommen, Sie haben eine JSON-Konfiguration für einen einzelnen MCP-Server, den Sie zu Claude Code hinzufügen möchten.

1

Einen MCP-Server aus JSON hinzufügen

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

# Beispiel: Einen stdio-Server mit JSON-Konfiguration hinzufügen
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

Überprüfen, dass der Server hinzugefügt wurde

claude mcp get weather-api

Tipps:

  • Stellen Sie sicher, dass das JSON in Ihrer Shell ordnungsgemäß escaped ist
  • Das JSON muss dem MCP-Server-Konfigurationsschema entsprechen
  • Sie können -s global verwenden, um den Server zu Ihrer globalen Konfiguration anstatt zur projektspezifischen hinzuzufügen

​
MCP-Server aus Claude Desktop importieren

Angenommen, Sie haben bereits MCP-Server in Claude Desktop konfiguriert und möchten dieselben Server in Claude Code verwenden, ohne sie manuell neu zu konfigurieren.

1

Server aus Claude Desktop importieren

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

Auswählen, welche Server importiert werden sollen

Nach dem Ausführen des Befehls sehen Sie einen interaktiven Dialog, der es Ihnen ermöglicht, auszuwählen, welche Server Sie importieren möchten.

3

Überprüfen, dass die Server importiert wurden

claude mcp list

Tipps:

  • Diese Funktion funktioniert nur auf macOS und Windows Subsystem for Linux (WSL)
  • Sie liest die Claude Desktop-Konfigurationsdatei von ihrem Standardort auf diesen Plattformen
  • Verwenden Sie das -s global Flag, um Server zu Ihrer globalen Konfiguration hinzuzufügen
  • Importierte Server haben dieselben Namen wie in Claude Desktop
  • Wenn Server mit denselben Namen bereits existieren, erhalten sie ein numerisches Suffix (z.B. server_1)

​
Claude Code als MCP-Server verwenden

Angenommen, Sie möchten Claude Code selbst als MCP-Server verwenden, mit dem sich andere Anwendungen verbinden können, um ihnen Claudes Tools und Fähigkeiten zur Verfügung zu stellen.

1

Claude als MCP-Server starten

# Grundlegende Syntax
claude mcp serve
2

Von einer anderen Anwendung aus verbinden

Sie können sich von jedem MCP-Client aus mit dem Claude Code MCP-Server verbinden, wie z.B. Claude Desktop. Wenn Sie Claude Desktop verwenden, können Sie den Claude Code MCP-Server mit dieser Konfiguration hinzufügen:

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Tipps:

  • Der Server bietet Zugriff auf Claudes Tools wie View, Edit, LS usw.
  • Versuchen Sie in Claude Desktop, Claude zu bitten, Dateien in einem Verzeichnis zu lesen, Bearbeitungen vorzunehmen und mehr.
  • Beachten Sie, dass dieser MCP-Server einfach Claudes Code-Tools für Ihren MCP-Client bereitstellt, sodass Ihr eigener Client für die Implementierung der Benutzerbestätigung für einzelne Tool-Aufrufe verantwortlich ist.

​
MCP-Ressourcen verwenden

MCP-Server können Ressourcen bereitstellen, auf die Sie mit @-Erwähnungen verweisen können, ähnlich wie Sie auf Dateien verweisen.

​
MCP-Ressourcen referenzieren

1

Verfügbare Ressourcen auflisten

Geben Sie @ in Ihren Prompt ein, um verfügbare Ressourcen von allen verbundenen MCP-Servern zu sehen. Ressourcen erscheinen neben Dateien im Autocomplete-Menü.

2

Eine spezifische Ressource referenzieren

Verwenden Sie das Format @server:protocol://resource/path, um auf eine Ressource zu verweisen:

> Können Sie @github:issue://123 analysieren und eine Lösung vorschlagen?

> Bitte überprüfen Sie die API-Dokumentation unter @docs:file://api/authentication
3

Mehrere Ressourcenreferenzen

Sie können mehrere Ressourcen in einem einzigen Prompt referenzieren:

> Vergleichen Sie @postgres:schema://users mit @docs:file://database/user-model

Tipps:

  • Ressourcen werden automatisch abgerufen und als Anhänge eingefügt, wenn sie referenziert werden
  • Ressourcenpfade sind fuzzy-suchbar in der @-Erwähnungs-Autocomplete
  • Claude Code stellt automatisch Tools zum Auflisten und Lesen von MCP-Ressourcen bereit, wenn Server diese unterstützen
  • Ressourcen können jeden Inhaltstyp enthalten, den der MCP-Server bereitstellt (Text, JSON, strukturierte Daten usw.)

​
MCP-Prompts als Slash-Befehle verwenden

MCP-Server können Prompts bereitstellen, die als Slash-Befehle in Claude Code verfügbar werden.

​
MCP-Prompts ausführen

1

Verfügbare Prompts entdecken

Geben Sie / ein, um alle verfügbaren Befehle zu sehen, einschließlich derer von MCP-Servern. MCP-Prompts erscheinen mit dem Format /mcp__servername__promptname.

2

Einen Prompt ohne Argumente ausführen

> /mcp__github__list_prs
3

Einen Prompt mit Argumenten ausführen

Viele Prompts akzeptieren Argumente. Übergeben Sie sie durch Leerzeichen getrennt nach dem Befehl:

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug im Login-Flow" high

Tipps:

  • MCP-Prompts werden dynamisch von verbundenen Servern entdeckt
  • Argumente werden basierend auf den definierten Parametern des Prompts geparst
  • Prompt-Ergebnisse werden direkt in die Unterhaltung eingefügt
  • Server- und Prompt-Namen werden normalisiert (Leerzeichen werden zu Unterstrichen)