Zusammenfassung
Das Headless CMS Storyblok über die Management API: Stories und Ordner mit vollständigem Block-Inhalt und Versionsverlauf finden und lesen, Stories anlegen, ändern, veröffentlichen und zurückziehen, Komponentenschemas lesen, Asset-Metadaten, Datasource-Einträge, Workflow-Stufen und Releases verwalten, in der Region EU, USA, Kanada, Australien oder China.
Geführte Einrichtung
Storyblok in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Storyblok in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Storyblok
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Storyblok klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Storyblok
Das Headless CMS Storyblok über die Management API: Stories und Ordner mit vollständigem Block-Inhalt und Versionsverlauf finden und lesen, Stories anlegen, ändern, veröffentlichen und zurückziehen, Komponentenschemas lesen, Asset-Metadaten, Datasource-Einträge, Workflow-Stufen und Releases verwalten, in der Region EU, USA, Kanada, Australien oder China.
Einrichtung
Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Storyblok-Space, seine numerische ID und die Region, in der er angelegt wurde.
- Öffne in Storyblok My account > Account settings > Personal access tokens, erstelle einen Token und trag ihn in
STORYBLOK_PERSONAL_ACCESS_TOKENein. Storyblok nimmt ihn unverändert im HeaderAuthorization, ohne Bearer-Präfix. Der Token handelt mit deinen eigenen Rechten in jedem Space, den du öffnen kannst; ein Nutzer mit eingeschränkter Rolle ergibt also einen engeren Token. STORYBLOK_SPACE_ID: die numerische ID unter Settings > Space, auch in der App-URL nach#/me/spaces/, zum Beispiel288868932106293.STORYBLOK_API_HOST: der Management-API-Host der Region, in der der Space angelegt wurde:mapi.storyblok.com(EU),api-us.storyblok.com(USA),api-ca.storyblok.com(Kanada),api-ap.storyblok.com(Australien) oderapp.storyblokchina.cn(China). Nur der Host, ohnehttps://.- Installiere den Connector und führe
storyblok_get_spaceaus: Er zeigt Name, Plan, Sprachen und Zahl der Stories des Space und bestätigt alle drei Werte.
Auch Entwürfe: Die Management API liest Entwürfe genauso wie veröffentlichte Inhalte, ein Token für die Content Delivery API ist also nicht nötig.
Was er liest:
- Stories und Ordner mit
storyblok_list_stories, ohne Inhalt: Filter nach Ordner (starts_with),by_slugs,search,text_search, Tags,filter_queryauf Inhaltsfelder, Veröffentlichungsstatus, Workflow-Stufe, Release oder Papierkorb. - Eine Story mit ihrem vollständigen Block-Baum (
storyblok_get_story): jeder Block mitcomponentund_uid, dazu Übersetzungen, Tags, Workflow-Stufe und Release-Infos.storyblok_list_story_versionszeigt ihren Verlauf mit Ereignis, Autor und Zeit. - Die Block-Schemas mit
storyblok_list_componentsundstoryblok_get_component: jedes Feld mit Typ, Pflicht-Flag, Optionen und erlaubten Blöcken, dazu die Komponentenordner. - Asset-Metadaten: Dateiname als URL, Titel, Alt-Text, Copyright, Fokuspunkt, Ordner, Tags, Größe und Privat-Flag; Asset-Ordner und interne Tags.
- Datasources und ihre Einträge (der Schlüssel in
name, der Wert invalue, optional je Dimension wie eine Sprache). - Workflows je Content-Typ, ihre Stufen und den Stufenverlauf einer Story; Releases mit Zeitplan und Status.
Was er schreibt:
storyblok_create_storylegt eine Story oder einen Ordner an, als Entwurf, außerpublishist true. Die Inhaltswurzel brauchtcomponentmit einem Content-Typ-Block; verschachtelte Blöcke stehen in Arrays und brauchen eine_uid. Die KI liest vorher das Schema mitstoryblok_list_components.storyblok_update_storyersetzt den Inhalt als Ganzes: Die KI liest die Story mitstoryblok_get_story, ändert sie und schickt den vollständigen Block-Baum zurück.publishtrue veröffentlicht zusätzlich.storyblok_publish_storyundstoryblok_unpublish_story, optional nur für einige Sprachen. Storyblok führt sie als GET-Anfragen aus, sie ändern aber die Live-Website und zählen deshalb als Schreibzugriffe.storyblok_update_assetändert Alt-Text, Titel, Copyright, Quelle, Ordner, Tags und das Privat- oder Sperr-Flag; die Datei selbst bleibt gleich.storyblok_create_datasource_entryundstoryblok_update_datasource_entrypflegen Schlüssel-Wert-Listen.storyblok_change_workflow_stageverschiebt eine Story in eine andere Stufe, weist Nutzer oder Rollen zu und benachrichtigt sie mit einem Kommentar.storyblok_create_releaseundstoryblok_update_release;do_release: trueveröffentlicht alle Story-Änderungen des Release auf einmal. Eine Story-Änderung kommt mitrelease_idbeim Anlegen oder Ändern in ein Release.
Bei der Installation ausgeschaltet: storyblok_delete_story (ein Ordner geht mit all seinen Stories, und sie verschwinden sofort aus der Delivery API) und storyblok_delete_asset (Stories, die noch auf die URL zeigen, zeigen eine kaputte Datei). Über diesen Connector lassen sie sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.
Datenformate: IDs sind Zahlen, uuid-Felder sind UUIDs. full_slug ist der Pfad einer Story; published und unpublished_changes zeigen ihren Zustand. Der filename eines Assets ist seine öffentliche URL. Zeiten sind ISO 8601 in UTC; release_at nimmt YYYY-MM-DD HH:mm.
Blättern: Stories, Versionen, Assets, Datasources und Datasource-Einträge nehmen page (ab 1) und per_page (Standard 25, höchstens 100, bei Datasource-Einträgen 1.000). Die Gesamtzahl kommt im Header total, angezeigt als _headers.total. Eine Seite hinter dem Ende liefert eine leere Liste.
Limits: 3 Anfragen pro Sekunde im Starter-Plan, 6 in höheren Plänen; 429 heißt langsamer machen.
Häufige Fehler: 401 bedeutet einen falschen Token oder einen Regions-Host, der nicht zum Space passt. 404 bedeutet eine falsche Space-ID oder ein unbekanntes Element. 422 bedeutet eine ungültige Story, die Meldung nennt das Feld.
Der Connector lädt keine Dateien hoch, nutzt die Content Delivery API nicht und ändert keine Komponentenschemas.
Voraussetzungen: STORYBLOK_PERSONAL_ACCESS_TOKEN, STORYBLOK_SPACE_ID, STORYBLOK_API_HOST
Connector lokal 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
Öffne http://localhost:3000/connectors/store, wähle Storyblok und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
storyblok_get_space | The connected space: name, id, plan, default domain, languages, the release and workflow features in use and the story count |
storyblok_list_stories | List stories (content entries and folders) of the space without their content: id, uuid, name, slug, full_slug, content_type, published… |
storyblok_get_story | One story with its full content (the block tree under content, each block with component and _uid), slug, published state, translations… |
storyblok_list_story_versions | Version history of a story, newest first: version id, event (published, saved, ...), author and time, and whether the version is a draft |
storyblok_create_story | Create a story or a folder |
storyblok_update_story | Update a story |
storyblok_publish_story | Publish a story so the Content Delivery API serves the current version |
storyblok_unpublish_story | Unpublish a story: it disappears from the published content until it is published again |
storyblok_delete_story | Delete a story, or a folder with its stories, by id |
storyblok_list_components | The block schemas (components) of the space: name, display_name, is_root (content type) or nestable, the schema with every field and its… |
storyblok_get_component | One block schema by id with all fields (type, required, options, allowed blocks), preview field and folder |
storyblok_list_component_folders | Component folders (groups) with id, uuid, name and parent folder, used by in_group |
storyblok_list_assets | List assets (images, videos, files) with id, filename (the URL), title, alt, copyright, focus, folder, tags, size and private flag |
storyblok_get_asset | One asset's metadata by id: filename URL, title, alt, copyright, source, focus point, folder, internal tags and size |
storyblok_update_asset | Update an asset's metadata: alt text, title, copyright and source (meta_data), folder, internal tags, private or locked flag |
storyblok_delete_asset | Delete an asset by id |
storyblok_list_asset_folders | Asset folders with id, uuid, name and parent_id, for in_folder and asset_folder_id |
storyblok_list_internal_tags | Internal tags used to organise assets and components, with id, name and object type |
storyblok_list_datasources | Datasources (key-value lists used for options and translations) with id, name, slug and dimensions |
storyblok_list_datasource_entries | Entries of a datasource (name is the key, value the value), optionally with the dimension_value of one dimension (e.g. a language) |
storyblok_create_datasource_entry | Add a key-value entry (name is the key, value the value) to a datasource |
storyblok_update_datasource_entry | Change a datasource entry's key or value, or its value for one dimension (dimension_id and dimension_value) |
storyblok_list_workflows | Workflows that apply to a content type, with their stages |
storyblok_list_workflow_stages | Workflow stages with id, name, color, the next allowed stages, who may publish and the workflow they belong to |
storyblok_list_workflow_stage_changes | History of workflow stage changes of one story: stage, user and time |
storyblok_change_workflow_stage | Move a story to another workflow stage, optionally assigning users or roles and notifying them with a comment |
storyblok_list_releases | Releases (bundles of story changes published together): id, name, scheduled release_at, released flag and branches to deploy |
storyblok_get_release | One release by id: name, release_at, released state, owner and branches to deploy |
storyblok_create_release | Create a release to collect story changes, optionally scheduled for a time |
storyblok_update_release | Rename or reschedule a release, or deploy it now with do_release true, which publishes every story change it holds |
Beispiel-Prompts
- „Liste die Stories unter blog/, die unveröffentlichte Änderungen haben.“
- „Zeig mir den Inhalt der Story home und welche Blöcke sie verwendet.“
- „Korrigiere den Tippfehler „recieve“ in der FAQ-Story und veröffentliche sie.“
- „Welche Bilder in der Asset-Bibliothek haben keinen Alt-Text? Schlag Alt-Texte für die ersten zehn vor.“
- „Verschieb die Story der Preisseite in die Stufe Review und benachrichtige die Rolle Marketing mit einem Kommentar.“
Nächste Schritte
War dieser Guide hilfreich?