Guía de conector8 minutos de lectura30 herramientas MCP7 idiomas

Storyblok MCP Server: stories, assets y releases

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

HCPor el equipo de HelpCodeActualizado 8 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Storyblok

Storyblok

Storyblok headless CMS through the Management API: stories and folders with their block content, create, update, publish and unpublish, component schemas, asset metadata, datasources, workflow stages and releases, in the EU, US, CA, AP or CN region.

herramientas

30

Región

INTL

Categoría

CMS

Autenticación

API Key

Env vars requeridas

STORYBLOK_PERSONAL_ACCESS_TOKENSTORYBLOK_SPACE_IDSTORYBLOK_API_HOST
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Sáltate la instalación. Funcionando en menos de 2 minutos.

Inicia una prueba gratuita en cloud.anythingmcp.com, añade Storyblok con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.

Empezar prueba gratis

Resumen

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Prueba a pedir

Prompts de ejemplo para Storyblok

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Storyblok · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Storyblok, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Storyblok

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Configuración

La configuración lleva unos 3 minutos. Necesitas un space de Storyblok, su id numérico y la región en la que se creó.

  1. En Storyblok abre My account > Account settings > Personal access tokens, genera un token y pégalo en STORYBLOK_PERSONAL_ACCESS_TOKEN. Storyblok lo recibe tal cual en la cabecera Authorization, sin el prefijo Bearer. El token actúa con tus propios permisos en cada space que puedes abrir, así que un usuario con un rol restringido da un token más limitado.
  2. STORYBLOK_SPACE_ID: el id numérico en Settings > Space, también en la URL de la app después de #/me/spaces/, por ejemplo 288868932106293.
  3. STORYBLOK_API_HOST: el host de la Management API de la región donde se creó el space: mapi.storyblok.com (UE), api-us.storyblok.com (EE. UU.), api-ca.storyblok.com (Canadá), api-ap.storyblok.com (Australia) o app.storyblokchina.cn (China). Solo el host, sin https://.
  4. Instala el conector y ejecuta storyblok_get_space: muestra el nombre, el plan, los idiomas y el número de stories del space y confirma los tres valores.

También borradores: la Management API lee borradores además del contenido publicado, así que no hace falta un token de la Content Delivery API.

Qué lee:

  • Stories y carpetas con storyblok_list_stories, sin su contenido: filtros por carpeta (starts_with), by_slugs, search, text_search, etiquetas, filter_query sobre campos del contenido, estado de publicación, etapa de workflow, release o papelera.
  • Una story con su árbol completo de bloques (storyblok_get_story): cada bloque con component y _uid, más traducciones, etiquetas, etapa de workflow e información de release. storyblok_list_story_versions muestra su historial con evento, autor y hora.
  • Los esquemas de bloques con storyblok_list_components y storyblok_get_component: cada campo con tipo, obligatoriedad, opciones y bloques permitidos, y las carpetas de componentes.
  • Metadatos de assets: nombre de archivo como URL, título, texto alternativo, copyright, punto de enfoque, carpeta, etiquetas, tamaño e indicador de privado; carpetas de assets y etiquetas internas.
  • Datasources y sus entradas (la clave en name, el valor en value, opcionalmente por dimensión, como un idioma).
  • Workflows por tipo de contenido, sus etapas y el historial de etapas de una story; releases con su programación y estado.

Qué escribe:

  • storyblok_create_story crea una story o una carpeta, guardada como borrador salvo que publish sea true. La raíz del contenido necesita component con un bloque de tipo de contenido; los bloques anidados van en arrays y necesitan un _uid. La IA consulta antes el esquema con storyblok_list_components.
  • storyblok_update_story sustituye el contenido completo: la IA lee la story con storyblok_get_story, la cambia y devuelve el árbol entero de bloques. publish true también publica.
  • storyblok_publish_story y storyblok_unpublish_story, opcionalmente solo para algunos idiomas. Storyblok las ejecuta como peticiones GET, pero cambian el sitio en vivo, así que cuentan como escrituras.
  • storyblok_update_asset cambia texto alternativo, título, copyright, fuente, carpeta, etiquetas y el indicador de privado o bloqueado; el archivo no cambia. storyblok_create_datasource_entry y storyblok_update_datasource_entry mantienen listas clave-valor.
  • storyblok_change_workflow_stage mueve una story a otra etapa, asigna usuarios o roles y les avisa con un comentario.
  • storyblok_create_release y storyblok_update_release; do_release: true publica de una vez todos los cambios de stories de la release. Un cambio de story entra en una release con release_id al crear o actualizar.

Desactivadas al instalar: storyblok_delete_story (una carpeta se va con todas sus stories, que desaparecen de inmediato de la delivery API) y storyblok_delete_asset (las stories que aún apuntan a su URL muestran un archivo roto). No se pueden deshacer con este conector, así que un admin del workspace las activa cuando el equipo las necesita.

Formatos de datos: los ids son números y los campos uuid son UUID. full_slug es la ruta de una story; published y unpublished_changes indican su estado. El filename de un asset es su URL pública. Las horas son ISO 8601 en UTC; release_at acepta YYYY-MM-DD HH:mm.

