Cómo conectar Elasticsearch a Cursor vía MCP

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

Elasticsearch + Cursor

Deja que tu IA explore y consulte tu cluster de Elasticsearch en Elastic Cloud, Serverless o tus propios servidores: lista índices y data streams, lee mappings, busca, agrega, cuenta, ejecuta ES|QL y, con tu confirmación, escribe documentos.

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:

ELASTICSEARCH_URL, ELASTICSEARCH_API_KEY

Paso 1 — Obtener credenciales

1. Busca el endpoint de Elasticsearch. Elastic Cloud Hosted: abre el deployment en https://cloud.elastic.co y copia el Elasticsearch endpoint, por ejemplo https://my-deployment.es.europe-west3.gcp.cloud.es.io. Serverless: abre el proyecto y copia su endpoint de Elasticsearch. Autogestionado: la dirección HTTPS y el puerto en los que responde tu cluster, por ejemplo https://search.example.com:9200. Pégalo en ELASTICSEARCH_URL sin barra final. Usa el endpoint de Elasticsearch, no la dirección de Kibana.
2. Crea una API key en Kibana en Stack Management → API keys → Create API key (Serverless: ajustes del proyecto → API keys). Ponle un nombre, por ejemplo anythingmcp, una fecha de caducidad y activa Control security privileges para limitarla (ver abajo).
3. Copia el valor Encoded (base64): Elastic solo lo muestra una vez. Pégalo en ELASTICSEARCH_API_KEY e instala el conector. Los valores id y api_key por separado no funcionan, y no se admiten usuario y contraseña.
4. Comprueba la configuración con elasticsearch_whoami: no necesita privilegios y muestra a quién pertenece la clave.

Dónde corre tu cluster: Elastic Cloud Hosted, Elastic Cloud Serverless y clusters autogestionados, desde la versión 8. AnythingMCP Cloud necesita un cluster accesible desde internet; un AnythingMCP autoalojado también puede llegar a un cluster de tu propia red cuando un administrador permite ese host.

Clave de solo lectura (recomendada): usa estos role descriptors en el formulario de Kibana, o ejecuta la petición en Kibana Dev Tools y copia encoded de la respuesta:

POST /_security/api_key
{
  "name": "anythingmcp-read",
  "expiration": "365d",
  "role_descriptors": {
    "anythingmcp_read": {
      "cluster": ["monitor"],
      "indices": [
        { "names": ["*"], "privileges": ["read", "view_index_metadata", "monitor"] }
      ]
    }
  }
}

Sustituye "*" por los patrones de índice que puede ver la IA, por ejemplo ["products", "logs-*"]. read cubre búsqueda, recuento, agregaciones, ES|QL y documentos individuales; view_index_metadata cubre mappings, alias y data streams; monitor cubre la lista de índices y el estado del cluster. Una clave nunca tiene más permisos que el usuario que la crea.

Qué puede hacer la IA: listar índices, alias y data streams; leer el mapping de campos de un índice antes de consultarlo; buscar con la Query DSL (10 resultados por defecto, como máximo 100 por llamada); ejecutar agregaciones como recuentos por valor, sumas, medias e histogramas por fecha; contar coincidencias; ejecutar consultas ES|QL para respuestas en tabla (como máximo 500 filas); y leer documentos individuales. Los campos vectoriales habituales se quedan fuera de los resultados. El estado del cluster no está disponible en Serverless, donde Elastic gestiona el cluster.

Las escrituras preguntan antes: elasticsearch_index_document crea o sustituye un documento entero, y elasticsearch_update_document cambia algunos campos de uno. Antes de cada una, la IA te muestra el índice, el _id y el contenido y espera tu sí. Ambas necesitan el privilegio write, así que con la clave de solo lectura de arriba fallan con 403, que es justo la red de seguridad prevista.

Desactivadas al instalar: elasticsearch_delete_document y elasticsearch_delete_by_query. Los borrados no se pueden deshacer, y un delete by query puede eliminar millones de documentos. Un administrador las activa de forma deliberada; después la IA cuenta primero los documentos afectados y pregunta antes de borrar.

Errores comunes: 401: la clave es incorrecta, ha caducado o se ha invalidado, o se pegó el id en lugar del valor Encoded. 403 security_exception: a la clave le falta el privilegio que indica el mensaje. 404 index_not_found_exception: nombre de índice desconocido. 400 parsing_exception o verification_exception: la consulta tiene un error; el mensaje indica el campo o la posición. 429: el cluster está sobrecargado; espera y vuelve a intentarlo.

El conector habla solo con Elasticsearch, no con Kibana. No crea ni borra índices, no cambia mappings ni ajustes y no cubre snapshots, ingest pipelines, administración de seguridad ni la bulk API.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Elasticsearch.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué índices tenemos, cuántos documentos tiene cada uno y cuánto ocupan?"
• "Busca en el índice products auriculares inalámbricos de menos de 100 euros y muestra nombre, marca y precio."
• "Con ES|QL, cuenta los errores por host en logs- de las últimas 24 horas y muéstrame los 10 primeros."*
• "¿Cuántos pedidos al día tuvimos en septiembre? Usa un histograma por fecha sobre el índice orders."
• "Pon a 0 el campo stock del producto 4711 en el índice products. Muéstrame el cambio antes de hacerlo."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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