Cómo conectar Prismic a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Prismic, instálalo sin clave, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Prismic + Microsoft Copilot

El page builder headless Prismic, sin clave para un repositorio público: consulta documentos publicados y programados con filtros de Prismic, lee documentos por id, UID o tipo, lee los modelos de custom types y slices, explora y sube medios, y crea o actualiza borradores de documentos mediante la Migration API.

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:

PRISMIC_REPOSITORY (opcional: PRISMIC_ACCESS_TOKEN, PRISMIC_WRITE_TOKEN)

Paso 1 — Configurar el conector

Repositorio público, sin clave: la configuración lleva unos 3 minutos. El conector lee un repositorio de Prismic mediante la Content API (https://<repository>.cdn.prismic.io/api/v2). Cuando esa API es pública, basta con el nombre del repositorio. Los modelos de contenido, los medios y las escrituras pasan por las API de escritura de Prismic (la Types API, la Asset API y la Migration API) y necesitan un write token.

1. PRISMIC_REPOSITORY: el nombre del repositorio, la parte anterior a .prismic.io en la URL del panel, por ejemplo your-repo-name.
2. PRISMIC_ACCESS_TOKEN (opcional): solo si la Content API es privada. En el repositorio abre Settings > API & Security y genera un access token, o ejecuta npx prismic token create. Déjalo vacío para una API pública.
3. PRISMIC_WRITE_TOKEN (opcional): necesario para cada herramienta marcada con "Needs the write token" y para todas las escrituras. Abre Settings > API & Security > Write APIs y genera un token, o ejecuta npx prismic token create --write. Se envía como Authorization: Bearer <token> junto con la cabecera repository. Tiene permisos amplios, así que confíalo solo a workspaces de confianza.
4. Instala el conector y ejecuta prismic_get_repository para comprobar el nombre del repositorio.

El servidor MCP propio de Prismic: Prismic también ofrece un servidor MCP (https://mcp.prismic.io/mcp, inicio de sesión con OAuth) para editar y publicar desde un asistente. Este conector es la alternativa basada en tokens.

Leer contenido en dos pasos:

1. prismic_get_repository devuelve refs. La IA toma el ref de la entrada con isMasterRef: true para el contenido publicado, o el ref de una release para previsualizar contenido programado. Toda consulta de contenido lo necesita, y cambia con cada publicación. La misma respuesta lista los custom types, etiquetas, idiomas y bookmarks.
2. Después prismic_search_documents con filtros en q, prismic_get_document por id, prismic_get_document_by_uid por tipo y UID (por ejemplo tipo page y uid about-us), o prismic_list_documents_by_type. lang, fetch_links y graph_query dan forma a la respuesta.

Filtros (q): [[at(document.type,"blog_post")]]; varios filtros seguidos se combinan: [[at(document.type,"blog_post")][any(document.tags,["news","events"])]]. Otros: fulltext(document,"text"), at(my.blog_post.author,"<id>"), date.after(document.first_publication_date,"2026-01-01"), not, in(document.id,[...]), number.lt(my.product.price,100). Para ordenar se usa orderings, por ejemplo [my.blog_post.date desc].

Modelos y medios (write token): prismic_list_custom_types y prismic_get_custom_type dan la estructura de campos de cada tipo de página, con pestañas, slice zones, repetible o único, y estado; prismic_list_shared_slices y prismic_get_shared_slice, las shared slices con sus variaciones. prismic_list_assets explora la biblioteca de medios por tipo o palabra clave, prismic_upload_asset sube un archivo desde una URL pública y devuelve el id del asset, y prismic_update_asset edita el texto alternativo, los créditos y las notas.

Escribir documentos (write token): prismic_create_document y prismic_update_document guardan borradores en una migration release. No están publicados hasta que un editor publica esa release en el panel (pestaña Migration Releases); estas API no tienen llamada de publicación. La IA construye data a partir del modelo del custom type: el texto enriquecido es una lista de bloques ({"type": "paragraph", "text": "...", "spans": []}), las imágenes y medios llevan un id de asset, los enlaces {"link_type": "Document", "id": "..."} o {"link_type": "Web", "url": "..."}. Una actualización sustituye todo el contenido y las etiquetas, así que la IA lee primero el documento y lo devuelve completo. El tipo y el idioma no se pueden cambiar.

Nada está desactivado al instalar: no hay herramientas de borrado ni de publicación. Cambiar los modelos de contenido y borrar quedan para el panel o la CLI de Prismic.

Formatos de datos: las listas de contenido llevan results, page, total_pages, total_results_size y next_page. Los campos de texto enriquecido llegan como listas de bloques; las fechas son YYYY-MM-DD y las marcas de tiempo ISO 8601. Los ids de documento tienen la forma ZMI65RQAADkECUFM.

Paginación: page (desde 1) y page_size (20 por defecto, como máximo 100), o orderings junto con after y el id del último documento. Los assets se paginan con cursor.

Límites: la Content API permite 200 peticiones sin caché por segundo y URLs de hasta 2.048 caracteres, así que la IA mantiene corta la graph_query. La Migration API y la Asset API aceptan una petición por segundo y repositorio.

Errores comunes: 404 en prismic_get_repository indica un nombre de repositorio incorrecto. 401 o 403 indica una API privada sin un access token válido, o una escritura sin un write token válido. 400 indica un filtro mal formado o un ref no válido, 422 datos que no encajan en el modelo.

El conector no publica documentos, no borra documentos ni assets y no cambia custom types ni slices.

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 Prismic.
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 diez entradas de blog más recientes con su título y fecha de primera publicación."
• "Muéstrame la página about-us y resume sus slices."
• "¿Qué documentos tienen la etiqueta news y se publicaron por primera vez después del 1 de enero de 2026?"
• "¿Qué campos tiene el custom type blog_post?"
• "Crea un borrador de entrada de blog titulado "Nuestra hoja de ruta 2026" con un párrafo introductorio breve, para que lo revise un editor."

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