Cómo conectar Prismic a ChatGPT 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 + ChatGPT

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 ChatGPT

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.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Prismic.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

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

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

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