Conectar Contentful MCP con Microsoft Copilot

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

Contentful + Microsoft Copilot

Deja que tu IA trabaje con tu contenido de Contentful: busca entradas y assets, lee tipos de contenido, locales y etiquetas, y crea, cambia, publica o despublica entradas. Token de delivery para leer, token de management para escribir.

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:

CONTENTFUL_SPACE_ID, CONTENTFUL_ENVIRONMENT, CONTENTFUL_DELIVERY_URL, CONTENTFUL_DELIVERY_TOKEN

Paso 1 — Obtener credenciales

1. En Contentful (https://app.contentful.com), abre tu space y luego Settings → API keys → Add API key. Ponle un nombre (por ejemplo "AnythingMCP"), marca los environments que puede leer (al menos master) y guarda.
2. Copia el Space ID en CONTENTFUL_SPACE_ID y el Content Delivery API access token en CONTENTFUL_DELIVERY_TOKEN.
3. Pon en CONTENTFUL_ENVIRONMENT el id del environment, normalmente master. Los demás aparecen en Settings → Environments.
4. Pon en CONTENTFUL_DELIVERY_URL https://cdn.contentful.com, o https://cdn.eu.contentful.com para un space en la región de datos de la UE, sin barra final. Para que la IA lea también los borradores, usa https://preview.contentful.com (o https://preview.eu.contentful.com) junto con el Content Preview API access token de la misma clave.
5. Para escribir, crea un token de acceso personal: menú del avatar → Account settings → CMA tokens → Create personal access token. Elige una caducidad y copia el token enseguida, porque Contentful solo lo muestra una vez. Pégalo en CONTENTFUL_MANAGEMENT_TOKEN, sin la palabra Bearer, y pon en CONTENTFUL_MANAGEMENT_URL https://api.contentful.com (o https://api.eu.contentful.com). El token actúa en tu nombre, en cada space que puedes editar.
6. Si tu organización tiene que aprobar los tokens de acceso personal, un admin de la organización abre Organization settings, busca el token en los ajustes de acceso de los tokens de acceso personal y le concede acceso. Hasta entonces, las herramientas de escritura responden 401 OrganizationAccessGrantRequired; la lectura con el token de delivery no se ve afectada.
7. Instala el conector y empieza con contentful_get_space: devuelve el nombre del space y sus locales, una comprobación rápida de que el Space ID y el token de delivery van juntos.

Dos tokens, a propósito: el token de delivery lee el contenido publicado y nada más (también los borradores, con el token de preview), así que un conector configurado solo con los cuatro valores obligatorios puede consultarlo todo pero no cambia nada. Las escrituras, los borradores sin publicar, los spaces y los environments pasan por la Content Management API con el token de acceso personal. Si dejas vacíos CONTENTFUL_MANAGEMENT_URL y CONTENTFUL_MANAGEMENT_TOKEN, las herramientas de gestión simplemente avisan de que faltan.

Publicar cambia tu sitio en vivo: contentful_publish_entry y contentful_unpublish_entry cambian lo que ven los visitantes en tu web o tu app, así que la IA indica la entrada y el efecto y espera tu sí. contentful_delete_entry viene desactivada al instalar, porque una entrada borrada no se puede recuperar.

Cómo funcionan los cambios: contentful_list_content_types da los ids de los tipos de contenido y de los campos, contentful_list_locales los códigos de locale. Los valores de los campos van por id de campo y luego por locale, por ejemplo {"title": {"en-US": "Hello"}}. Antes de cada cambio la IA lee la entrada con contentful_get_entry_for_editing para obtener su sys.version actual; si otra persona guardó entretanto, Contentful responde 409 VersionMismatch y la IA vuelve a leer. contentful_update_entry sustituye todos los campos, así que lo que falte se borra; para uno o dos campos la IA usa contentful_patch_entry. Un cambio solo está en vivo cuando se publica la nueva versión.

Búsqueda: contentful_list_entries acepta un content_type, una búsqueda de texto completo query y otros filtros como fields.slug=hello o fields.date[gte]=2026-01-01. Para filtrar u ordenar por un campo hace falta content_type. Las entradas y los assets enlazados vuelven en includes, y las URL de los assets empiezan por //, así que la IA añade https:.

Paginación: las listas devuelven total, skip y limit (hasta 1.000); la página siguiente empieza en skip + limit.

Errores frecuentes: 401 AccessTokenInvalid significa un token incorrecto o caducado, o un token de delivery usado en el host de preview (o al revés). 404 NotFound es un id incorrecto, o un space o environment que el token no cubre: aquí Contentful responde 404, no 403. 400 "A Content Type ID is required" indica un filtro por campo sin content_type. 422 ValidationFailed nombra el campo vacío o que incumple una validación. 429 RateLimitExceeded: la management API permite unas 7 peticiones por segundo, así que espera y vuelve a intentarlo.

El conector no sube assets, no crea ni edita tipos de contenido, no gestiona environments, webhooks, roles ni apps y no usa la API GraphQL.

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

• "Busca los artículos del blog que publicamos en los últimos 30 días y lista el título, el slug y el autor de cada uno."
• "¿Qué entradas tienen cambios guardados que aún no están publicados?"
• "Lista las imágenes que subimos este mes, con su tamaño de archivo y sus dimensiones."
• "Cambia el titular de la landing page de las rebajas de primavera a 'Rebajas de primavera: 20% en todo' y publícala cuando lo confirme."

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