Storyblok MCP mit Gemini CLI verbinden

💡 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 + Gemini

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.

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:

STORYBLOK_PERSONAL_ACCESS_TOKEN, STORYBLOK_SPACE_ID, STORYBLOK_API_HOST

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Storyblok-Space, seine numerische ID und die Region, in der er angelegt wurde.

1. Öffne in Storyblok My account > Account settings > Personal access tokens, erstelle einen Token und trag ihn in STORYBLOK_PERSONAL_ACCESS_TOKEN ein. Storyblok nimmt ihn unverändert im Header Authorization, 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.
2. STORYBLOK_SPACE_ID: die numerische ID unter Settings > Space, auch in der App-URL nach #/me/spaces/, zum Beispiel 288868932106293.
3. 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) oder app.storyblokchina.cn (China). Nur der Host, ohne https://.
4. Installiere den Connector und führe storyblok_get_space aus: 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_query auf Inhaltsfelder, Veröffentlichungsstatus, Workflow-Stufe, Release oder Papierkorb.
• Eine Story mit ihrem vollständigen Block-Baum (storyblok_get_story): jeder Block mit component und _uid, dazu Übersetzungen, Tags, Workflow-Stufe und Release-Infos. storyblok_list_story_versions zeigt ihren Verlauf mit Ereignis, Autor und Zeit.
• Die Block-Schemas mit storyblok_list_components und storyblok_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 in value, 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_story legt eine Story oder einen Ordner an, als Entwurf, außer publish ist true. Die Inhaltswurzel braucht component mit einem Content-Typ-Block; verschachtelte Blöcke stehen in Arrays und brauchen eine _uid. Die KI liest vorher das Schema mit storyblok_list_components.
• storyblok_update_story ersetzt den Inhalt als Ganzes: Die KI liest die Story mit storyblok_get_story, ändert sie und schickt den vollständigen Block-Baum zurück. publish true veröffentlicht zusätzlich.
• storyblok_publish_story und storyblok_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_entry und storyblok_update_datasource_entry pflegen Schlüssel-Wert-Listen.
• storyblok_change_workflow_stage verschiebt eine Story in eine andere Stufe, weist Nutzer oder Rollen zu und benachrichtigt sie mit einem Kommentar.
• storyblok_create_release und storyblok_update_release; do_release: true veröffentlicht alle Story-Änderungen des Release auf einmal. Eine Story-Änderung kommt mit release_id beim 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.

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Storyblok-Tools aufrufen.

Verfügbare Tools

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.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden