MCP-Server in Cursor einrichten

Doku zuletzt geprüft: · Wir entwickeln Pith, den gehosteten MCP-Server im Beispiel. Jeden Schritt im Client haben wir an der Dokumentation des Herstellers geprüft — die Links stehen unten.

Kurz gesagt

Cursor liest MCP-Server aus mcp.json: .cursor/mcp.json im Projekt oder ~/.cursor/mcp.json für alle Projekte. Ein lokaler Server ist ein command mit args (stdio); ein Remote-Server ist eine url, optional mit headers (Streamable HTTP oder SSE). Bei Remote-Servern erledigt Cursor OAuth selbst — PKCE, dynamische Client-Registrierung, automatische Token-Erneuerung —, oder du übergibst ein Token per ${env:NAME}. Die Server erscheinen auf der Seite Customize, wo du sie ein- und ausschaltest; vor einem MCP-Werkzeug fragt Cursor standardmäßig nach Freigabe. Für Pith: "url": "https://mcp.pithlab.app/mcp".

Cursors Agent liest deinen Code ohnehin. Ein MCP-Server lässt ihn alles andere erreichen: eine Datenbank, einen Issue-Tracker, einen Browser — oder die Artikel, Paper und Standards, die du liest, während du am Code arbeitest. MCP, das Model Context Protocol, ist derselbe offene Standard, den Claude und ChatGPT nutzen; ein einmal eingerichteter Server funktioniert also in allen dreien.

Diese Anleitung folgt Cursors eigener Dokumentation, Stand 8. November 2026: wo die Konfiguration liegt, lokale gegenüber Remote-Servern, Anmeldung per OAuth oder Token, Freigaben und Rules, Fehlersuche. Am Ende steht ein Beispiel für alle, die so viel schreiben wie programmieren — Doku, Spezifikationen, Blogposts, Recherchenotizen: Du verbindest einen Wissens-Server, Piths gehosteten MCP, damit Cursor beim Schreiben deine gespeicherten Quellen belegt.

Wo Cursors MCP-Konfiguration liegt: mcp.json im Projekt oder global

Cursor kennt zwei Config-Dateien im gleichen Format:

  • Projekt: .cursor/mcp.json im Projektordner — Werkzeuge für dieses Repository. Einchecken, wenn das ganze Team dieselben Server bekommen soll (ohne Geheimnisse darin).
  • Global: ~/.cursor/mcp.json in deinem Home-Ordner — Werkzeuge in jedem Projekt. Der richtige Ort für persönliche Server wie deine eigene Wissensbasis.

Server lassen sich auch per Klick aus dem Cursor Marketplace auf der Seite Customize installieren; Community-Server findest du auf cursor.directory. Installierte und konfigurierte Server erscheinen auf der Customize-Seite, wo du sie ein- und ausschaltest, ohne die Konfiguration zu löschen.

Lokaler Server (stdio) oder Remote-Server (URL)?

Cursor unterstützt drei Transporte: stdio (ein lokaler Befehl, eine Person), SSE und Streamable HTTP (eine URL, lokal oder remote, viele Nutzer). In mcp.json ist der Unterschied schlicht command gegenüber url:

~/.cursor/mcp.json — ein lokaler stdio-Server
{
  "mcpServers": {
    "mein-lokaler-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": { "API_KEY": "${env:SOME_API_KEY}" }
    }
  }
}
~/.cursor/mcp.json — ein Remote-Server
{
  "mcpServers": {
    "pith": {
      "url": "https://mcp.pithlab.app/mcp"
    }
  }
}

Nimm einen lokalen Server, wenn er deinen Rechner braucht — Dateien auf der Platte, eine lokale Datenbank, ein Kommandozeilen-Tool, das nur du hast — oder wenn, wie Cursors Sicherheitshinweise sagen, sensible Daten auf einem Server bleiben sollen, den du selbst betreibst. Nimm einen Remote-Server, wenn die Daten schon in einem gehosteten Dienst liegen: nichts zu installieren oder zu pflegen, und derselbe Server funktioniert auch in Claude und ChatGPT.

Config-Werte können Variablen statt fester Werte enthalten: ${env:NAME} für Umgebungsvariablen, ${userHome}, ${workspaceFolder}, ${workspaceFolderBasename} und ${pathSeparator} (oder ${/}). Cursors Rat: Geheimnisse nie fest eintragen, sondern über Umgebungsvariablen.

Anmelden: OAuth oder Token

OAuth (automatisch). Bei einem Remote-Server, der es unterstützt, liest Cursor die Metadaten der geschützten Ressource und führt den Authorization-Code-Flow mit PKCE aus; per dynamischer Client-Registrierung meldet es sich als öffentlicher Client ohne Client-Secret an und erneuert ein abgelaufenes Zugriffstoken mit dem Refresh-Token. Du bestätigst nur auf der Zustimmungsseite des Dienstes.

Fester OAuth-Client. Unterstützt ein Server keine dynamische Registrierung, trägst du beim Server auth mit CLIENT_ID, CLIENT_SECRET und scopes ein. Die beim Anbieter zu hinterlegenden Redirect-URLs sind http://localhost:8787/callback für die Desktop-App und https://www.cursor.com/agents/mcp/oauth/callback für Web und Agents.

