Conectar Storyblok MCP con Microsoft Copilot

💡 ¿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 + 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.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

STORYBLOK_PERSONAL_ACCESS_TOKEN, STORYBLOK_SPACE_ID, STORYBLOK_API_HOST

Paso 1 — Obtener credenciales

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.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Storyblok.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

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

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse