Befehls-Referenz · Claude Code
/mcp
Verwaltet MCP-Server-Verbindungen und OAuth-Authentifizierung.
Öffnet ohne Argument eine interaktive Liste aller konfigurierten MCP-Server mit Verbindungsstatus und Tool-Anzahl je Server. Von dort lässt sich für einen Server auch die OAuth-Anmeldung starten oder erneuern (Re-authenticate), etwa wenn ein Aufruf mit 401 Unauthorized oder 403 Forbidden fehlschlägt und der Server deshalb als anmeldungsbedürftig markiert wird.
Mit Argumenten steuert der Befehl gezielt einzelne Server: /mcp reconnect <server> baut die Verbindung zu einem getrennten Server neu auf, /mcp enable/disable <server> (oder all) schaltet Server ein oder aus, ohne ihre Konfiguration zu löschen — ein deaktivierter Server bleibt in der Liste sichtbar, aber als deaktiviert markiert. Bei HTTP- oder SSE-Servern versucht Claude Code eine unterbrochene Verbindung zunächst automatisch neu aufzubauen (bis zu fünf Versuche mit steigender Wartezeit), erst danach ist manuelles Eingreifen über /mcp nötig.
Seit Version 2.1.205 auch non-interactive (-p) nutzbar; ohne Argument gibt der Befehl dann eine Text-Zusammenfassung des Serverstatus statt der interaktiven Liste aus. Neue Server werden nicht hier, sondern über claude mcp add eingerichtet.
🔄 DIESELBE AUFGABE („MCP-SERVER VERWALTEN") AUF ANDEREN PLATTFORMEN
✅ WANN EINSETZEN?
Verbindungsstatus eines MCP-Servers reparieren
Ein MCP-Server antwortet nicht mehr → /mcp reconnect <server> ausführen, um die Verbindung neu aufzubauen.
Einzelne MCP-Server gezielt deaktivieren
/mcp disable <server> nutzen, um einen selten gebrauchten Server temporär abzuschalten, ohne seine Konfiguration zu verlieren.
OAuth-Anmeldung für einen Server erneuern
Zeigt /mcp einen Server nach einem 401-Fehler als anmeldungsbedürftig an, im Server-Menü 'Re-authenticate' auswählen.
⛔ WANN EHER NICHT?
Einen neuen MCP-Server erstmalig einrichten
/mcp verwaltet nur bestehende Verbindungen (reconnect, enable, disable) und OAuth-Authentifizierung, es legt keine neue Server-Konfiguration an.
Besser: Den Server zunächst mit claude mcp add hinzufügen, bevor /mcp zur Verwaltung genutzt wird.
Serverstatus automatisiert in einem Skript auswerten
Interaktiv öffnet /mcp einen Auswahldialog, der für automatisierte Checks ungeeignet ist.
Besser: /mcp non-interactive mit -p ausführen (ab v2.1.205) für eine Text-Zusammenfassung, oder claude mcp list für die Konfigurationsliste.
QUELLEN
- Claude Code Doku (offiziell) ↗ code.claude.com
WEITERE BEFEHLE · Claude Code