Token im Header. Viele Server nehmen einfach ein API-Token. Leg es in headers ab und lies es aus der Umgebung, damit die Config-Datei teilbar bleibt:

~/.cursor/mcp.json — Remote-Server mit Token aus der Umgebung
{
  "mcpServers": {
    "pith": {
      "url": "https://mcp.pithlab.app/mcp",
      "headers": { "Authorization": "Bearer ${env:PITH_TOKEN}" }
    }
  }
}

Cloud Agents speichern ihre MCP-Anmeldungen auf Cursors Servern, getrennt von den Anmeldungen auf deinem Rechner — rechne damit, einen Server dort noch einmal freizugeben.

MCP-Werkzeuge in Cursor nutzen: Freigaben, Prompts und Rules

Ist ein Server verbunden, nutzt Cursors Agent seine Werkzeuge automatisch, wenn sie passen; du kannst Server oder Werkzeug auch in deiner Anfrage nennen. Vor MCP-Werkzeugen fragt Cursor standardmäßig nach Freigabe, und MCP folgt denselben Ausführungsmodi wie Terminal-Befehle — schalte automatisches Ausführen also nur für Server ein, deren Werkzeugen du vertraust.

Cursor unterstützt mehr von MCP als Werkzeuge: Prompts, Resources, Roots, Elicitation und MCP Apps (interaktive Ansichten). Die Prompts eines Servers sind fertige Abläufe — Pith liefert fact_check (einen Entwurf gegen deine eigenen Quellen prüfen), client_prep, capture und maintain_wiki.

Damit der Agent einen Server von selbst nutzt, legst du eine Projekt-Rule an. Rules liegen in .cursor/rules als .mdc-Dateien mit Frontmatter; „Apply Intelligently“ lässt den Agenten anhand der Beschreibung entscheiden, „Always Apply“ nimmt die Rule in jeden Chat. Eine AGENTS.md im Projektordner ist die einfachere Alternative.

.cursor/rules/quellen.mdc — den Agenten deine gespeicherten Quellen belegen lassen
---
description: "Beim Schreiben von Doku, Specs, Changelogs oder Texten mit Faktenaussagen"
alwaysApply: false
---

- Bevor du einen Fakt zu einem Standard, einer Regulierung, einer
  Bibliothek oder einem Markt nennst, durchsuche meine gespeicherten
  Quellen mit den Pith-MCP-Werkzeugen (search_everything).
- Belege jede solche Aussage mit der Quell-URL. Findet Pith nichts,
  sag das, statt zu raten.

Beispiel: ein Wissens-MCP beim Schreiben und Programmieren

Pith ist ein gehostetes Lese-Gedächtnis: Du speicherst Artikel, PDFs, Paper und Newsletter; Pith baut daraus ein zitiertes Wiki, einen Morgenreport und eine Suche nach Bedeutung über alles Gespeicherte. In Cursor wird daraus „antworte aus dem, was ich wirklich gelesen habe“ — nützlich für READMEs, Architekturnotizen, RFCs und Blogposts. Wir entwickeln Pith; die Einrichtung ist für jeden Remote-Server gleich.

  1. 1

    Deine Quellen in Pith speichern

    Speichere die Doku-Seiten, Paper und Artikel, auf die du dich stützt — mit der Chrome-Erweiterung (samt dem Text der Seite, die du gerade liest), dem iPhone-Kurzbefehl oder dem Android-Teilen-Menü, oder per Import aus Pocket, Raindrop, Instapaper oder Readwise. PDF-Links werden per Texterkennung gelesen. Speichern, Lesen und Suchen sind kostenlos.

  2. 2

    MCP-Token anlegen

    Öffne in Pith Settings → API tokens → „Generate MCP token“, wähle Workspace und Scopes (zum Belegen reichen Lese-Scopes) und kopiere das tfk_…-Token — es wird nur einmal angezeigt.

  3. 3

    Pith in die globale mcp.json eintragen

    Trag den Eintrag mit "url": "https://mcp.pithlab.app/mcp" und dem Header Authorization: Bearer ${env:PITH_TOKEN} in ~/.cursor/mcp.json ein und setz PITH_TOKEN in deinem Shell-Profil. (Alternativ lässt du den Header weg und Cursors OAuth-Anmeldung laufen — Pith unterstützt die dynamische Client-Registrierung.)

  4. 4

    Auf der Customize-Seite prüfen

    Cursor bei Bedarf neu starten, Customize öffnen und prüfen, dass der Pith-Server eingeschaltet ist und seine Werkzeuge auflistet.

  5. 5

    Beim Schreiben fragen

    Im Agent-Chat: „Schreib den Abschnitt ‚Compliance‘ dieser README aus meinen gespeicherten Quellen zum EU Cyber Resilience Act — mit Beleg für jede Aussage.“ Der Agent ruft search_everything auf, liest Kernaussagen mit get_bookmark_facts, prüft den genauen Wortlaut mit get_bookmark_content und schreibt den Abschnitt mit Quell-Links.

