​
Was ist MCP?

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

​
Warum MCP?

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

​
So funktioniert’s

MCP-Server stellen Funktionen über das Protokoll bereit und verbinden Cursor mit externen Tools oder Datenquellen. Cursor unterstützt drei Transportmethoden:
TransportAusführungsumgebungDeploymentNutzerEingabeAuth
stdioLokalVon Cursor verwaltetEin NutzerShell-BefehlManuell
SSELokal/RemoteAls Server bereitstellenMehrere NutzerURL zu einem SSE-EndpointOAuth
Streamable HTTPLokal/RemoteAls Server bereitstellenMehrere NutzerURL zu einem HTTP-EndpointOAuth

​
Protokollunterstützung

Cursor unterstützt diese MCP-Protokollfunktionen:
FeatureUnterstützungBeschreibung
ToolsUnterstütztFunktionen, die das KI-Modell ausführen kann
PromptsUnterstütztVorlagenbasierte Nachrichten und Workflows für Nutzer
RootsUnterstütztVom Server initiierte Abfragen zu URI- oder Dateisystemgrenzen, innerhalb derer gearbeitet wird
ElicitationUnterstütztVom Server initiierte Anfragen nach zusätzlichen Informationen von Nutzern

​
MCP-Server installieren

​
Ein-Klick-Installation

Installiere MCP-Server aus unserer Sammlung und authentifiziere dich per OAuth.

MCP-Tools durchsuchen

Verfügbare MCP-Server durchsuchen

„Add to Cursor“-Button

Einen „Add to Cursor“-Button erstellen

​
Verwendung von mcp.json

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

​
Verwendung der Extension-API

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

MCP Extension API Reference

Lerne, wie du MCP-Server programmatisch mit vscode.cursor.mcp.registerServer() registrierst

​
Speicherorte für Konfigurationen

Projektkonfiguration

Lege .cursor/mcp.json in deinem Projekt an für projektspezifische Tools.

Globale Konfiguration

Lege ~/.cursor/mcp.json in deinem Home-Verzeichnis an für überall verfügbare Tools.

​
Authentifizierung

MCP-Server verwenden Umgebungsvariablen zur Authentifizierung. Übergib API-Keys und Tokens über die Konfiguration. Cursor unterstützt OAuth für Server, die es benötigen.

​
MCP im Chat verwenden

Der Composer Agent nutzt automatisch relevante MCP-Tools aus Available Tools. 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 Chat-Oberfläche. Klick in der Tool-Liste auf einen Tool-Namen, um es umzuschalten. Deaktivierte Tools werden nicht in den Kontext geladen und stehen dem Agent nicht zur Verfügung.

​
Tool-Bestätigung

Der Agent fragt standardmäßig nach Bestätigung, bevor er MCP-Tools verwendet. Klick auf den Pfeil neben dem Tool-Namen, um die Argumente zu sehen.

​
Auto-run

Aktiviere Auto-run, damit der Agent MCP-Tools ohne Rückfrage verwendet. Funktioniert wie Terminalbefehle. Mehr über den Yolo-Modus findest du hier.

​
Tool-Antwort

Cursor zeigt die Antwort im Chat mit aufklappbaren Ansichten für Argumente und Responses:

​
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ändiges Base64 aus Lesbarkeitsgründen 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 an den Chat an. Wenn das Modell Bilder unterstützt, analysiert es sie.

​
Sicherheitshinweise

Beim Installieren von MCP-Servern solltest du diese Sicherheitspraktiken beachten:
  • Quelle verifizieren: Installiere MCP-Server nur von vertrauenswürdigen Entwickler:innen und Repositories
  • Berechtigungen prüfen: Prüfe, auf welche Daten und APIs der Server zugreift
  • API-Schlüssel begrenzen: Verwende eingeschränkte API-Schlüssel mit minimal notwendigen Berechtigungen
  • Code prüfen: Bei kritischen Integrationen den Quellcode des Servers reviewen
Denk daran, dass MCP-Server auf externe Dienste zugreifen und in deinem Namen Code ausführen können. Versteh immer, was ein Server macht, bevor du ihn installierst.

​
Praxisnahe Beispiele

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

​
FAQ