​
Was ist MCP?

Das Model Context Protocol (MCP) ermöglicht Cursor die Verbindung zu externen Tools und Datenquellen.

​
Warum MCP verwenden?

MCP verbindet Cursor mit externen Systemen und Daten. Anstatt deine Projektstruktur immer wieder zu erklären, integrier dich direkt mit deinen Tools. Schreib MCP-Server in jeder Sprache, die auf stdout ausgeben oder einen HTTP-Endpoint bereitstellen kann – Python, JavaScript, Go, etc.

​
So funktioniert’s

MCP-Server stellen Fähigkeiten über das Protokoll bereit und verbinden Cursor mit externen Tools oder Datenquellen. Cursor unterstützt drei Transportmethoden:
TransportAusführungsumgebungBereitstellungNutzerEingabeAuth
stdioLokalVon Cursor verwaltetEinzelner NutzerShell-BefehlManuell
SSELokal/RemoteAls Server bereitstellenMehrere NutzerURL zu einem SSE-EndpunktOAuth
Streamable HTTPLokal/RemoteAls Server bereitstellenMehrere NutzerURL zu einem HTTP-EndpunktOAuth

​
Protokollunterstützung

Cursor unterstützt diese MCP-Protokollfunktionen:
FeatureSupportDescription
ToolsSupportedFunktionen, die das KI-Modell ausführen kann
PromptsSupportedVorlagenbasierte Nachrichten und Workflows für Nutzer
ResourcesSupportedStrukturierte Datenquellen, die gelesen und referenziert werden können
RootsSupportedVom Server initiierte Abfragen zu URI- oder Dateisystemgrenzen, innerhalb derer gearbeitet werden kann
ElicitationSupportedVom Server initiierte Anforderungen nach zusätzlichen Informationen von Nutzern

​
MCP-Server installieren

​
Installation mit einem Klick

Installier MCP-Server aus unserer Sammlung und authentifizier dich per OAuth.

MCP-Tools durchsuchen

Verfügbare MCP-Server durchsuchen

„Zu Cursor hinzufügen“-Button

Einen „Zu Cursor hinzufügen“-Button erstellen

​
Verwendung von mcp.json

Konfigurier benutzerdefinierte MCP-Server mit einer JSON-Datei: 
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

​
STDIO-Serverkonfiguration

Für STDIO-Server (lokale Kommandozeilenserver) konfigurier diese Felder in deiner mcp.json:
FeldErforderlichBeschreibungBeispiele
typeJaVerbindungstyp des Servers"stdio"
commandJaBefehl zum Starten der Server-Binary. Muss in deinem Systempfad verfügbar sein oder den vollständigen Pfad enthalten."npx", "node", "python", "docker"
argsNeinArray von Argumenten, die an den Befehl übergeben werden["server.py", "--port", "3000"]
envNeinUmgebungsvariablen für den Server{"API_KEY": "${input:api-key}"}
envFileNeinPfad zu einer Umgebungsdatei, um weitere Variablen zu laden".env", "${workspaceFolder}/.env"

​
Verwendung der Extension-API

Für die programmgesteuerte Registrierung von MCP-Servern stellt Cursor eine Extension-API bereit, die eine dynamische Konfiguration ermöglicht, ohne mcp.json-Dateien anzupassen. Das ist besonders nützlich für Enterprise-Umgebungen und automatisierte Setup-Workflows.

MCP Extension API Reference

Erfahre, wie du MCP-Server programmgesteuert mit vscode.cursor.mcp.registerServer() registrierst

​
Speicherorte für Konfiguration

Projektkonfiguration

Erstell in deinem Projekt die Datei .cursor/mcp.json für projektspezifische Tools.

Globale Konfiguration

Erstell in deinem Home-Verzeichnis die Datei ~/.cursor/mcp.json für Tools, die überall verfügbar sind.

​
Konfigurationsinterpolation

Verwende Variablen in mcp.json-Werten. Cursor ersetzt Variablen in diesen Feldern: command, args, env, url und headers. Unterstützte Syntax:
  • ${env:NAME} Umgebungsvariablen
  • ${userHome} Pfad zu deinem Home-Verzeichnis
  • ${workspaceFolder} Projektstamm (der Ordner, der .cursor/mcp.json enthält)
  • ${workspaceFolderBasename} Name des Projektstamms
  • ${pathSeparator} und ${/} Betriebssystem-Pfadtrennzeichen
