Sanity über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Sanity klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Sanity + Cursor

Lass deine KI mit deinen Sanity-Inhalten arbeiten: GROQ-Abfragen ausführen, Dokumente, ihre Revisionen und ihren Änderungsverlauf lesen, Dokumenttypen, Datasets und Projekte auflisten und nach deiner Bestätigung Entwürfe anlegen, ändern und veröffentlichen. API-Token mit Viewer- oder Editor-Rechten.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SANITY_PROJECT_ID, SANITY_DATASET, SANITY_API_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne https://www.sanity.io/manage, wähl das Projekt und kopiere seine Project ID (8 Zeichen, zum Beispiel abc12xyz) in SANITY_PROJECT_ID.

2. Notiere unter Datasets das Dataset, mit dem gearbeitet werden soll, meist production, und trag es in SANITY_DATASET ein.

3. Klick unter API → Tokens auf Add API token, vergib einen Namen und wähl die Berechtigung:

   • Viewer liest veröffentlichte Dokumente und Entwürfe, samt Verlauf. Reicht für alle Lese-Tools; Schreibzugriffe werden abgelehnt.
   • Editor schreibt auch. Nötig, um Entwürfe anzulegen, zu ändern und zu veröffentlichen.

   Vermeide Developer- und Administrator-Tokens: Sie können auch Projekteinstellungen und Datasets ändern.

4. Kopiere das Token in SANITY_API_TOKEN (Sanity zeigt es nur einmal) und installiere den Connector. Prüfe die Einrichtung mit sanity_list_document_types.

GROQ-Abfragen: sanity_query führt GROQ auf deinem Dataset aus, so beantwortet die KI Fragen wie „welche Beiträge haben keine SEO-Beschreibung“ oder „wie viele Produkte sind ausverkauft“ in einem Aufruf. Sie fragt nur die Felder ab, die sie braucht, begrenzt die Zahl der Ergebnisse, weil Antworten über etwa 60 KB abgeschnitten werden, und übergibt Werte als Parameter. Kennt sie dein Schema noch nicht, listet sie zuerst die Dokumenttypen auf und schaut sich ein paar Dokumente an. Mit der Perspektive drafts liest sie die Inhalte so, als wären alle Entwürfe veröffentlicht.

Erst Entwurf, live nur nach deinem Ja: sanity_create_draft und sanity_patch_draft schreiben immer nur den Entwurf, also die Fassung, die Redakteure in Sanity Studio sehen. Nichts erreicht deine Website, bevor sanity_publish_draft das veröffentlichte Dokument ersetzt. Vor jedem dieser Schritte zeigt dir die KI das Dokument, die Änderung und ob sie live geht, und wartet auf ein klares Ja. Ein Probelauf (dry run) prüft eine Aktion, ohne zu speichern. sanity_delete_document ist bei der Installation ausgeschaltet.

Verlauf: sanity_list_document_transactions zeigt, wer ein Dokument wann geändert hat, und sanity_get_document_revision liefert das Dokument so, wie es bei einer Revision oder zu einem Zeitpunkt war, etwa um zwei Fassungen zu vergleichen oder überschriebenen Text zurückzuholen.

Rich Text: Portable-Text-Felder sind Arrays aus Blöcken, und jeder Block braucht einen eindeutigen _key. Der Connector erklärt der KI, wie sie einfache Absätze schreibt.

Häufige Fehler: 401 Session not found: Das Token ist falsch oder wurde gelöscht. 403 Insufficient permissions: Ein Viewer-Token wollte schreiben, oder das Token gehört zu einem anderen Projekt. 404 Dataset not found: Prüfe SANITY_DATASET. 400 queryParseError: Die GROQ-Abfrage hat einen Syntaxfehler, und die Meldung zeigt, wo.

Nicht enthalten: Bild- und Datei-Uploads, Content Releases und zeitgesteuertes Veröffentlichen, Zurückziehen von Veröffentlichungen, Verwaltung von Datasets und Projekten, Webhooks, CORS, Mitglieder und Echtzeit-Listener.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Sanity-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Blogbeiträge wurden in den letzten 30 Tagen veröffentlicht? Zeig Titel, Autor und Slug.“
• „Finde alle Produkte, deren Beschreibung leer oder kürzer als 50 Zeichen ist.“
• „Wer hat die Preisseite zuletzt geändert, und was stand vor dieser Änderung dort?“
• „Korrigiere den Tippfehler ‚Wilkommen‘ im Titel des Beitrags zu unserem Frühjahrs-Launch. Speichere es als Entwurf und zeig mir die Änderung, bevor du speicherst.“
• „Veröffentliche den Entwurf des Beitrags ‚Release Notes Oktober‘. Sag mir vorher genau, was live geht.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden