Cómo conectar Amplitude a Gemini vía MCP

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

Amplitude + Gemini

Deja que tu IA lea tu analítica de producto en Amplitude: tendencias de eventos, embudos, retención, usuarios activos y nuevos, LTV de ingresos, sesiones, gráficos guardados, cohortes, búsqueda de usuarios y el plan de tracking, y que añada anotaciones a los gráficos. Centros de datos en EE. UU. y la UE.

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:

AMPLITUDE_API_HOST, AMPLITUDE_API_KEY, AMPLITUDE_SECRET_KEY

Paso 1 — Obtener credenciales

1. Necesitas el rol Manager o Admin en el proyecto de Amplitude. Selecciona Settings (abajo a la izquierda), luego Projects, y abre el proyecto. Cada proyecto tiene sus propias claves, así que un conector lee un solo proyecto.
2. En la pestaña General del proyecto, selecciona Manage junto a API Key y copia la clave en AMPLITUDE_API_KEY.
3. Selecciona Manage junto a Secret Key y genera una secret key nueva para AnythingMCP. Amplitude muestra una secret key una sola vez, al generarla, así que pégala enseguida en AMPLITUDE_SECRET_KEY. Un proyecto puede tener varias secret keys.
4. Ajusta AMPLITUDE_API_HOST al centro de datos del proyecto: https://amplitude.com para el centro de datos predeterminado (EE. UU.), https://analytics.eu.amplitude.com para un proyecto de la UE (su app funciona en app.eu.amplitude.com). Las claves de un proyecto de la UE se rechazan en el host de EE. UU. y al revés. analytics.amplitude.com es la app web, no la API.
5. Instala el conector y ejecuta amplitude_list_events para ver los nombres exactos de los eventos que registra tu proyecto.

Quién ve qué: la secret key lee todos los eventos y usuarios del proyecto. Comparte el servidor MCP solo con personas autorizadas a ver esos datos.

Qué lee: tendencias de eventos con filtros y agrupaciones, embudos, retención, usuarios activos y nuevos (también en directo, en pasos de 5 minutos), LTV de ingresos, duración de las sesiones y sesiones por usuario, composición de usuarios, los resultados de los gráficos guardados en Amplitude (se identifican por el id que sigue a /chart/ en la dirección del gráfico), behavioral cohorts, búsqueda de usuarios con los eventos recientes de un usuario y el plan de tracking (tipos de evento, propiedades de eventos y de usuarios, categorías). Las fechas son días completos en la zona horaria del proyecto. La lista de cohortes necesita el complemento Behavioral Cohorts en Growth o Enterprise.

Límites: los límites de Amplitude se aplican por proyecto y se comparten con todas las demás integraciones. La Dashboard REST API atiende como máximo 5 peticiones a la vez y tiene un presupuesto de coste de consultas de 1.000 cada 5 minutos y 108.000 por hora. Una consulta cuesta los días del periodo por las condiciones (segmentos y filtros; cada agrupación cuenta 4) por el coste del gráfico (segmentación 1 por evento, embudos 2 por paso, retención 8, sesiones 4, todo lo demás 1). La búsqueda de usuarios y la actividad de usuario tienen su propio límite de 10 a la vez y 360 por hora, y el plan de tracking permite 7.200 lecturas por hora. Por encima de un límite Amplitude responde 429: la IA espera y, si el problema es el presupuesto de coste, acorta el periodo o quita agrupaciones. Una consulta con agrupación sustituye a muchas consultas día por día o usuario por usuario.

Datos personales: amplitude_search_users y amplitude_get_user_activity devuelven el perfil y los eventos de un usuario. La IA los usa para el usuario por el que preguntas.

Confirmar antes: una anotación sin gráfico aparece en todos los gráficos del proyecto para todos los miembros, así que antes de amplitude_create_annotation la IA confirma contigo la etiqueta, el momento y el alcance. amplitude_delete_annotation viene desactivada al instalar.

Errores comunes: 403 "Invalid API Key": la clave o la secret key son incorrectas, pertenecen a otro proyecto o el proyecto está en el otro centro de datos (revisa AMPLITUDE_API_HOST). 401: falta una de las dos claves. 400: un parámetro o el JSON de un evento o segmento no es válido, o un gráfico guardado pertenece a otro proyecto. 404 en amplitude_get_chart_results: no hay ningún gráfico guardado con ese id. 429: se alcanzó un límite de concurrencia, por hora o de coste, y Amplitude indica cuál.

El conector no envía eventos a Amplitude, no exporta archivos de eventos en bruto, no descarga ni sube cohortes, no elimina usuarios por solicitudes de privacidad y no cubre Experiment, Session Replay ni la gestión de usuarios.

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

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos usuarios hicieron Sign Up cada semana en los últimos tres meses, agrupados por país?"
• "Muéstrame el embudo de Sign Up a Create Project a Invite Teammate de septiembre y el paso en el que más usuarios abandonan."
• "De los usuarios nuevos que empezaron en agosto, ¿cuántos volvieron en cada una de las ocho semanas siguientes?"
• "Añade en todos los gráficos una anotación para el relanzamiento de la página de precios del 1 de octubre y muéstrame la etiqueta y la fecha antes de guardarla."

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