Cómo conectar Sanity a Gemini vía MCP

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

Sanity + Gemini

Deja que tu IA trabaje con tu contenido de Sanity: ejecuta consultas GROQ, lee documentos, sus revisiones y su historial de cambios, lista tipos de documento, datasets y proyectos, y crea, modifica y publica borradores tras tu confirmación. Token de API con permisos Viewer o Editor.

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:

SANITY_PROJECT_ID, SANITY_DATASET, SANITY_API_TOKEN

Paso 1 — Obtener credenciales

1. Abre https://www.sanity.io/manage, elige el proyecto y copia su Project ID (8 caracteres, por ejemplo abc12xyz) en SANITY_PROJECT_ID.

2. En Datasets, anota el dataset con el que trabajar, normalmente production, y ponlo en SANITY_DATASET.

3. En API → Tokens, haz clic en Add API token, ponle un nombre y elige el permiso:

   • Viewer lee documentos publicados y borradores, historial incluido. Basta para todas las herramientas de lectura; las escrituras se rechazan.
   • Editor también escribe. Hace falta para crear, modificar y publicar borradores.

   Evita los tokens Developer y Administrator: también pueden cambiar la configuración del proyecto y los datasets.

4. Copia el token en SANITY_API_TOKEN (Sanity lo muestra una sola vez) e instala el conector. Comprueba la configuración con sanity_list_document_types.

Consultas GROQ: sanity_query ejecuta GROQ sobre tu dataset, así la IA responde preguntas como "qué artículos no tienen descripción SEO" o "cuántos productos están agotados" en una sola llamada. Pide solo los campos que necesita, limita el número de resultados porque las respuestas de más de unos 60 KB se cortan, y pasa los valores como parámetros. Si aún no conoce tu esquema, primero lista los tipos de documento y mira algunos documentos. Con la perspectiva drafts lee el contenido como si todos los borradores estuvieran publicados.

Primero el borrador, publicado solo tras tu sí: sanity_create_draft y sanity_patch_draft solo escriben el borrador, la versión que los editores ven en Sanity Studio. Nada llega a tu web hasta que sanity_publish_draft sustituye el documento publicado. Antes de cada uno de estos pasos, la IA te muestra el documento, el cambio y si se publicará, y espera un sí claro. Una prueba en seco (dry run) comprueba una acción sin guardarla. sanity_delete_document se instala desactivada.

Historial: sanity_list_document_transactions muestra quién cambió un documento y cuándo, y sanity_get_document_revision devuelve el documento tal como era en una revisión o en un momento dado, por ejemplo para comparar dos versiones o recuperar un texto sobrescrito.

Texto enriquecido: los campos Portable Text son arrays de bloques, y cada bloque necesita una _key única. El conector explica a la IA cómo escribir párrafos sencillos.

Errores frecuentes: 401 Session not found: el token es incorrecto o se eliminó. 403 Insufficient permissions: un token Viewer intentó escribir, o el token pertenece a otro proyecto. 404 Dataset not found: revisa SANITY_DATASET. 400 queryParseError: la consulta GROQ tiene un error de sintaxis, y el mensaje indica dónde.

No incluido: subida de imágenes y archivos, content releases y publicación programada, despublicar, gestión de datasets y proyectos, webhooks, CORS, miembros y escucha en tiempo real.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Sanity.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué artículos del blog se publicaron en los últimos 30 días? Muestra título, autor y slug."
• "Encuentra todos los productos cuya descripción esté vacía o tenga menos de 50 caracteres."
• "¿Quién cambió por última vez la página de precios y qué decía antes de ese cambio?"
• "Corrige la errata 'lanzamineto' en el título del artículo sobre el lanzamiento de primavera. Guárdalo como borrador y enséñame el cambio antes de guardar."
• "Publica el borrador del artículo 'Novedades de octubre'. Dime antes exactamente qué se va a publicar."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT