MCP in Claude Code einrichten

Was MCP dir in Claude Code bringt

Verbinde einen Server, wenn du dich dabei ertappst, Daten aus einem anderen Tool in den Chat zu kopieren, etwa einem Issue-Tracker, einer Datenbank oder einem Monitoring-Dashboard. Einmal verbunden, kann Claude dieses System direkt lesen und darauf handeln. Ein MCP Server stellt Tools (Aktionen, die der Agent ausführen kann), Resources (read-only Daten, die er abrufen kann) und Prompts (wiederverwendbare Templates) bereit, und weil MCP ein gemeinsamer Standard ist, wird eine Integration einmal pro Tool geschrieben und funktioniert über jeden MCP-fähigen Client. Deshalb breitete sich die Unterstützung so schnell aus und deshalb gibt es jetzt einen MCP Server für fast alles, was du verbinden möchtest.

• Aus einem Issue-Tracker implementieren: "Bau das in JIRA ENG-4521 beschriebene Feature und öffne einen PR."
• Eine Datenbank direkt abfragen, statt Zeilen in den Chat zu kopieren.
• Designs, Monitoring-Daten und andere Services integrieren, die der Agent sonst nicht sehen könnte.
• Tools, Resources und Prompts: auszuführende Aktionen, lesbare Daten, wiederverwendbare Templates.

Einen Server mit claude mcp add hinzufügen

Der schnellste Weg, einen Server zu verbinden, ist der Befehl claude mcp add. Es gibt drei Transports. HTTP ist die empfohlene Wahl für entfernte, Cloud-basierte Server. Stdio führt einen Server als lokalen Prozess auf deiner Maschine aus, ideal für Tools, die direkten Systemzugriff brauchen. SSE existiert ebenfalls, ist aber zugunsten von HTTP deprecated. Bei stdio-Servern trennt der doppelte Bindestrich die eigenen Optionen von Claude vom Befehl, der den Server startet, und alles danach wird unverändert an den Server übergeben.

# Remote HTTP server (recommended for cloud services)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# HTTP server with a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server (note the -- before the command)
claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server

Einen Scope wählen

Das --scope-Flag entscheidet, wer den Server nutzen kann und wo die Config gespeichert wird. Local (der Standard) hält ihn auf dich im aktuellen Projekt beschränkt. Project teilt ihn mit allen über eine committete .mcp.json-Datei in der Repo-Wurzel, also ist ein project-scoped Server die richtige Wahl für Verbindungen, die dein ganzes Team braucht. User macht ihn über all deine Projekte verfügbar. Server, die Credentials brauchen, sollten sie über Umgebungsvariablen (das --env-Flag) bekommen, nie als hartkodierte Keys, sodass dieselbe .env-Disziplin gilt und Secrets aus der committeten Config bleiben.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Project-scoped Server aus .mcp.json werden nicht automatisch vertraut: Sie erscheinen als "pending approval", bis du sie prüfst und freigibst, wenn du Claude interaktiv ausführst, was dich davor schützt, untrusted Server-Code auszuführen, den ein Teamkollege hinzugefügt hat.

Verifizieren und authentifizieren

Nachdem du einen Server hinzugefügt hast, bestätige, dass er funktioniert. Aus der Shell zeigt "claude mcp list" alle konfigurierten Server und ihren Status, "claude mcp get <name>" zeigt Details zu einem, und "claude mcp remove <name>" löscht ihn. Innerhalb einer Claude-Code-Session zeigt das /mcp-Panel jeden verbundenen Server, seine Tool-Anzahl, und lässt dich mit Servern authentifizieren, die OAuth 2.0 verlangen, indem es dich durch den Browser-Login führt. Wenn eine Anfrage einen Server braucht, der noch verbindet, wartet Claude auf ihn, bevor er weitermacht.

# List all configured servers and their status
claude mcp list

# Details for one server
claude mcp get notion

# Remove a server
claude mcp remove notion

# Inside a session: check status and authenticate (OAuth)
/mcp

Gängige Server und bewusst verbinden

Gute erste Verbindungen sind der Filesystem-Server (auf einen Ordner begrenzt), der Playwright-Server (damit der Agent einen echten Browser steuern kann) und ein Datenbank-Server für deinen Stack. Aber verbinde bewusst: Jeder Server fügt seine Tool-Definitionen zu deinem Context Window hinzu, also hat jeder reale, laufende Kosten. Ein MCP Server ist ausserdem Drittanbieter-Code mit Zugriff auf deine Systeme, also prüfe, was du verbindest, genau wie eine Abhängigkeit. Oft erledigt ein CLI-Tool, das du schon hast und in deiner CLAUDE.md benennst, den Job mit weniger Overhead als ein dedizierter Server. Drei Server, die du nutzt, schlagen fünfzehn, die deinen Kontext aufblähen.

Schritt für Schritt

1. 01

   Einen Server zum Verbinden wählen

   Entscheide, was der Agent erreichen muss, das er aktuell nicht kann, etwa eine Datenbank, einen Browser oder einen Issue-Tracker, und finde seinen MCP Server (HTTP für Cloud-Services, stdio für lokale Tools).

2. 02

   Mit claude mcp add hinzufügen

   Führe claude mcp add mit dem richtigen Transport aus: --transport http <name> <url> für entfernt oder --transport stdio <name> -- <command> für lokal. Übergib Credentials mit --env, nie hartkodiert.

3. 03

   Den Scope wählen

   Nutze --scope project, um über eine committete .mcp.json zu teilen, --scope user für all deine eigenen Projekte, oder lass den Standard-Scope local für nur dieses Projekt. Gib ausstehende Project-Server frei, wenn du dazu aufgefordert wirst.

4. 04

   Die Verbindung verifizieren

   Führe "claude mcp list" aus, um den Server und seinen Status zu bestätigen, und öffne dann /mcp in einer Session, um seine Tool-Anzahl zu sehen und per OAuth zu authentifizieren, falls der Server es verlangt.

5. 05

   Nutzen, und prunen, was du nicht brauchst

   Bitte den Agenten, die Tools des Servers zu nutzen. Entferne Server, die du nicht nutzt, mit "claude mcp remove", damit dein Kontext schlank bleibt, und bevorzuge ein in CLAUDE.md benanntes CLI, wenn eines den Job tun würde.

Häufige Fragen

Weiterlernen