Cómo conectar Algolia a Claude vía MCP

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

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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Algolia, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

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

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse