Prismic a MCP: documentos, custom types, slices, biblioteca de medios y escritura de borradores en cualquier agente de IA

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

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.

Configuración

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.

Requisitos previos: PRISMIC_REPOSITORY (opcional: PRISMIC_ACCESS_TOKEN, PRISMIC_WRITE_TOKEN)

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 Prismic, introduce el nombre del repositorio e instálalo. Los dos tokens son opcionales.

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

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT