Conectar Yandex Metrica MCP con Cursor

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

Yandex Metrica + Cursor

Deja que tu IA analice la analítica web de Yandex Metrica: contadores, objetivos, filtros y segmentos, informes de tabla, series temporales, drill-down y comparación sobre visitas, fuentes, páginas y conversiones, y visitas y hits en bruto a través de la Logs API.

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:

YANDEX_METRICA_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de Yandex propietaria de los contadores de Metrica o con acceso a ellos, y una app propia registrada en oauth.yandex.com.

1. Crea en oauth.yandex.com una app del tipo For API access or debugging y dale el acceso metrika:read (estadísticas de Metrica, ajustes de los contadores, lista de contadores). Apunta su ClientID.
2. Con la sesión iniciada en la cuenta de Yandex que posee o ve los contadores, abre https://oauth.yandex.com/authorize?response_type=token&client_id=<ClientID> con tu ClientID y copia el token (empieza por y0_) en YANDEX_METRICA_TOKEN, sin OAuth ni Bearer delante.
3. Instala el conector y ejecuta yandex_metrica_list_counters: comprueba el token y lista los ids de contador que necesitan las demás herramientas.

Cloud y self-hosted funcionan igual: pegas el token y el conector lo envía como Authorization: OAuth ... en cada llamada. En AnythingMCP no hay que configurar ninguna Redirect URL.

El token dura alrededor de un año: se prolonga mientras se usa. El acceso de lectura basta para todo: metrika:read cubre los informes, los ajustes de los contadores y las solicitudes a la Logs API.

Primero contadores y objetivos: el id del contador va en ids en los informes y en counterId en todo lo demás. yandex_metrica_list_goals da los ids de objetivo que llevan dentro las métricas de objetivos, como ym:s:goal123reaches y ym:s:goal123conversionRate.

Métricas, fechas y filtros: las métricas y dimensiones empiezan por ym:s: para sesiones (visitas) y ym:pv: para páginas vistas, por ejemplo ym:s:visits, ym:s:bounceRate o ym:s:lastTrafficSource. Las fechas admiten YYYY-MM-DD, today, yesterday o 30daysAgo. Los filtros usan ==, !=, =@ (contiene) y =~ (regex), combinados con AND y OR; los segmentos guardados de yandex_metrica_list_segments se pueden reutilizar como filtros. Las filas se paginan con limit (100 por defecto, como máximo 100.000) y offset, que empieza en 1.

Cifras muestreadas: las respuestas de los informes traen sampled y sample_share. Cuando sampled es true las cifras son estimaciones: en rangos cortos pide precisión completa (accuracy full) o usa la Logs API.

Logs API: las visitas y los hits en bruto, sin muestreo, se preparan en el lado de Yandex. La IA comprueba con yandex_metrica_evaluate_log_request si se puede crear la solicitud, la crea, espera a que su estado sea processed y descarga cada parte como texto separado por tabuladores, con los nombres de los campos en la primera línea. El rango de fechas no puede incluir hoy, y los logs preparados cuentan para la cuota de almacenamiento de logs del contador.

Límites: 5.000 peticiones al día por usuario, 200 peticiones de informes cada 5 minutos por usuario, 3 peticiones en paralelo por usuario y 30 peticiones por segundo por dirección IP (10 para la Logs API). Por encima, Yandex responde 429: espera y vuelve a intentarlo.

Errores frecuentes: 401 significa que el token es incorrecto, ha caducado o se ha revocado: consigue uno nuevo con el ClientID de tu app como en el paso 2. 403 significa que el token funciona, pero su cuenta no tiene acceso a ese contador o a la app le falta metrika:read. 400 significa que una métrica, una dimensión o un filtro no es válido, y el mensaje lo nombra.

Qué lee: contadores con sitio, espejos, estado, zona horaria, estado del código, propietario y tu permiso, y las etiquetas (carpetas) en las que están ordenados; objetivos con tipo, condiciones, pasos y precio; filtros de datos, operaciones de URL, segmentos guardados y quién tiene acceso a un contador; informes de tabla, series temporales, drill-down y comparación sobre visitas, usuarios, tasa de rebote, fuentes de tráfico, páginas, países, dispositivos y conversiones de objetivos; y visitas y hits en bruto, sin muestreo, de la Logs API.

Desactivada al instalar: yandex_metrica_clean_log_request. Borra los archivos preparados de una solicitud de la Logs API ya procesada para liberar la cuota de almacenamiento de logs del contador, y después los archivos ya no se pueden descargar. Actívala en la página del conector solo si la necesitas; la IA te pide confirmación antes de cada cambio. yandex_metrica_create_log_request y yandex_metrica_cancel_log_request están activadas: solo inician o detienen la preparación de una exportación de datos en bruto en el lado de Yandex y no cambian ningún contador, objetivo ni ajuste.

Fuera de alcance: crear o editar contadores, objetivos, filtros y accesos, y subir conversiones offline, llamadas, gastos, parámetros de usuario o datos de CRM.

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 Yandex Metrica.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué fuentes de tráfico trajeron más visitas el mes pasado y cuál fue su tasa de rebote?"
• "¿Cómo cambió semana a semana en los últimos tres meses la tasa de conversión de mi objetivo de pedido?"
• "Compara las visitas y los objetivos alcanzados por fuente de tráfico entre octubre y septiembre."
• "¿Qué páginas tuvieron más páginas vistas ayer y en qué dispositivos?"
• "Saca las visitas en bruto, sin muestreo, de la semana pasada con la Logs API y cuéntalas por región."

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