Cómo conectar Sanity a Microsoft Copilot 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 + Microsoft Copilot

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

• "¿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

¿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