Paginación: stories, versiones, assets, datasources y entradas de datasources usan page (desde 1) y per_page (25 por defecto, como máximo 100, o 1.000 para entradas de datasources). El total llega en la cabecera total, mostrada como _headers.total. Una página más allá del final devuelve una lista vacía.

Límites: 3 peticiones por segundo en el plan Starter y 6 en planes superiores; 429 significa ir más despacio.

Errores comunes: 401 indica un token incorrecto o un host de región que no corresponde al space. 404 indica un id de space incorrecto o un elemento desconocido. 422 indica una story no válida, y el mensaje nombra el campo.

El conector no sube archivos, no usa la Content Delivery API y no cambia los esquemas de componentes.

Requisitos previos: STORYBLOK_PERSONAL_ACCESS_TOKEN, STORYBLOK_SPACE_ID, STORYBLOK_API_HOST

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Storyblok e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

ToolWhat it does
storyblok_get_spaceThe connected space: name, id, plan, default domain, languages, the release and workflow features in use and the story count
storyblok_list_storiesList stories (content entries and folders) of the space without their content: id, uuid, name, slug, full_slug, content_type, published…
storyblok_get_storyOne story with its full content (the block tree under content, each block with component and _uid), slug, published state, translations…
storyblok_list_story_versionsVersion history of a story, newest first: version id, event (published, saved, ...), author and time, and whether the version is a draft
storyblok_create_storyCreate a story or a folder
storyblok_update_storyUpdate a story
storyblok_publish_storyPublish a story so the Content Delivery API serves the current version
storyblok_unpublish_storyUnpublish a story: it disappears from the published content until it is published again
storyblok_delete_storyDelete a story, or a folder with its stories, by id
storyblok_list_componentsThe block schemas (components) of the space: name, display_name, is_root (content type) or nestable, the schema with every field and its…
storyblok_get_componentOne block schema by id with all fields (type, required, options, allowed blocks), preview field and folder
storyblok_list_component_foldersComponent folders (groups) with id, uuid, name and parent folder, used by in_group
storyblok_list_assetsList assets (images, videos, files) with id, filename (the URL), title, alt, copyright, focus, folder, tags, size and private flag
storyblok_get_assetOne asset's metadata by id: filename URL, title, alt, copyright, source, focus point, folder, internal tags and size
storyblok_update_assetUpdate an asset's metadata: alt text, title, copyright and source (meta_data), folder, internal tags, private or locked flag
storyblok_delete_assetDelete an asset by id
storyblok_list_asset_foldersAsset folders with id, uuid, name and parent_id, for in_folder and asset_folder_id
storyblok_list_internal_tagsInternal tags used to organise assets and components, with id, name and object type
storyblok_list_datasourcesDatasources (key-value lists used for options and translations) with id, name, slug and dimensions
storyblok_list_datasource_entriesEntries 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_entryAdd a key-value entry (name is the key, value the value) to a datasource
storyblok_update_datasource_entryChange a datasource entry's key or value, or its value for one dimension (dimension_id and dimension_value)
storyblok_list_workflowsWorkflows that apply to a content type, with their stages
storyblok_list_workflow_stagesWorkflow stages with id, name, color, the next allowed stages, who may publish and the workflow they belong to
storyblok_list_workflow_stage_changesHistory of workflow stage changes of one story: stage, user and time
storyblok_change_workflow_stageMove a story to another workflow stage, optionally assigning users or roles and notifying them with a comment
storyblok_list_releasesReleases (bundles of story changes published together): id, name, scheduled release_at, released flag and branches to deploy
storyblok_get_releaseOne release by id: name, release_at, released state, owner and branches to deploy
storyblok_create_releaseCreate a release to collect story changes, optionally scheduled for a time
storyblok_update_releaseRename or reschedule a release, or deploy it now with do_release true, which publishes every story change it holds

Ejemplos de prompts

  • "Lista las stories bajo blog/ que tienen cambios sin publicar."
  • "Muéstrame el contenido de la story home y qué bloques usa."
  • "Corrige la errata "recieve" en la story de preguntas frecuentes y publícala."
  • "¿Qué imágenes de la biblioteca de assets no tienen texto alternativo? Propón uno para las diez primeras."
  • "Mueve la story de la página de precios a la etapa Review y avisa al rol de marketing con un comentario."

Siguientes pasos

¿Te ha sido útil esta guía?

Tu agente de Storyblok está a un clic.

Instala el conector, pega la clave y pregunta a tu cliente de IA. 7 días gratis, sin tarjeta de crédito.

Guías relacionadas

Conectores

Conectar Storyblok MCP con ChatGPT: stories y assets

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Conectores

Conectar Storyblok MCP con Claude: stories y releases

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Conectores

Conectar Storyblok MCP con Cursor: stories y esquemas

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Conectores

Conectar Storyblok MCP con Gemini CLI

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Conectores

Conectar Storyblok MCP con Meta Muse

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.

Conectores

Conectar Storyblok MCP con Microsoft Copilot

El CMS headless Storyblok mediante la Management API: busca y lee stories y carpetas con su contenido completo por bloques y su historial de versiones, crea, actualiza, publica y despublica stories, lee los esquemas de componentes y gestiona metadatos de assets, entradas de datasources, etapas de workflow y releases, en la región UE, EE. UU., Canadá, Australia o China.