Storyblok MCP Server

Der Storyblok MCP Server verbindet Ihren KI-Assistenten direkt mit einem Space im Headless CMS Storyblok. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude, Cursor oder Codex externe Dienste ansprechen. Ein Headless CMS verwaltet Inhalte zentral und liefert sie über eine Schnittstelle an Websites und Apps aus. Hinter dem Server steht Storyblok selbst, ein 2017 in Österreich gegründetes Unternehmen mit rechtlichem Sitz in Linz. Storyblok hostet den Server unter mcp.storyblok.com. Sie installieren also nichts, sondern tragen nur eine Adresse in Ihren Client ein und melden sich an.

Wofür ist der Storyblok MCP Server nützlich?

Im Redaktionsalltag fallen viele kleine Aufgaben an, die im Backend mehrere Klicks kosten. Ein Beispiel: alle Stories eines Ordners finden, in denen ein bestimmter Block fehlt. Oder einer Komponente ein neues Feld geben, Tags vereinheitlichen und ein Bild hochladen. Mit dem MCP-Server beschreiben Sie solche Aufgaben in normaler Sprache. Der Assistent sucht die passende Operation der Management API heraus und führt sie aus. Die Management API ist die Schnittstelle, über die sich Inhalte, Komponenten-Schemas, Assets und Einstellungen eines Spaces verwalten lassen. Laut Storyblok eignet sich der Server vor allem für einmalige Änderungen und für exploratives Arbeiten, also zum Nachsehen, Prüfen und gezielten Anpassen.

So arbeitet der Server

Statt Hunderte einzelne Werkzeuge anzubieten, arbeitet der Server in drei Schritten. Zuerst sucht das Werkzeug search per Stichwort die passende Operation. Danach liefert describe die Parameter und das Schema dieser Operation. Zuletzt führt der Assistent sie aus. Dafür gibt es drei getrennte Werkzeuge: eines für reine Lesezugriffe, eines für Anlegen und Ändern und eines für das Löschen. Löschvorgänge verlangen laut Dokumentation eine ausdrückliche Bestätigung durch den Nutzer. Diese Trennung ist praktisch, weil Sie im Client gezielt festlegen können, welche Art von Zugriff ohne Rückfrage laufen darf. Über einen fields-Filter lassen sich große Antworten verkleinern. Für Assets gibt es ein eigenes Upload-Werkzeug. Der letzte Schritt des Uploads setzt allerdings Shell-Zugriff voraus, weil die Datei per cURL-Befehl übertragen wird.

Grenzen, die Sie kennen sollten

Storyblok ist in der Dokumentation erfreulich offen. Der Server greift nur auf die Management API zu. Veröffentlichte Inhalte über die Content Delivery API liest er nicht. Weil ein Sprachmodell jede Anfrage vermittelt, sind die Ergebnisse nicht deterministisch. Für Massenänderungen, CI/CD-Pipelines und Migrationen empfiehlt Storyblok daher ausdrücklich die Storyblok CLI. Außerdem gelten die normalen Rate Limits der Management API.

Anmeldung und Clients

Empfohlen ist die Anmeldung per OAuth. Beim ersten Verbinden öffnet sich der Browser, Sie melden sich bei Storyblok an und wählen genau die Berechtigungen und Spaces, die der Assistent nutzen darf. Für Skripte oder Clients ohne OAuth gibt es alternativ einen Personal Access Token als Bearer-Header. Storyblok dokumentiert eigene Anleitungen für Claude Code, Claude mit Eintrag im Connector-Verzeichnis, Cursor, VS Code, Codex und die Gemini CLI. Jeder andere Client mit HTTP-Transport nutzt dieselbe Adresse.

Kosten und Lizenz

Die Dokumentation nennt keine eigene Gebühr und keinen Mindestplan für den MCP-Server. Storyblok selbst bietet laut Preisseite einen kostenlosen Starter-Plan für Tests und persönliche Projekte. Dazu kommen kostenpflichtige Pläne und Enterprise-Tarife über den Vertrieb. Der gehostete Server ist nicht als Open Source veröffentlicht. Ein früheres GitHub-Repository aus der Experimentierphase ist inzwischen archiviert.

Für wen lohnt sich der Storyblok MCP Server?

