Conectar Algolia MCP con Microsoft Copilot

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

Algolia + Microsoft Copilot

Deja que tu IA busque y revise tus índices de Algolia: lista índices, busca y recorre registros, lee ajustes, sinónimos y Rules, consulta las búsquedas más frecuentes y las que no dan resultados y, con tu confirmación, añade o actualiza registros.

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:

ALGOLIA_APP_ID, ALGOLIA_API_KEY, ALGOLIA_ANALYTICS_REGION

Paso 1 — Obtener credenciales

1. Abre el panel de Algolia en Settings → API Keys (https://dashboard.algolia.com/account/api-keys) y copia el Application ID en ALGOLIA_APP_ID.
2. Crea una clave propia en All API keys → New API key en lugar de reutilizar la clave Admin. Ponle una descripción como AnythingMCP, si quieres limítala a algunos índices y dale la ACL search, browse, listIndexes, settings y analytics. Pégala en ALGOLIA_API_KEY.
3. Pon ALGOLIA_ANALYTICS_REGION a us o de, la región de analítica que muestra el panel en Settings → Infrastructure → Analytics. La mayoría de las aplicaciones usan us.
4. Instala el conector. La comprobación de conexión lista tus índices, igual que algolia_list_indices.

Por qué no la clave Search-Only: la comprobación de conexión necesita la ACL listIndexes. La Search-Only API key predeterminada de Algolia solo tiene search, así que falla la comprobación con 403 "Method not allowed with this API key", aunque la búsqueda en sí funcionaría. Crea en su lugar la clave de lectura propia del paso 2. Tampoco uses la Admin API key: puede borrar índices y gestionar claves, y ninguna herramienta de aquí lo necesita. La ACL, los límites de índices y el rate limit de cada clave aparecen en Settings → API Keys → All API keys.

Qué puede hacer la IA: buscar en un índice igual que tu web, con tolerancia a errores tipográficos, filtros como brand:Apple AND price < 500, recuentos de facetas y paginación (10 resultados por defecto, como máximo 100); leer registros en bloque con algolia_browse; y leer registros sueltos, ajustes del índice, sinónimos y Rules para explicar por qué los resultados se ordenan así. Las búsquedas que hace la IA no cuentan en tu analítica.

Analítica de búsquedas: algolia_top_searches, algolia_no_result_searches (lo que la gente busca y no encuentra), algolia_top_hits y algolia_search_count. El periodo por defecto son los últimos 8 días. La analítica llega con un retraso de hasta unas horas, y un índice necesita tráfico antes de tener datos.

Las escrituras preguntan antes: algolia_save_object añade un registro o lo sustituye por completo, y algolia_partial_update_object cambia algunos de sus atributos. Antes de cada una, la IA te muestra el índice, el objectID y el contenido y espera tu sí. Ambas necesitan además la ACL addObject, así que una clave de lectura sigue siendo solo de lectura. Algolia aplica los cambios en segundo plano y se pueden buscar un momento después.

Desactivada al instalar: algolia_delete_object, que borra un registro para siempre. Un administrador la activa de forma deliberada, y necesita la ACL deleteObject.

Errores comunes: 403 "Invalid Application-ID or API key": el Application ID o la clave son incorrectos, o la clave se borró. 401 "Invalid credentials" significa lo mismo en la Analytics API; revisa también la región de analítica. 403 "Method not allowed with this API key": a la clave le falta una ACL. "Index not allowed with this API key": la clave está limitada a otros índices. 404: el índice o el registro no existe; los nombres de índice distinguen mayúsculas y minúsculas. 429: la clave alcanzó su rate limit.

El conector no crea, copia ni borra índices, no cambia ajustes, sinónimos ni Rules, no gestiona API keys y no cubre eventos de Insights, Recommend, Query Suggestions ni el Crawler.

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 Algolia.
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é índices de Algolia tenemos y cuántos registros tiene cada uno?"
• "¿Qué buscó más la gente en el índice products en los últimos 30 días y qué búsquedas no dieron resultados?"
• "Busca zapatillas de running en el índice products con el filtro brand:Nike y muéstrame los 10 primeros con su precio."
• "¿Por qué el registro 4711 sale tan abajo para 'zapatillas'? Revisa los ajustes del índice, los sinónimos y las Rules."
• "Cambia el precio del registro 4711 del índice products a 89,90. Muéstrame antes el cambio."

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