MCP

Übersicht

Die Cursor-CLI unterstützt Model Context Protocol (MCP)-Server, sodass du externe Tools und Datenquellen mit agent verbinden kannst. MCP in der CLI verwendet dieselbe Konfiguration wie der Editor – alle MCP-Server, die du konfiguriert hast, funktionieren in beiden.

CLI-Befehle

Verwenden Sie den Befehl agent mcp, um MCP-Server zu verwalten

Konfigurierte Server auflisten

Alle konfigurierten MCP-Server und ihren aktuellen Status anzeigen:

agent mcp list

Dadurch wird ein interaktives Menü geöffnet, in dem du MCP-Server auf einen Blick durchsuchen, aktivieren und konfigurieren kannst. Die Liste zeigt:

• Servernamen und Kennungen
• Verbindungsstatus (verbunden/nicht verbunden)
• Konfigurationsquelle (Projekt oder global)
• Transportmethode (stdio, HTTP, SSE)

Du kannst auch im interaktiven Modus den Slash-Befehl /mcp list verwenden, um dieselbe Oberfläche zu öffnen.

Verfügbare Tools auflisten

Zeigt die von einem bestimmten MCP-Server bereitgestellten Tools an:

agent mcp list-tools <identifier>

Folgendes wird angezeigt:

• Namen und Beschreibungen der Tools
• Erforderliche und optionale Parameter
• Parametertypen und Einschränkungen

Bei MCP-Server anmelden

Melde dich bei einem in deiner mcp.json konfigurierten MCP-Server an:

agent mcp login <identifier>

Die CLI verwendet einen schlanken Anmeldeablauf mit automatischer Callback-Verarbeitung. Der Agent erhält unmittelbar nach Abschluss der Anmeldung Zugriff auf authentifizierte MCPs.

MCP-Server aktivieren

So aktivieren Sie einen MCP-Server:

agent mcp enable <identifier>

Dadurch wird der Server zur lokalen Liste der genehmigten Server hinzugefügt.

MCP-Server deaktivieren

So deaktivierst du einen MCP-Server:

agent mcp disable <identifier>

Deaktivierte Server werden nicht geladen und fragen nicht nach einer Freigabe.

MCP mit Agent verwenden

Sobald du MCP-Server konfiguriert hast (siehe den MCP-Hauptleitfaden zur Einrichtung), erkennt und nutzt agent automatisch die verfügbaren Tools, wenn sie für deine Anfragen relevant sind.

# Verfügbare MCP-Server überprüfenagent mcp list# Tools eines bestimmten Servers anzeigenagent mcp list-tools playwright# Agent verwenden – er nutzt MCP-Tools automatisch, wenn sie hilfreich sindagent -p "Navigate to google.com and take a screenshot of the search page"# Alle MCP-Server automatisch freigeben (Freigabeaufforderungen überspringen)agent --approve-mcps "query my database for recent errors"

Die CLI verwendet dieselbe Konfigurationsreihenfolge wie der Editor (Projekt → global → verschachtelt) und erkennt automatisch Konfigurationen in übergeordneten Verzeichnissen.

MCP vs. ACP

Verwende MCP, wenn Cursor externe Tools und Dienste aufrufen soll. Verwende ACP, wenn du einen eigenen Client bauen möchtest, der über Protokollnachrichten direkt mit der Cursor-CLI kommuniziert.

Weiterführende Informationen