Der Server lohnt sich für Content-Teams und Entwickler, die bereits mit Storyblok arbeiten und Routinearbeit im Space schneller erledigen wollen. Entwickler können Komponenten-Schemas prüfen oder anpassen, ohne zwischen Editor und API-Referenz zu wechseln. Redakteure finden Inhalte schneller und lassen Auffälligkeiten aufspüren. Im Vergleich zu den MCP-Servern anderer CMS wie Contentful, Sanity oder Strapi fällt die klare Trennung nach Lese-, Schreib- und Löschzugriff auf. Wer regelmäßig große Datenmengen verschiebt, bleibt bei der CLI.

Ein Storyblok-Konto mit Zugriff auf mindestens einen Space und ein Client mit Remote-MCP über HTTP, etwa Claude Code, Claude, Cursor, VS Code, Codex oder die Gemini CLI. Für Skripte alternativ ein Personal Access Token.

Mit dem Storyblok MCP Server verwaltet Ihr KI-Assistent Inhalte, Komponenten und Assets eines Storyblok-Spaces über die Management API. Storyblok hostet den Server unter https://mcp.storyblok.com/mcp. Dieser Ratgeber zeigt die Einrichtung in gängigen Clients und worauf Sie bei den Rechten achten sollten.

Schritt 1: Anmeldung vorab klären

Empfohlen ist OAuth. Beim ersten Verbinden öffnet sich der Browser, Sie melden sich bei Storyblok an und wählen die Berechtigungen und Spaces aus. Für Skripte oder Clients ohne OAuth erstellen Sie stattdessen einen Personal Access Token. Begrenzen Sie ihn auf die nötigen Spaces und Rechte und legen Sie ihn in einer Umgebungsvariablen ab, nicht im Repository.

Claude Code

Führen Sie claude mcp add --transport http Storyblok https://mcp.storyblok.com/mcp aus. Mit --scope user oder --scope project legen Sie fest, wo der Eintrag gilt. Danach rufen Sie /mcp auf, wählen Storyblok und melden sich im Browser an.

Claude

Öffnen Sie Settings, Customize und Connectors, suchen Sie über Browse connectors nach Storyblok und klicken Sie auf Connect. In Organisationen muss ein Owner den Connector freigeben. Fehlt Storyblok im Verzeichnis, legen Sie einen Custom Connector mit der Server-Adresse an und lassen die OAuth-Felder leer.

Cursor und VS Code

In Cursor tragen Sie in .cursor/mcp.json unter mcpServers einen Eintrag Storyblok mit der url https://mcp.storyblok.com/mcp ein. In VS Code heißt der Schlüssel in .vscode/mcp.json servers statt mcpServers, und der Eintrag braucht zusätzlich type http. In beiden Editoren bestätigen Sie danach die Anmeldung.

Codex und Gemini CLI

Für Codex ergänzen Sie in ~/.codex/config.toml einen Abschnitt mcp_servers.storyblok mit der url und starten die Anmeldung mit codex mcp login storyblok. In der Gemini CLI tragen Sie in ~/.gemini/settings.json die Adresse als httpUrl ein und setzen authProviderType auf dynamic_discovery.

Sicher arbeiten

Geben Sie nur die Rechte und Spaces frei, die der Assistent wirklich braucht. Lassen Sie geplante Operationen vor dem Ausführen beschreiben und prüfen Sie vor dem Löschen IDs und Blocknamen. Neue Abläufe testen Sie am besten zuerst in einer eigenen Environment. Für Massenänderungen und Migrationen ist die Storyblok CLI das bessere Werkzeug.

claude mcp add --transport http Storyblok https://mcp.storyblok.com/mcp

OAuth im Browser (empfohlen), dabei Auswahl der Berechtigungen und Spaces. Alternativ ein Personal Access Token, der als Bearer-Header mitgeschickt wird, möglichst eng auf die nötigen Spaces und Rechte beschränkt.

Lesen, Anlegen, Ändern und Löschen über die Management API, soweit die freigegebenen Berechtigungen reichen: Stories, Komponenten-Schemas, Assets, Tags und weitere Einstellungen eines Spaces. Löschen nur nach ausdrücklicher Bestätigung.

Anfragen laufen über den von Storyblok gehosteten Server an die Management API. Inhalte aus dem Space gehen im Chat zusätzlich an den jeweiligen KI-Anbieter. Tokens gehören laut Storyblok nicht in die Versionskontrolle und werden bei einem Leck sofort widerrufen.

Mittel. Der Assistent kann Inhalte und Schemas ändern oder löschen. Ein präparierter Text mit versteckten Anweisungen kann ungewollte Änderungen auslösen. Storyblok rät zu minimalen Rechten, zur Prüfung geplanter Operationen, zur Kontrolle von IDs vor dem Löschen und zu Tests in einer eigenen Environment.