Claude Code MCP: Server hinzufügen und wo die Konfiguration liegt

So fügst du einen MCP-Server zu Claude Code hinzu

1. Wähle den Transport

   Nimm HTTP für entfernte, in der Cloud gehostete Server; das ist der empfohlene Transport, und Claude Code weicht auf den veralteten SSE-Transport aus, wenn ein Server nur diesen anbietet. Nimm stdio für Server, die als lokaler Prozess laufen. Bei stdio wird alles nach -- unverändert an den Server weitergegeben.

   # Remote-HTTP-Server (empfohlen für Cloud-Dienste)
   claude mcp add --transport http notion https://mcp.notion.com/mcp
   
   # Mit Bearer-Token
   claude mcp add --transport http secure-api https://api.example.com/mcp \
     --header "Authorization: Bearer your-token"
   
   # Lokaler stdio-Server: alles nach -- ist der eigene Befehl des Servers
   claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
     -- npx -y airtable-mcp-server

2. Wähle einen Scope

   Ohne --scope ist ein Server lokal: nur für dich, nur in diesem Projekt. Mit --scope project landet er für das Team in .mcp.json, mit --scope user gilt er für alle deine Projekte. Siehe die Tabelle unten.

3. Melde dich an, falls der Server das verlangt

   Viele Remote-Server nutzen OAuth. Führe in Claude Code /mcp aus und wähle den Server zur Anmeldung, oder claude mcp login <name> in deiner Shell. Headless-Läufe mit -p können den Anmeldeablauf nicht öffnen, melde dich also vorher interaktiv an.

4. Prüfe, ob die Verbindung steht

   Führe /mcp aus, um Status und Tools jedes Servers zu sehen, und claude mcp list in deiner Shell. Bitte Claude dann, das Tool beim Namen zu nutzen.

5. Verwalte deine Server

   Server auflisten, ansehen, entfernen oder importieren geht über die Kommandozeile. Einen Server, den du selten brauchst, deaktivierst du besser in /mcp, statt ihn zu entfernen.

   claude mcp list            # alle konfigurierten Server
   claude mcp get notion      # Details zu einem Server
   claude mcp remove notion   # entfernen (vorher claude mcp logout notion ausführen, um Tokens zu widerrufen)
   claude mcp add-from-claude-desktop   # aus Claude Desktop importieren (macOS, WSL)

Quelle: Claude-Code-Dokumentation, Connect Claude Code to tools via MCP

MCP-Scopes und wo die Config-Dateien liegen

Hier speichert Claude Code die MCP-Konfiguration. Beachte: Der "local"-Scope von MCP liegt in ~/.claude.json, nicht in .claude/settings.local.json.

Server mit .mcp.json teilen

Mit .mcp.json nutzt das ganze Team dieselben Server. Halte Secrets mit Umgebungsvariablen heraus: ${VAR} wird durch den Wert der Variable ersetzt, und ${VAR:-default} greift auf einen Standardwert zurück, wenn sie nicht gesetzt ist. Die Ersetzung funktioniert in command, args, env, url und headers.

1. Verweise auf Variablen statt auf Secrets

   Claude Code bittet jede Person beim ersten Mal, die Projekt-Server aus .mcp.json freizugeben; claude mcp reset-project-choices setzt diese Antworten zurück. Ein JSON-Eintrag mit url braucht außerdem einen type, etwa http.

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

Vorrang, Connectors und weitere Details

• Ist derselbe Server doppelt definiert, verbindet sich Claude Code nur einmal und nimmt den ersten in dieser Reihenfolge: local, project, user, plugin, claude.ai-Connector. Einträge werden nicht zusammengeführt; die verwalteten Server einer Organisation haben Vorrang vor allen.
• Wenn du dich mit einem claude.ai-Konto bei Claude Code anmeldest, erscheinen Connectors, die du in claude.ai hinzugefügt hast, automatisch.
• Claude Code kann selbst ein MCP-Server sein: claude mcp serve stellt seine Tools einem anderen Client bereit, etwa Claude Desktop.
• Server können auch Prompts anbieten, die als Slash-Commands erscheinen; siehe Slash-Commands in Claude Code.
• Beim Entfernen eines Remote-Servers löscht Claude Code die gespeicherten Tokens, widerruft sie aber nicht; führe dafür vorher claude mcp logout <name> aus.

MCP und Token-Verbrauch

Tool-Definitionen werden standardmäßig erst bei Bedarf geladen: Nur Tool-Namen und Server-Anweisungen liegen im Kontext, bis Claude ein Tool nutzt, eine lange Liste von Servern kostet also weniger als früher. Jeder Server fügt trotzdem etwas hinzu, deaktiviere daher in /mcp die, die du nicht nutzt, und nimm lieber eine CLI wie gh, aws oder gcloud, wenn es eine gibt, denn sie fügt gar keine Tool-Liste hinzu. Mehr dazu in wie du den Token-Verbrauch von Claude Code senkst.

Fehlerbehebung: wenn ein Server keine Verbindung bekommt

• Server verlangt eine Anmeldung: Öffne /mcp und wähle Re-authenticate, oder führe claude mcp login <name> aus.
• "has a url but no type": Ergänze "type": "http" (oder sse bzw. ws) im JSON-Eintrag; ohne Typ behandelt Claude Code ihn als stdio.
• Die Flags eines stdio-Servers sind verschwunden: Setz -- vor den Befehl des Servers, damit Claude Code sie nicht als eigene interpretiert.
• Warnung wegen fehlender Variable in claude mcp list: Setz die Variable oder gib ihr ein :-default.
• Ein Projekt-Server lädt in claude -p nie: Headless gibt es keine Freigabeabfrage, prüfe also deine Einstellungen oder übergib die Server explizit mit --mcp-config und --strict-mcp-config.
• Servernamen, die du mit claude mcp hinzufügst, dürfen nur Buchstaben, Ziffern, Bindestriche und Unterstriche enthalten.

Gib deinen KI-Mitarbeitern dieselben Tools, die du nutzt

Über MCP erreicht Claude Code deinen Issue-Tracker, deine Datenbank oder deine Analytics. Crewmark macht aus einer Session von Claude Code, Codex, DeepSeek Harness oder OpenCode einen KI-Mitarbeiter mit Rolle, Ziel und Arbeitszeiten und weckt ihn per Heartbeat, damit er das nächste Issue von einem Board übernimmt, mit den MCP-Servern deines Projekts griffbereit.

1. Committe .mcp.json

   Server mit Projekt-Scope laden in der Session des Mitarbeiters genau wie in deiner; bei Servern, die OAuth brauchen, meldest du sie einmal interaktiv an.

2. Lass den Heartbeat die Arbeit starten

   Während seiner Arbeitszeiten wacht der Mitarbeiter alle 15, 30 oder 60 Minuten in derselben Unterhaltung auf; siehe wie du Claude Code proaktiv machst.

3. Gib jeder Rolle nur, was sie braucht

   Ein SEO-Mitarbeiter bekommt die Search Console, ein Programmierer GitHub und Sentry. Lies, was ein KI-Mitarbeiter ist.

FAQ zu Claude Code MCP