Cursor MCP Server

Problem: Cursor kann sich mit externen Tools und Daten verbinden, aber die MCP-Geschichte wirkt unklar, bis man es einmal gemacht hat. Welche Datei? Welches Format? Ist es dasselbe wie bei Claude Code?

Quick Win: Erstelle .cursor/mcp.json im Stammverzeichnis deines Projekts und füge einen ersten Server ein:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-api-key" }
    }
  }
}

Cursor neustarten. Web-Suche lebt jetzt in der IDE.

Wenn du noch überlegst, welche Server deine Zeit wert sind, schau erst bei MCP Search Tools vorbei, bevor du sie in Cursor einbindest. Lies diese Seite, wenn du die Server-Kategorie kennst und das genaue Cursor-Konfigurationsformat, Dateipfade und den Rollout-Plan brauchst. Wenn du stattdessen deine eigene Integration entwirfst statt eine bestehende zu installieren, lies Custom MCP Integrations.

Was Cursor MCP Server eigentlich sind

Externe Tools, Datenbanken und APIs verbinden sich über das Model Context Protocol mit Cursors KI. Das Verhalten ist identisch bei Cursor, Claude Code und Claude Desktop, weil alle drei dasselbe Wire-Format sprechen.

Sobald ein Server geladen ist, kann Cursor folgendes:

• Web-Inhalte und Dokumentation abrufen
• Datenbanken in normaler Sprache befragen
• GitHub, Slack und alles andere mit einer Integration steuern
• Browser-Jobs für Tests ausführen
• Jeden Dienst erreichen, der einen MCP-Server bereitstellt

Das Ökosystem ist geteilt. Jeder für Claude Desktop gebaute MCP-Server kommt unverändert in Cursor rein.

MCP-Server in Cursor einrichten

Konfigurations-Dateipfade

Es gibt zwei gültige Stellen:

Projekt-Configs passen gut zu Tools, die an eine Codebasis gebunden sind, wie ein Datenbankserver für die App, die du baust. Globale Configs eignen sich für Tools, die überall hingehören, wie Web-Suche oder eine GitHub-Integration.

Schritt-für-Schritt-Einrichtung

Methode 1: Manuelle Konfiguration

1. Erstelle die Konfigurations-Datei unter .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global)
2. Füge die Server-Konfiguration ein
3. Starte Cursor neu, damit die neuen Server geladen werden
4. Teste es, indem du die KI bittest, ein Tool vom Server auszuführen

Methode 2: Command Palette

1. Öffne die Command Palette (Cmd+Shift+P auf Mac, Ctrl+Shift+P unter Windows)
2. Suche nach "MCP" und wähle "View: Open MCP Settings"
3. Klicke unter MCP Tools auf "New MCP Server"
4. Cursor schreibt die mcp.json-Datei und öffnet sie zur Bearbeitung

Konfigurationsformat

Die JSON-Form entspricht der, die Claude Desktop nutzt:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

Ein Python-basierter MCP-Server sieht fast genauso aus:

{
  "mcpServers": {
    "python-server": {
      "command": "python",
      "args": ["path/to/server.py"],
      "env": {
        "DATABASE_URL": "postgresql://db-host/example_db"
      }
    }
  }
}

Remote-Server-Konfiguration

HTTP-basierte Server werden auch unterstützt:

{
  "mcpServers": {
    "remote-server": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

Praktisch, wenn der Server auf einem anderen Rechner läuft oder hinter einem gemeinsamen Dienst sitzt.

Die besten MCP-Server für Cursor

Diese bringen den meisten Wert pro Zeile Konfiguration. Jeder kommt direkt in .cursor/mcp.json:

Web-Suche und Recherche

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    }
  }
}

Web-Suche innerhalb von Cursor für Dokumentations-Lookups und schnelle Recherche.

GitHub-Integration

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

Repos, Issues, PRs und Reviews, alles ohne den Editor zu verlassen.

Datenbankzugriff

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "DATABASE_URL": "postgresql://db-host/app_db" }
    }
  }
}

Abfragen in natürlicher Sprache rein, Schema und Ergebnisse zurück, während du codierst.

Browser-Automatisierung

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/playwright-mcp-server"]
    }
  }
}

Deckt Browser-Testing, Scraping und visuelle Prüfungen ab. Schau in den Browser-Automatisierungs-Guide für die tieferen Muster.

Dateioperationen

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Liest und schreibt Dateien außerhalb der Verzeichnisse, die Cursor bereits überwacht.

Gedächtnis und Wissen

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Pflegt einen Wissensgraph, der über Sessions hinweg erhalten bleibt.

Der vollständige MCP-Server-Katalog hat 50+ weitere Optionen.

Cursor vs. Claude Code MCP

Server-Configs wechseln zwischen den beiden Tools mit kaum Reibung, da beide Model Context Protocol sprechen. Ein paar Dinge unterscheiden sich trotzdem:

