MCP-Server zu Claude Code hinzufügen

Einen entfernten Server über HTTP hinzufügen

Ein entfernter Server ist eine URL. Claude Code spricht mit ihm über Streamable HTTP, sodass die gesamte Registrierung eine einzige Zeile ist:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp

Das erste Argument nach dem Transport ist der Name, den Sie in /mcp und in den Tool-Namen sehen; das zweite ist der Endpunkt. Server, die sich per OAuth authentifizieren, brauchen auf der Kommandozeile nichts weiter: Beim ersten Öffnen von /mcp wählen Sie den Server aus, und Claude Code öffnet den Browser für Anmeldung und Zustimmung, speichert anschließend das erhaltene Token und erneuert es von selbst. Ab Claude Code 2.1.186 können Sie die Anmeldung auch ohne die interaktive Sitzung ausführen, mit claude mcp login hosttracker, und auf einem Rechner ohne Browser --no-browser anhängen, um eine URL zu erhalten, die Sie andernorts einfügen.

Server, die stattdessen ein statisches Token erwarten, nehmen es als Header entgegen:

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Einige ältere Server sprechen noch den SSE-Transport. Er gilt als veraltet zugunsten von HTTP, und seit Claude Code 2.1.265 versucht --transport http zunächst HTTP und weicht nur auf SSE aus, wenn der Server ablehnt, sodass Sie --transport sse kaum noch brauchen.

Einen lokalen Server hinzufügen

Ein lokaler Server ist ein Programm, das Claude Code für Sie startet und über Standard-Ein- und -Ausgabe anspricht. Setzen Sie Befehl und Argumente hinter einen doppelten Bindestrich, damit Claude Codes eigene Flags nicht mit denen des Servers verwechselt werden:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

Umgebungsvariablen, die der Server benötigt, übergeben Sie mit --env (Kurzform -e), einmal pro Variable wiederholt. Eine dokumentierte Falle: Der Optionen-Parser liest alles, was auf --env KEY=value folgt, als ein weiteres Paar, setzen Sie den Servernamen also nicht direkt danach; schieben Sie eine andere Option dazwischen oder platzieren Sie --env vor --transport:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

Wenn Sie die Konfiguration des Servers bereits als JSON vorliegen haben, etwa aus seiner README, übernimmt claude mcp add-json <name> '<json>' sie unverändert, einschließlich type, command, args und env.

Den Geltungsbereich wählen: dieses Projekt, das Team oder überall

Standardmäßig wird ein Server im lokalen Geltungsbereich hinzugefügt, das heißt nur für dieses Projekt und gespeichert in Ihrer eigenen ~/.claude.json. Zwei weitere Geltungsbereiche gibt es:

• --scope project schreibt den Eintrag in eine Datei .mcp.json im Wurzelverzeichnis des Repositorys. Committen Sie sie, und jeder Mitarbeiter erhält denselben Server; Claude Code bittet jede Person beim ersten Mal um Zustimmung.
• --scope user macht den Server in jedem Projekt auf Ihrem Rechner verfügbar, bleibt aber weiterhin privat für Sie.

Existiert derselbe Name in mehr als einem Geltungsbereich, gewinnt lokal vor Projekt, und Projekt vor Benutzer. Der gesamte Eintrag stammt aus dem gewinnenden Geltungsbereich; Felder werden nie über Geltungsbereiche hinweg zusammengeführt. Eine sinnvolle Aufteilung ist --scope user für Dienste, die an Ihr eigenes Konto gebunden sind, etwa ein Monitoring- oder Ticketing-Server, und --scope project für Werkzeuge, die das ganze Team teilen soll.

Prüfen, ob es funktioniert

Führen Sie claude mcp list außerhalb einer Sitzung aus. Jeder Server zeigt einen von mehreren Status an: verbunden, Authentifizierung erforderlich, Verbindung fehlgeschlagen (seit 2.1.219 mit angehängtem HTTP-Status oder Fehler), ausstehende Genehmigung für einen nicht genehmigten Projekt-Server, oder deaktiviert für dieses Projekt. Innerhalb einer Sitzung zeigt /mcp dieselben Server mit ihrer Anzahl an Tools, lässt Sie die Anmeldung für einen Server starten, der sie benötigt, seine Authentifizierung löschen oder ihn für das aktuelle Projekt deaktivieren, ohne ihn zu entfernen.

Ein schneller Funktionstest ist eine Anfrage, die nur der Server beantworten kann. Ist der HostTracker-Server verbunden, fragen Sie etwa "welche meiner Monitore sind gerade ausgefallen?" oder "führe von drei Standorten aus eine HTTP-Prüfung auf example.com durch"; der Assistent sollte ein nach dem Server benanntes Tool aufrufen und ein Ergebnis zitieren, das er nicht hätte wissen können. Passiert nichts, liegt es meist an der Tool-Liste: /mcp zeigt null Tools für einen Server, der zwar verbunden, aber bei der Autorisierung gescheitert ist.

Entfernen, prüfen und importieren

claude mcp get <name> gibt die vollständige Konfiguration und den Geltungsbereich eines Servers aus. claude mcp remove <name> löscht ihn samt aller gespeicherten OAuth-Tokens. Haben Sie Server zuerst in Claude Desktop eingerichtet, importiert claude mcp add-from-claude-desktop sie interaktiv; das funktioniert unter macOS und im Windows-Subsystem für Linux, nicht unter nativem Windows oder nativem Linux, und überspringt einen Desktop-Server, dessen Name Zeichen enthält, die Claude Code nicht zulässt (nur Buchstaben, Ziffern, Bindestriche und Unterstriche).

Ein Monitoring-Server als erster Test

Ein Monitoring-Dienst eignet sich gut als erster Server, weil sich das Ergebnis eines Tool-Aufrufs sofort überprüfen lässt: Der Assistent sagt, eine Website sei erreichbar, und Sie können sie öffnen. Der Server von HostTracker braucht keine lokale Installation, authentifiziert sich per OAuth im Browser und stellt Sofortprüfungen von 300 oder mehr Standorten sowie die Monitore, Störungen, Wartungsfenster und Statusseiten Ihres Kontos bereit, sodass "ist die Produktion erreichbar?" anhand echter Prüfpunkte beantwortet wird statt anhand von Trainingsdaten. Die verwandte Anleitung zur .mcp.json-Konfiguration und Fehlerbehebung behandelt das Dateiformat, Umgebungsvariablen und die Fehler, die in der Praxis auftreten.