Cursor MCP einrichten: Projektdatei, HTTP und Test

Beginnen Sie in Cursor mit einer klaren Frage: Soll die Verbindung nur in diesem Projekt oder in allen Projekten zur Verfügung stehen? Erst danach wählen Sie Server und Zugang. Diese Reihenfolge verhindert, dass eine persönliche Einrichtung versehentlich als Teamvorgabe behandelt wird. Für den ersten Versuch verwenden wir traceveros öffentliche Registersuche. Sie liest Registerdaten und benötigt keinen tracevero-Zugangsschlüssel. Ein erfolgreicher Versuch mit dieser Schnittstelle bestätigt noch keinen Zugriff auf Ihre übrigen Arbeitswerkzeuge.

Projekt und globale Konfiguration auseinanderhalten

Cursor dokumentiert .cursor/mcp.json im Projekt und ~/.cursor/mcp.json für die globale Konfiguration. Beide verwenden mcpServers. Ein lokaler stdio-Server erhält einen Startbefehl, ein entfernter Server eine URL. Die Clientreferenz für Cursor und der Transportvergleich helfen beim Zuordnen vorhandener Angaben.

Öffnen Sie eine vorhandene Datei vor dem Ergänzen. Ersetzen Sie nicht das ganze Objekt, wenn bereits andere Server eingetragen sind. Vergeben Sie einen eindeutigen Namen und notieren Sie, welche Datei Sie geändert haben. Wenn ein Team die Projektdatei versioniert, gehören persönliche Geheimwerte nicht hinein. Die Kenntnis eines Dateipfads ist noch keine Freigabe für alle Werkzeuge, die ein Server später anbieten kann.

Ein vollständiges HTTP-Beispiel für den ersten Test

Tragen Sie den folgenden Inhalt in die gewählte mcp.json ein oder ergänzen Sie den Eintrag unter dem vorhandenen mcpServers-Objekt. Die URL führt zur MCP-Schnittstelle. Ein Suchergebnis oder eine Webseite aus dem Serververzeichnis ist kein Ersatz für diesen Endpunkt.

{
  "mcpServers": {
    "tracevero": {
      "url": "https://api.tracevero.com/mcp"
    }
  }
}

Das Beispiel startet keinen lokalen Prozess. Bei einem anderen Anbieter kann eine Anmeldung erforderlich sein. Cursor dokumentiert OAuth für entsprechende Server und Variablen wie ${env:NAME} in Konfigurationswerten. Nutzen Sie ausschließlich den vom Anbieter vorgesehenen Zugang. Ein vorhandenes Token sagt ohne passenden Benutzer, Geltungsbereich und Operation nichts über den tatsächlich erlaubten Zugriff aus.

Server, Werkzeug und Ergebnis getrennt abnehmen

1. Prüfen Sie zuerst Datei und Geltungsbereich. Halten Sie andere Server während dieses Versuchs unverändert, damit das Ergebnis Ihrer einen Ergänzung zugeordnet werden kann.

2. Öffnen Sie Cursors MCP-Verwaltung und kontrollieren Sie die Verbindung. Lesen Sie bei einer Fehlermeldung den konkreten Start- oder HTTP-Fehler, bevor Sie Anmeldedaten ersetzen.

3. Wählen Sie für tracevero die lesende Suche search mit dem Begriff filesystem. Prüfen Sie die angebotenen Argumente, bevor Sie den Aufruf bestätigen.

4. Öffnen Sie den Beleglink eines Ergebnisses und vergleichen Sie ihn mit der Registersuche im Browser. Dokumentieren Sie Suchwort und Zeitpunkt; die Zahl der Registertreffer kann sich später ändern.

Warum ein funktionierender Server trotzdem nicht nutzbar ist

Trennen Sie vier Beobachtungen: Die Datei wurde gelesen, die Verbindung steht, das Werkzeug wird angeboten und der Aufruf liefert das erwartete Ergebnis. Schreiben Sie im Fehlerbericht genau auf, welche Stufe erreicht wurde. Für den letzten Schritt wählen Sie bewusst ein kleines Ergebnis, das Sie unabhängig prüfen können. Eine lange, plausibel klingende Antwort ist als Abnahme weniger hilfreich als ein einzelner korrekter Name mit passender Quelle.

Bei fehlenden Werkzeugen führt die gezielte Fehleranleitung weiter. Prüfen Sie einen problematischen Server zusätzlich mit dem MCP Inspector. Läuft er dort, vergleichen Sie Endpunkt, Konto, Umgebung und Argumente. Erst wenn diese gleich sind, können Sie den Unterschied sinnvoll beim Client suchen. Der Konverter hilft bei unterstützten Formatwechseln und meldet Grenzen ausdrücklich. Die Schrittfolge zum Formatwechsel und der Leitfaden zu Umgebungsvariablen vertiefen diese Übergänge.

Kann ich eine VS-Code-Datei direkt übernehmen?

Prüfen Sie das Ausgangsformat: .vscode/mcp.json verwendet servers, das portable .mcp.json und Cursor verwenden mcpServers. Gleiche Wurzelschlüssel allein reichen nicht; Transportfelder und Variablen müssen ebenfalls zum Zielclient passen.

Ist eine Projektdatei automatisch für alle Kollegen nutzbar?

Nein. Jeder benötigt die passende Umgebung und gegebenenfalls eine eigene Anmeldung oder Organisationsfreigabe. Teilen Sie eine Anleitung statt persönlicher Zugangswerte.

Warum klappt der lokale Start nur im Terminal?

Vergleichen Sie Programmpfad, Arbeitsverzeichnis und Umgebung. Der Leitfaden zu ENOENT grenzt fehlende Startprogramme gezielt ein.

Muss ich jeden Werkzeugaufruf freigeben?

Prüfen Sie Ihre aktuellen Cursor-Einstellungen und die Organisationsvorgaben. Dieser Leitfaden setzt keine automatische Freigabe voraus.

Herstellerquellen, abgerufen am 1. Oktober 2026. Die Testabläufe sind redaktionelle Vorschläge.

1. Cursor: MCP configuration, scopes and tools
   Abrufbefehl anzeigen

   curl -s https://cursor.com/docs/mcp

Alle Beiträge