Sanity-Inhalte per Remote-Server veröffentlichen

Empfehlung

Sanity betreibt den Server selbst; er funktioniert mit jedem MCP-fähigen Client. Für Redaktion und Content-Team ist er vor allem zum Abfragen und für Entwürfe sinnvoll. Wer die Rechte begrenzen will, nutzt ein API-Token mit passend eingeschränkter Rolle, denn dann gelten Rolle und Rechte des Tokens. Beleg 2

Nicht geeignet, wenn

• Du willst Releases per KI planen, veröffentlichen oder archivieren: Das geht nur im Studio oder über die HTTP Actions API. Beleg 2
• Du willst Assets in der Media Library umsortieren oder ihren Versionsverlauf ändern: Das bleibt der Media-Library-App vorbehalten. Beleg 2
• Du willst keine AI-Credits verbrauchen: Die Bildwerkzeuge zählen dagegen; du kannst sie im Client abschalten. Beleg 2

3 Abläufe zum Ausprobieren

Kopiere einen Prompt in deinen KI-Client und ersetze, was in eckigen Klammern steht. Lesende Abläufe ändern nichts im Dienst; bei schreibenden bestätigst du jede Änderung selbst.

1. Alle Artikel eines Autors als Liste ausgeben

   Für Redaktion

   Liest nur Beleg 2

   Prompt · ein Klick markiert den ganzen Text

   Führe eine Abfrage im Dataset [Dataset-Name] aus und liste alle Artikel von [Autorenname] mit Titel, Slug und Status (Entwurf oder live). Sortiere nach Datum, neueste zuerst, und nenne die Zahl der Treffer. Ändere nichts.

   Ergebnis

   Eine Liste der Artikel des Autors mit Titel, Slug, Status und der Zahl der Treffer.

   Vorher prüfen

   Mach eine Stichprobe im Studio und prüfe, ob Anzahl und Status stimmen und ob Entwürfe und Live-Versionen doppelt gezählt wurden.

2. Vorbereitete Releases vor der Redaktionssitzung auflisten

   Für Content-Team

   Liest nur Beleg 2

   Prompt · ein Klick markiert den ganzen Text

   Liste alle aktiven und geplanten Releases im Dataset [Dataset-Name] auf. Nenne zu jedem Release Namen, Typ und, soweit hinterlegt, den Zeitpunkt, zu dem es live gehen soll. Ändere nichts.

   Ergebnis

   Eine Übersicht der Releases mit Namen, Typ und dem vorgesehenen Zeitpunkt.

   Vorher prüfen

   Öffne ein Release im Studio und prüfe, ob Name und Zeitangabe zur Liste passen; die Zeitangabe ist nur ein Vermerk und wird vom Server nicht ausgelöst.

3. Bestehenden Text als Entwurf überarbeiten lassen

   Für Redaktion

   Schreibt Beleg 2

   Prompt · ein Klick markiert den ganzen Text

   Ändere im Dokument [Dokument-ID] das Feld [Feldname] auf diesen Text: [neuer Text]. Speichere die Änderung nur als Entwurf. Zeige mir vorher, was du ändern würdest, und führe es erst nach meiner Bestätigung aus. Veröffentliche nichts.

   Ergebnis

   Das Dokument enthält die neue Fassung als Entwurf; der veröffentlichte Stand bleibt unverändert.

   Vorher prüfen

   Öffne den Entwurf im Studio und vergleiche ihn mit der Live-Version, bevor jemand ihn freigibt.

Das brauchst du

Tarif

Die Doku nennt keinen bestimmten Tarif, nur ein Sanity-Konto. Die Werkzeuge zur KI-Bilderzeugung verbrauchen AI-Credits.

Rolle

Bei OAuth arbeitet der Server mit den Rechten deines Kontos, bei einem API-Token mit der Rolle des Tokens; Tokens legst du unter sanity.io/manage an.

Zeitbedarf

ca. 15 Minuten

Schätzung der Redaktion

Belege

Beleg 2

Einrichtung je Client

Rechte

• 4 von 15 Werkzeugen können veröffentlichen, etwa publish_documents, unpublish_documents, deploy_schema.
• 4 von 15 Werkzeugen legen Daten an oder ändern sie, etwa create_documents, patch_documents, create_release.
• Anmeldung über OAuth (Standard) oder API-Token: Der Server handelt mit den Rechten deines Kontos.