MCP Tool Search in Claude Code lädt Tools lazy und senkt die Kontext-Nutzung um 95%. Cursor lädt bei Session-Start alle konfigurierten Tools.

Server-Pakete bleiben auf beiden Seiten gleich. Eine für Claude Desktop geschriebene Konfiguration läuft in Cursor, und umgekehrt gilt das auch.

Fehlerbehebung bei Cursor MCP-Servern

Server lädt nicht

Symptom: Der MCP-Server taucht nie unter den verfügbaren Tools auf.

Fix:

1. Überprüfe das JSON doppelt (ein abschließendes Komma ist der übliche Schuldige)
2. Beende Cursor komplett und starte neu, nicht nur das Fenster neu laden
3. Öffne das Output-Panel und suche nach MCP-Fehlern

Authentifizierung fehlgeschlagen

Symptom: Der Server lädt, aber API-Calls kommen mit Auth-Fehlern zurück.

Fix: Prüfe, ob die Umgebungsvariablen gesetzt sind:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
      }
    }
  }
}

Das ${env:VAR_NAME}-Muster zieht aus System-Umgebungsvariablen, sodass Secrets nie hardcoded landen.

npx-Befehl nicht gefunden

Symptom: Der Server stirbt mit einem "command not found"-Fehler.

Fix: Bestätige, dass Node.js installiert ist und npx in deinem PATH liegt. Manche Systeme brauchen den absoluten Pfad:

{
  "mcpServers": {
    "server-name": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "@modelcontextprotocol/server-name"]
    }
  }
}

Verbindungsprobleme mit Remote-Server

Symptom: Ein HTTP-basierter Server verweigert die Verbindung.

Fix:

1. Bestätige, dass der Server-Prozess läuft und erreichbar ist
2. Prüfe Firewall-Regeln rund um den Port
3. Stelle sicher, dass die URL das richtige Protokoll trägt (http vs https)

Nächste Schritte

Ein kurzer Pfad zum Aufbau deines Cursor-MCP-Setups:

1. Einfach starten: Binde Brave Search für sofortigen Web-Zugang ein
2. Entwicklungs-Tools hinzufügen: GitHub- und Datenbank-Server beschleunigen echte Arbeit
3. Automatisierung ausprobieren: Starte Browser-Automatisierung für Tests
4. Eigenes bauen: Liefere einen eigenen Server für interne APIs
5. Alles durchsuchen: Die vollständige MCP-Server-Liste hat den Rest

MCP-Server machen aus Cursor einen geschlossenen Editor eine verdrahtete Entwicklungsumgebung. Fang mit einem Server an. Beweise den Wert. Füge mehr hinzu, wenn der Workflow es verlangt.

Drei MCP-Stacks, die tatsächlich nützlich sind

Der Fehler, den die meisten Teams machen, ist zehn Server hinzuzufügen, weil sie es können. Der bessere Zug ist, einen Stack pro Job zu bauen.

1. Produkt-Engineering-Stack

Nutze das, wenn du App-Features von Anfang bis Ende baust:

• GitHub MCP für Repo- und PR-Kontext
• Postgres MCP für Schema- und Daten-Checks
• Brave Search oder Context7-Style Docs-Suche für aktuelle Referenzen
• Playwright MCP für Browser-Verifikation

Das gibt Cursor genug Fläche, um Code zu lesen, Daten zu prüfen, Docs zu checken und UI-Verhalten zu verifizieren, ohne die Session in Tool-Spam zu verwandeln.

2. Content- und SEO-Stack

Nutze das, wenn du inhaltsschwere Seiten auslieferst:

• GitHub MCP für Repo-Inhalte und Diffs
• Search MCP für Konkurrenz- oder Quell-Recherche
• Filesystem MCP für die Arbeit über Content-Ordner außerhalb des aktuellen Workspace

Gute Wahl für Teams, die Landing Pages, Docs, Changelogs oder Blog-Posts schreiben, wo der Job nicht nur "Text schreiben" ist, sondern auch Überschneidungen vergleichen, interne Links aktualisieren und das Repo organisiert halten.

3. Debugging-Stack

Nutze das, wenn das Problem schwer aus dem Code allein reproduzierbar ist:

• GitHub MCP für Änderungshistorie
• Playwright MCP für das Reproduzieren von UI-Zuständen
• Database MCP, wenn der Bug nach Daten-Abhängigkeit riecht

Der Schlüssel ist nicht die Anzahl der Server. Es ist, ob die Tools zur Fehleroberfläche passen, die du untersuchst.

Was du nicht tun solltest

Cursor-MCP-Setups gehen auf wiederholbare Arten schief:

Das richtige Setup ist nicht das größte. Es ist das kleinste Set an Tools, das einen echten Workflow dramatisch besser macht.

Quellen:

• Cursor MCP Documentation
• How to Add MCP Server to Cursor