Workbranch › Anleitungen

So verbinden Sie MCP-Server mit Claude Code

MCP-Server geben Claude Code Zugriff auf Werkzeuge außerhalb Ihres Codes, etwa einen Issue-Tracker, eine Datenbank oder ein Design-Tool. Diese Anleitung zeigt die Befehle zum Hinzufügen, wo die Einstellung gespeichert wird, wie Sie sich anmelden und woran Sie erkennen, ob alles funktioniert.

Aktualisiert am 30. Oktober 2026

Die Befehle folgen der Claude-Code-Dokumentation von Anthropic, Stand Oktober 2026. Die Befehle claude mcp führen Sie in Ihrem normalen Terminal aus, nicht innerhalb einer Claude-Code-Sitzung.

Einen Remote-Server hinzufügen (der häufigste Fall)

Ein gehosteter Dienst nennt Ihnen eine Webadresse für seinen MCP-Server, die Sie in seiner eigenen Einrichtungsanleitung finden. Anthropic empfiehlt dafür den HTTP-Transport.

1. Wechseln Sie im Terminal mit cd in das Projekt, in dem Sie ihn nutzen wollen.
2. Führen Sie claude mcp add --transport http notion https://mcp.notion.com/mcp aus und setzen Sie Ihren eigenen Namen und Ihre Adresse ein. Der Name ist das, was Sie in Listen und in /mcp sehen.
3. Nutzt der Dienst statt einer Anmeldung einen API-Schlüssel, übergeben Sie ihn als Header: --header "Authorization: Bearer your-token".

Ältere Server bieten eventuell nur SSE an, das veraltet ist. Neuere Versionen von Claude Code versuchen zuerst HTTP und weichen von selbst auf SSE aus; bei älteren Versionen verwenden Sie --transport sse.

Einen lokalen Server hinzufügen

Ein lokaler Server (stdio) ist ein Programm, das auf Ihrem Computer läuft und oft mit npx gestartet wird.

1. Schreiben Sie zuerst die Claude-Optionen, dann --, dann den eigentlichen Befehl des Servers: claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server.
2. Claude Code reicht alles nach -- direkt an das Serverprogramm weiter. Ohne dieses Trennzeichen werden Flags für den Server (etwa -y) als Optionen von Claude Code gelesen.
3. Wenn Sie --env verwenden, setzen Sie wie im Beispiel eine weitere Option zwischen diese und den Servernamen, sonst wird der Name als weitere Variable gelesen.

Einen Scope wählen

Wählen Sie user für Werkzeuge, die Sie überall möchten, etwa Ihre Notiz-App, und project für Werkzeuge, die das ganze Team in einem Repository braucht. Ist ein Server an mehreren Stellen definiert, verbindet sich Claude Code nur einmal, in dieser Rangfolge: local, project, user, dann Server aus Plugins, dann claude.ai-Konnektoren. Die drei Scopes werden über den Namen abgeglichen; Plugin-Server und Konnektoren gelten als Duplikate, wenn sie auf dieselbe Adresse oder denselben Befehl zeigen. Der Eintrag mit Vorrang wird vollständig verwendet; Felder werden nicht zusammengeführt.

Schreiben Sie keine Geheimnisse direkt in eine geteilte .mcp.json. Sie akzeptiert Variablen wie ${API_KEY} oder ${API_BASE_URL:-https://api.example.com}, die jede Person in ihrer eigenen Umgebung setzt.

Bei einem Server mit Konto anmelden

1. Starten Sie Claude Code mit claude.
2. Tippen Sie /mcp. Das Fenster listet die Server auf, bei denen Sie sich noch anmelden müssen.
3. Wählen Sie den Server und folgen Sie der Anmeldung im Browser. Das Token wird auf Ihrem Computer gespeichert und automatisch erneuert.
4. Alternativ führen Sie in Ihrer Shell claude mcp login name aus. Abmelden können Sie sich mit claude mcp logout name.

Manche Dienste verlangen, dass Sie zuerst eine App bei ihnen registrieren. Fügen Sie den Server dann mit --client-id, --client-secret (Sie werden aufgefordert, es einzutippen) und, falls deren Einrichtung eine feste Weiterleitung verlangt, --callback-port hinzu.

Prüfen, ob es funktioniert

• claude mcp list zeigt jeden Server mit seinem Status: Connected, Needs authentication, Failed to connect, Pending approval oder Disabled for this project.
• claude mcp get name zeigt die Details eines Servers, einschließlich des HTTP-Fehlers, wenn er fehlschlägt.
• In einer Sitzung zeigt /mcp denselben Status und lässt Sie die Verbindung neu herstellen.
• Bitten Sie Claude zum Schluss um etwas, das nur dieser Server kann, etwa „list my open Linear issues“ (zeige meine offenen Linear-Issues).

Einen Server entfernen Sie mit claude mcp remove name.

Gut zu wissen

• Projektserver fragen zuerst: Wenn eine Sitzung zum ersten Mal Server in der .mcp.json eines Repositorys findet, bittet Claude Code Sie um Zustimmung. Ihre Entscheidungen machen Sie mit claude mcp reset-project-choices rückgängig. Stimmen Sie nur Servern aus Repositorys zu, denen Sie vertrauen.
• Berechtigungen gelten weiterhin: Jeder Aufruf eines MCP-Werkzeugs kann wie bei jedem anderen Werkzeug eine Rückfrage auslösen; siehe wie Sie Berechtigungen in Claude Code verwalten.
• Große Ergebnisse: Claude Code warnt, wenn ein Werkzeug mehr als 10.000 Tokens zurückgibt, und begrenzt die Ausgabe standardmäßig auf 25.000. Erhöhen lässt sich das mit der Umgebungsvariablen MAX_MCP_OUTPUT_TOKENS.
• Plugins: Manche Plugins bringen eigene MCP-Server mit, daher kann die Installation eines Plugins der einfachere Weg sein; siehe wie Sie Plugins in Claude Code installieren.

Wenn es nicht funktioniert

• Failed to connect: Führen Sie claude mcp get name aus, um den Fehler zu sehen, prüfen Sie die URL und führen Sie dann in einer Sitzung /mcp reconnect all aus (neuere Versionen), um es erneut zu versuchen.
• Ein langsamer lokaler Server läuft beim Start in ein Timeout: Starten Sie Claude Code mit einem längeren Limit, etwa MCP_TIMEOUT=10000 claude (in Millisekunden).
• „has a url but no type“: Einem JSON-Eintrag für einen Remote-Server fehlt "type": "http".
• Der API-Schlüssel wird abgelehnt: Claude Code warnt vor Leerzeichen oder Zeilenumbrüchen am Anfang oder Ende eines Headers. Fügen Sie den Server mit einem sauber eingefügten Token erneut hinzu.

Quellen

• Claude Code user FAQ (Claude Help Center, geprüft am 30. Oktober 2026)
• Connect Claude Code to tools via MCP (Claude Code Docs, geprüft am 30. Oktober 2026)

Häufige Fragen