Storyblok-Inhalte lesen, anlegen und ändern

Empfehlung

Für einzelne Änderungen und Erkundungen im Space taugt der Server, am bequemsten über den Storyblok-Connector in Claude. Für wiederholbare Massenänderungen, Migrationen und CI/CD empfiehlt Storyblok die CLI. Beleg 1 Beleg 2

Nicht geeignet, wenn

• Du brauchst wiederholbare Massenänderungen, Migrationen oder Abläufe in CI/CD: Dafür empfiehlt Storyblok die CLI. Beleg 1
• Du willst veröffentlichte Inhalte über die Content Delivery API lesen: Der Server bedient nur die Management API. Beleg 1
• Du willst Dateien hochladen, hast aber keinen Shell-Zugriff: Der Upload wird mit einem cURL-Befehl abgeschlossen. Beleg 1

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. Namen und Slugs aller Storys eines Ordners auflisten

   Für Redaktion

   Liest nur Beleg 1

   Prompt · ein Klick markiert den ganzen Text

   Liste im Storyblok-Space [Space-Name oder ID] alle Storys im Ordner [Ordnername] auf, nur mit Name und Slug, alphabetisch nach Slug sortiert. Nenne am Ende die Zahl der Storys. Ändere nichts.

   Ergebnis

   Eine alphabetische Liste mit Name und Slug jeder Story im Ordner plus die Gesamtzahl.

   Vorher prüfen

   Vergleiche Zahl und einige Einträge mit der Ansicht im Storyblok-Editor und prüfe, ob der richtige Space abgefragt wurde.

2. Uneinheitliche Slugs in einem Ordner aufspüren

   Für Redaktion und SEO

   Liest nur Beleg 1

   Prompt · ein Klick markiert den ganzen Text

   Lies im Space [Space-Name oder ID] die Storys im Ordner [Ordnername] mit Name und Slug. Finde Slugs, die doppelt vorkommen, Großbuchstaben, Umlaute oder Unterstriche enthalten oder vom Muster der übrigen abweichen, und liste sie mit einem Vorschlag, wie sie aussehen sollten. Ändere nichts.

   Ergebnis

   Eine Liste auffälliger Slugs mit Begründung und Vorschlag, ohne dass etwas im Space angepasst wird.

   Vorher prüfen

   Prüfe die Vorschläge in Ruhe, bevor jemand Slugs ändert, denn geänderte Adressen brauchen meist Weiterleitungen.

3. Ein einzelnes Feld in einer Story überarbeiten

   Für Redaktion

   Schreibt Beleg 1 Beleg 2

   Prompt · ein Klick markiert den ganzen Text

   Ändere in der Story [Story-Name oder Slug] im Space [Space-Name oder ID] das Feld [Feldname] auf [neuer Text]. Lies zuerst die Story und fasse die geplante Änderung mit Space, Story-ID und Feld zusammen. Führe sie erst nach meiner Bestätigung aus und ändere kein anderes Feld.

   Ergebnis

   Das genannte Feld der Story enthält den neuen Text, vorher als Zusammenfassung zur Bestätigung vorgelegt.

   Vorher prüfen

   Lies die Zusammenfassung auf Space, Story-ID und Feldnamen und öffne die Story danach im Editor, um das Ergebnis zu sehen. Eine Testumgebung (Sandbox-Space) senkt das Risiko.

Das brauchst du

Tarif

Die Doku nennt keinen bestimmten Storyblok-Tarif, nur einen Space, auf den du Zugriff hast.

Rolle

In Claude-Organisationen hängt das Verbinden von den Connector-Rechten der Organisation ab; ohne Recht fragst du die Admins über Request an.

Zeitbedarf

ca. 10 Minuten

Schätzung der Redaktion

Belege

Beleg 2

Einrichtung je Client

Rechte

• 3 von 7 Werkzeugen können Befehle ausführen, etwa execute_readonly, execute_mutating, execute_destructive.
• 2 von 7 Werkzeugen legen Daten an oder ändern sie, etwa upload_asset, upload_asset_finish.
• Anmeldung über OAuth (empfohlen) oder persönliches Zugriffstoken: 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.

Empfohlen ist OAuth: Bei der Anmeldung legst du Lese- und Schreibrechte fest und wählst die Spaces, die der Server nutzen darf. Alternativ ein Personal Access Token als Bearer-Header, am besten auf Spaces und Rechte begrenzt. Der Server liest, schreibt und löscht.

Liest

Inhalte und Einstellungen der freigegebenen Spaces über die Management API, etwa Storys und Assets, im Rahmen der Rechte, die du bei der Anmeldung erteilst.

Ändert

Legt Ressourcen wie Storys an und aktualisiert sie, legt Asset-Einträge an und löscht Ressourcen nach ausdrücklicher Bestätigung.

Kann nicht

Veröffentlichte Inhalte über die Content Delivery API lesen sowie Spaces oder Rechte nutzen, die du bei der Anmeldung nicht freigegeben hast.

Belege

Beleg 1 Beleg 2

Technische Prüfung

Ungeprüft

Datenschutz

Was der Server kann

• Findet passende Operationen der Management API per Stichwort und liefert deren Parameter und das Schema der Anfrage.
• Liest und listet Ressourcen eines Space, etwa Storys, und kürzt die Antwort auf die Felder, die du angefragt hast.
• Legt Ressourcen im Space an und aktualisiert vorhandene.
• Löscht Ressourcen, aber erst nach ausdrücklicher Bestätigung durch dich.
• Lädt Assets hoch, indem die KI einen Asset-Eintrag mit signierter Upload-URL anlegt und den Upload danach abschließt.

Belege Beleg 1

Grenzen

• Der Server bedient nur die Management API und liest keine veröffentlichten Inhalte über die Content Delivery API.
• Die Ergebnisse sind nicht deterministisch; für wiederholbare oder umfangreiche Massenänderungen empfiehlt Storyblok die CLI.
• Aufrufe unterliegen den Rate-Limits der Management API.
• Den Asset-Upload abzuschließen erfordert Shell-Zugriff, weil die Datei per cURL an S3 geht.

Belege Beleg 1