Beispiele 
{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

​
Authentifizierung

MCP-Server verwenden Umgebungsvariablen für die Authentifizierung. Übergib API-Schlüssel und Tokens über die Konfiguration. Cursor unterstützt OAuth für Server, die es erfordern.

​
MCP im Chat verwenden

Der Composer-Agent nutzt automatisch relevante MCP-Tools, die unter Available Tools aufgeführt sind. Frag nach einem bestimmten Tool beim Namen oder beschreib, was du brauchst. Aktiviere oder deaktiviere Tools in den Einstellungen.

​
Tools umschalten

Aktiviere oder deaktiviere MCP-Tools direkt in der Chatoberfläche. Klick in der Toolliste auf einen Toolnamen, um ihn umzuschalten. Deaktivierte Tools werden nicht in den Kontext geladen und sind für den Agent nicht verfügbar.

​
Toolfreigabe

Der Agent fragt standardmäßig nach deiner Freigabe, bevor er MCP-Tools verwendet. Klick auf den Pfeil neben dem Toolnamen, um die Argumente anzuzeigen.

​
Auto-Run

Aktiviere Auto-Run, damit der Agent MCP-Tools ohne Rückfrage nutzen kann. Funktioniert wie Terminal-Befehle. Mehr über die Auto-Run-Einstellungen findest du hier.

​
Tool-Antwort

Cursor zeigt die Antwort im Chat mit aufklappbaren Ansichten von Argumenten und Ergebnissen:

​
Bilder als Kontext

MCP-Server können Bilder zurückgeben – Screenshots, Diagramme usw. Gib sie als Base64-codierte Strings zurück: 
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ vollständiger Base64-String aus Gründen der Lesbarkeit gekürzt

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
Sieh dir diesen Beispielserver für Implementierungsdetails an. Cursor hängt zurückgegebene Bilder im Chat an. Wenn das Modell Bilder unterstützt, analysiert es sie.

​
Sicherheitshinweise

Wenn du MCP-Server installierst, beachte diese Sicherheitspraktiken:
  • Quelle überprüfen: Installiere MCP-Server nur von vertrauenswürdigen Entwickler*innen und Repositories
  • Berechtigungen prüfen: Schau nach, auf welche Daten und APIs der Server zugreift
  • API-Schlüssel einschränken: Verwende eingeschränkte API-Schlüssel mit minimal notwendigen Berechtigungen
  • Code prüfen: Für kritische Integrationen den Quellcode des Servers überprüfen
Denk daran, dass MCP-Server auf externe Dienste zugreifen und in deinem Namen Code ausführen können. Versteh immer genau, was ein Server macht, bevor du ihn installierst.

​
Praxisnahe Beispiele

Für praktische Beispiele von MCP in Aktion schau dir unseren Web-Development-Guide an. Er zeigt, wie du Linear, Figma und Browser-Tools in deinen Entwicklungsworkflow integrierst.

​
FAQ

MCP-Server verbinden Cursor mit externen Tools wie Google Drive, Notion und anderen Diensten, um Dokus und Anforderungen direkt in deinen Coding-Workflow zu holen.
So checkst du MCP-Logs: 1. Öffne das Output-Panel in Cursor (Ctrl+Shift+U) 2. Wähle „MCP Logs“ aus dem Dropdown 3. Prüfe auf Verbindungsfehler, Authentifizierungsprobleme oder Serverabstürze. Die Logs zeigen Serverinitialisierung, Tool-Aufrufe und Fehlermeldungen.
Ja! Du kannst Server an- oder ausschalten, ohne sie zu entfernen: 1. Öffne die Settings ( Ctrl+Shift+J) 2. Geh zu Features → Model Context Protocol 3. Klick den Toggle neben einem Server, um ihn zu aktivieren/deaktivieren. Deaktivierte Server werden nicht geladen und erscheinen nicht im Chat. Das ist hilfreich fürs Troubleshooting oder um Tool-Clutter zu reduzieren.
Wenn ein MCP-Server fehlschlägt: - Cursor zeigt eine Fehlermeldung im Chat - Der Tool- Aufruf wird als fehlgeschlagen markiert - Du kannst die Aktion erneut ausführen oder die Logs für Details checken - Andere MCP-Server laufen normal weiter. Cursor isoliert Server- Ausfälle, damit ein Server die anderen nicht beeinflusst.
Für npm-basierte Server: 1. Entferne den Server aus den Settings 2. Leere den npm-Cache: npm cache clean --force 3. Füge den Server erneut hinzu, um die neueste Version zu erhalten. Für Custom-Server aktualisiere deine lokalen Dateien und starte Cursor neu.
Ja, aber befolge Security-Best Practices: - Verwende Environment-Variablen für Secrets, niemals hardcoden - Führe sensible Server lokal mit stdio- Transport aus - Beschränke API-Key-Berechtigungen auf das Nötigste - Reviewe den Server- Code, bevor du ihn mit sensiblen Systemen verbindest - Zieh in Betracht, Server in isolierten Umgebungen laufen zu lassen