Weitere Werkzeuge, die im Editor helfen: search_wiki_pages und get_wiki_page (deine zitierten Wiki-Seiten, samt Quellen-Widersprüchen), list_highlights (Stellen, die du markiert hast), list_deadlines (Termine aus deinen Quellen, etwa ab wann eine Regulierung gilt) und write_note (einen Fund als Pith-Notiz ablegen). Mit Schreib-Scope speichert save_bookmark eine Doku-Seite, die der Agent gerade gefunden hat. Lesen und Wiki-Schreiben über MCP sind kostenlos.

Interaktive Ansichten: Cursor unterstützt MCP Apps, und Pith bietet sie unter https://mcp.pithlab.app/apps an — als zweiten Server-Eintrag hinzufügen. check_citations prüft die Aussagen eines Entwurfs ausschließlich gegen deine gespeicherten Quellen (49 ct je angefangene 10 Seiten aus Piths Prepaid-Guthaben).

Wo die Daten liegen: Pith wird in Deutschland gehostet; die KI-Verarbeitung (Zusammenfassungen und die Embeddings hinter der Suche nach Bedeutung) läuft über OpenAI in den USA. Was der Agent aus Pith liest, geht dann an das Modell, das du in Cursor nutzt.

Fehlersuche und Sicherheit

Logs: Öffne das Output-Panel (Cmd+Shift+U auf dem Mac), wähle im Dropdown „MCP Logs“ und such nach Verbindungsfehlern, Anmeldeproblemen oder Abstürzen des Servers. Bei einem lokalen Server führst du dessen Befehl einmal im Terminal aus — dort steht meist der eigentliche Fehler. Bei einem Remote-Server prüfst du, ob die URL den Pfad enthält (oft /mcp).

Sicherheits-Checkliste, nach Cursors eigenen Empfehlungen:

  • Prüf, woher ein Server stammt und was er darf, bevor du ihn hinzufügst; lies den Quellcode lokaler Server, die an sensible Systeme gehen.
  • Nutze API-Schlüssel mit den kleinsten Scopes, die reichen — zum Belegen ein Pith-Token nur mit Lese-Scopes.
  • Geheimnisse gehören in Umgebungsvariablen, nicht in eine eingecheckte .cursor/mcp.json.
  • Lass Freigaben für Server mit schreibenden Werkzeugen an; der Server sieht die Argumente jedes Werkzeugaufrufs (die Anfrage, den Text zum Speichern), nicht deinen ganzen Chat.
  • Widerrufe Tokens, die du nicht mehr brauchst — bei Pith unter Settings → API tokens.

Häufige Fragen

Wo liegt Cursors MCP-Config-Datei?

.cursor/mcp.json im Projektordner für projektbezogene Server, ~/.cursor/mcp.json im Home-Ordner für Server in jedem Projekt. Beide nutzen dasselbe mcpServers-Format.

Unterstützt Cursor Remote-MCP-Server mit OAuth?

Ja. Cursor führt den OAuth-Authorization-Code-Flow mit PKCE aus, registriert sich per dynamischer Client-Registrierung, wo der Server sie anbietet, und erneuert Tokens automatisch. Für Server ohne dynamische Registrierung trägst du unter auth eine feste Client-ID und ein Secret ein.

Wie übergebe ich einem MCP-Server in Cursor einen API-Schlüssel, ohne ihn einzuchecken?

Verweise in mcp.json auf eine Umgebungsvariable, etwa "Authorization": "Bearer ${env:PITH_TOKEN}" in headers oder "API_KEY": "${env:API_KEY}" in env, und setz die Variable in deiner Shell.

Warum nutzt Cursors Agent meinen MCP-Server nicht?

Prüf, ob der Server auf der Customize-Seite eingeschaltet ist und seine Werkzeuge listet, sieh in die MCP Logs im Output-Panel und nenn den Server in deiner Anfrage. Eine Projekt-Rule in .cursor/rules sorgt dafür, dass der Agent von selbst darauf zugreift.

Kann ich denselben MCP-Server in Cursor, Claude und ChatGPT nutzen?

Ja, wenn es ein Remote-Server ist — genau dafür ist der Standard da. Piths Server unter https://mcp.pithlab.app/mcp funktioniert in allen dreien; siehe die Anleitungen für Claude und ChatGPT.

Was kostet Pith in Cursor?

Verbinden ist kostenlos, Lesen und Wiki-Schreiben über MCP ebenfalls. Speichern, Lesen und Suchen sind kostenlos; KI-Aktionen wie die Zitatprüfung zahlst du pro Nutzung aus einem Prepaid-Guthaben, mit 1 € Gratis-Guthaben jeden Monat — siehe Preise.

Weitere Anleitungen

Quellen (geprüfte Hersteller-Dokumentation)

Gib deinem Assistenten ein Gedächtnis für das, was du liest.

Kostenlos speichern, per MCP verbinden und Claude, ChatGPT oder Cursor aus deinen Quellen antworten lassen — mit Belegen.

Doku zuletzt geprüft: 8. November 2026 · Lizenziert CC BY 4.0 · frei zitierbar unter Namensnennung von Pith.