Lass löschende, sendende und ausführende Werkzeuge nur nach Bestätigung je Aktion laufen und verbinde zuerst ein Testkonto.

Standard ist OAuth, der Server handelt dann im Namen deines Sanity-Kontos. Alternativ trägst du ein API-Token im Header Authorization ein; dann gelten Rolle und Rechte des Tokens. Tokens entstehen unter sanity.io/manage oder per CLI. Der Server liest und schreibt; Änderungen über patch_documents landen im Entwurf oder in einer Release-Version und nicht direkt im veröffentlichten Dokument; veröffentlicht wird erst mit publish_documents.

Liest

Dokumente, Schemas, Releases, Projekte, Organisationen, Datasets, CORS-Origins, Embeddings-Indizes und Media-Library-Inhalte, soweit dein Konto oder Token sie sehen darf.

Ändert

Legt Dokumente als Entwurf an, ändert sie und veröffentlicht oder verwirft Entwürfe, legt Releases, Versionen, Projekte, Datasets und CORS-Origins an, deployt Schemas und Studios, lädt Assets hoch und pflegt Media-Library-Metadaten.

Kann nicht

Releases planen, veröffentlichen, archivieren oder löschen sowie Ordner und Versionsverlauf von Media-Library-Assets ändern.

Belege

Beleg 2

Technische Prüfung

Ungeprüft

Datenschutz

Was der Server kann

• Fragt Dokumente per GROQ ab, holt einzelne Dokumente über ihre ID und durchsucht Embeddings-Indizes semantisch.
• Legt Dokumente als Entwürfe an, ändert sie mit bis zu 25 Dokumenten je Aufruf, veröffentlicht Entwürfe, setzt Veröffentlichtes zurück in den Entwurf und verwirft Entwürfe.
• Legt Releases an, listet sie auf und erzeugt Dokumentversionen für ein Release, getrennt von den Entwürfen.
• Liest und deployt Schemas und stellt auf Wunsch ein gehostetes Studio dafür bereit.
• Verwaltet Projekte, Datasets und CORS-Origins; ein neues Projekt entsteht samt Dataset und API-Tokens.
• Lädt Bilder und Dateien von einer öffentlichen URL in ein Dataset oder die Media Library; für ein Dataset gibt es auch einen Einmal-Upload-Link für Dateien bis 50 MiB.
• Erzeugt per KI Bilder für ein Dokumentfeld oder verändert vorhandene Bilder.
• Fragt die Media Library ab und pflegt Titel, Aspekte und Sammlungen der Assets.

Belege Beleg 2

Grenzen

• Releases lassen sich über den Server nicht planen, veröffentlichen, archivieren oder löschen; das geht nur im Sanity Studio oder über die HTTP Actions API.
• Die Werkzeuge zum Erzeugen und Verändern von Bildern verbrauchen AI-Credits, die übrigen in der Regel nicht.
• Per OAuth angemeldete Sitzungen laufen meist nach 7 Tagen ab.
• Ordnerzuordnung und Versionsverlauf von Media-Library-Assets lassen sich nicht ändern, nur in der Media-Library-App.

Belege Beleg 2

Wenn etwas nicht klappt

Die Anmeldung scheitert mit einem Fehler wie 401 Unauthorized.

Wurde der Server per CLI eingerichtet, ist das erzeugte Token abgelaufen oder widerrufen; führe `npx sanity@latest mcp configure` erneut aus. Beleg 2

Bei manueller OAuth-Einrichtung hängt die erneute Anmeldung nach einigen Tagen.

Sitzungen laufen meist nach 7 Tagen ab. In Cursor hilft der Befehl "Cursor: Clear All MCP Tokens", in VS Code "Authentication: Remove Dynamic Authentication Providers"; danach den Server neu starten. Beleg 2

Einzelne Werkzeuge wie query_documents fehlen oder schlagen fehl.

Prüfe, ob dein Konto die nötigen Rechte für Projekt und Dataset hat; welche Werkzeuge es gibt, kann sich mit Updates ändern. Beleg 2