Cursor-MCP-Setup: mcp.json, One-Click-Installationslinks und OAuth

Kurz gesagt: Cursor liest MCP-Server aus mcp.json, entweder global unter ~/.cursor/mcp.json oder pro Projekt unter .cursor/mcp.json. Ein Remote-Server ist ein url-Eintrag; ein lokaler ist ein command mit args. Datei speichern, Cursor Settings → Tools & MCP öffnen, anmelden, wenn der Server Needs login anzeigt, und die Tools stehen dem Agent zur Verfügung. Server lassen sich auch als One-Click-Installationslink teilen; der für UnifAPI steht weiter unten.

Cursors MCP-Unterstützung ist dateibasiert, und das ist eine gute Nachricht: Außer der OAuth-Anmeldung gibt es nichts durchzuklicken, die Konfiguration lässt sich committen, und dieselbe JSON-Form funktioniert für jeden Server. Diese Anleitung nutzt den UnifAPI-MCP-Server (https://mcp.unifapi.com, öffentliche Live-Daten von X, Instagram, TikTok, YouTube, Reddit, LinkedIn, Threads und dem SEO-Stack) als Beispiel.

Wo mcp.json liegt

Beide Dateien haben dieselbe Form, und Cursor führt sie zusammen. Taucht ein Name in beiden auf, gewinnt der Projekteintrag.

Ein Remote-Server: die url-Form

Erstellen oder bearbeiten Sie die Datei und fügen Sie den Server unter mcpServers hinzu:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

Speichern. Öffnen Sie Cursor Settings → Tools & MCP (ältere Builds: MCP & Integrations). Der Server erscheint mit einem Statuspunkt. Bei einem OAuth-geschützten Server wie UnifAPI steht dort Needs login: Klicken Sie darauf, melden Sie sich im Browserfenster an oder erstellen Sie ein UnifAPI-Konto und bestätigen Sie den Read-only-Scope. Der Punkt wird grün, und unter dem Server klappt die Tool-Liste auf: list_operations, get_operation und call_api.

Cursor unterstützt OAuth 2.0 Dynamic Client Registration, was UnifAPI nutzt, sodass keine Client-ID nötig ist. Für Anbieter, die eine feste Client-ID vergeben oder eine freigeschaltete Redirect-URL verlangen, akzeptiert Cursor neben url einen auth-Block mit CLIENT_ID, optional CLIENT_SECRET und scopes. UnifAPI braucht ihn nicht.

Ein Remote-Server, der statt OAuth ein statisches Token nutzt, nimmt headers, und der Wert kann aus Ihrer Umgebung kommen:

{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com",
      "headers": {
        "Authorization": "Bearer ${env:EXAMPLE_TOKEN}"
      }
    }
  }
}

UnifAPI akzeptiert auf diesem Weg einen Workspace-API-Key, aber OAuth ist der empfohlene Weg: nichts Geheimes in einer Datei, und das Token ist read-only.

Ein lokaler Server: die command-Form

Ein Server, der auf Ihrem Rechner läuft, ist ein Befehl, den Cursor startet:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"],
      "env": {
        "NODE_OPTIONS": "--max-old-space-size=512"
      }
    }
  }
}

${workspaceFolder}, ${userHome} und ${env:NAME} werden interpoliert, sodass eine committete .cursor/mcp.json rechnerunabhängig bleiben kann. command und url schließen sich aus; ein Eintrag mit beidem wird ignoriert.

One-Click-Installationslinks

Cursor kann einen Server über einen Deeplink installieren; so bringen Anbieter einen „Add to Cursor“-Button in ihre Dokumentation. Der Link trägt den Servernamen und dasselbe JSON, das Sie von Hand schreiben würden, base64-kodiert:

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_CONFIG

Für UnifAPI ist config das Base64 von {"url":"https://mcp.unifapi.com"}:

cursor://anysphere.cursor-deeplink/mcp/install?name=unifapi&config=eyJ1cmwiOiJodHRwczovL21jcC51bmlmYXBpLmNvbSJ9

Öffnen Sie ihn im Browser, übergibt er den Server an Cursor, das vor dem Schreiben in Ihre globale mcp.json um Bestätigung bittet. Einen eigenen erzeugen Sie mit echo -n '{"url":"https://…"}' | base64 und tauschen die beiden Parameter aus. Links sind praktisch fürs Onboarding; für ein Team bleibt eine committete .cursor/mcp.json die richtige Wahl.

Die Tools nutzen

MCP-Tools nutzt der Agent (der Standard-Chat-Modus), nicht Inline-Edits oder Tab. Fragen Sie nach etwas, das der Server beantworten kann, und achten Sie auf den Tool-Aufruf:

Liste mit dem unifapi-MCP-Server die für TikTok verfügbaren Operationen auf und sag mir, welche die neuesten Videos eines Creators zurückgibt.

Cursor fragt vor dem Ausführen eines Tools nach, sofern Sie in den MCP-Einstellungen nicht Auto-Run für diesen Server aktivieren. Bei einem Read-only-Server wie UnifAPI ist Auto-Run vertretbar: Das Einzige, was ein Aufruf ausgeben kann, sind Workspace-Credits, und get_operation zeigt den Preis pro Datensatz an, bevor call_api läuft.

Cursor übergibt dem Modell nur eine begrenzte Anzahl Tools auf einmal (rund vierzig über alle aktivierten Server) und deaktiviert den Rest; bevorzugen Sie also Server mit kleiner Tool-Oberfläche. Der Katalog von UnifAPI steckt absichtlich hinter drei Tools; ein großer Katalog mit einem Tool pro Endpunkt wäre größtenteils deaktiviert.

Eine erste Aufgabe auf UnifAPI

Ein begrenzter Prompt, der die ganze Schleife durchläuft:

Mit den unifapi-MCP-Tools: Finde die Reddit-Threads der letzten 7 Tage, die „Cursor MCP“ erwähnen, hole die Top 20 nach Score und fasse die wiederkehrenden Setup-Probleme mit je einem Beispiel-Thread zusammen. Rufe list_operations und get_operation auf, bevor du call_api nutzt.

Abgerechnet wird pro Datensatz öffentlicher Daten in Workspace-Credits (je $0,001; ein Credit für die meisten Datensätze, höhere Mindestpreise stehen im Katalog). Die Modell-Tokens bleiben auf Ihrem Cursor-Plan. Ein neuer UnifAPI-Workspace hat keine Credits, bis er zum ersten Mal aufgeladen wird, was einen einmaligen Bonus mitbringt; laden Sie also vor dem ersten call_api einmal auf.

Wenn Sie lieber von einer Aufgabe als von einem Endpunkt ausgehen, bringen die Plattform-Agents (Reddit, X, LinkedIn, TikTok, YouTube, Instagram, Threads) und der SEO-Agent je einen fertigen Prompt und die Operationen mit, die er braucht.

Fehlerbehebung

Geprüfte Quellen

Verfasst am 14. Oktober 2026 anhand von Cursors MCP-Dokumentation (Konfigurationsformen, OAuth, Interpolation) und der Referenz zu Installationslinks. Die Beschriftungen in den Einstellungen ändern sich zwischen Cursor-Releases; das Dateiformat ist stabil geblieben.

Was Sie als Nächstes lesen sollten

MCP-Setup – die Anweisungen zum gehosteten Connector für jeden Client.

So fügen Sie einen MCP-Server zu Claude hinzu – Connectors, claude_desktop_config.json und claude mcp add.

Codex-MCP-Setup – codex mcp add und config.toml.

Agent-Kontext: Rules, Skills und MCP – wo MCP neben Rules-Dateien und Skills seinen Platz hat.