Яндекс Метрика MCP

Яндекс Метрика MCP conecta la aplicación de IA con el análisis web de su sitio. Pregunte en lenguaje natural de dónde provienen los visitantes, cómo cambia la conversión o dónde crece la tasa de rebote: el asistente tomará los datos de su contador y explicará el resultado. La conexión comienza directamente en el diálogo: no es necesario crear un token de antemano ni editar la configuración.

• Ocho herramientas. Contadores, objetivos e informes de Métrica, conexión y desconexión del acceso, así como una solicitud universal a la API.

• Informes y conversiones. Visitas, usuarios, vistas, rebotes, duración de la visita, fuentes, dispositivos y objetivos durante el período seleccionado.

• Conexión en el chat. Yandex abrirá la página de inicio de sesión; el código de un solo uso es válido durante 10 minutos, y el servidor verificará el acceso a los contadores inmediatamente después de la conexión.

• Solicitudes ordinarias: solo lectura. Las herramientas especializadas no modifican contadores, objetivos ni datos de Métrica.

• Sin truncamiento silencioso. En el informe se ven los valores totales y el indicador de muestreo; con una salida grande, el servidor señala si alcanzó el límite.

Pruebe con el primer mensaje:

¿Cuántas visitas, usuarios y rebotes tuvo mi sitio en la última semana?

Conectar servidor · Ver escenarios · Abrir documentación técnica

Ver el funcionamiento en un minuto

Usted: Conecta Яндекс Метрику.

Asistente: Proporciona un enlace para iniciar sesión en Yandex. Ábralo con la cuenta que tenga acceso a los contadores necesarios, confirme el acceso y envíe el código mostrado.

Usted: Envía el código de la página de Yandex.

Asistente: Conecta Métrica, verifica si los contadores son visibles y comunica el resultado. No es necesario reiniciar la aplicación.

Usted: En los últimos 30 días, muestra las fuentes de tráfico y la conversión según el objetivo «Realizar pedido».

Asistente: Encuentra el objetivo, elabora un informe por fuentes y muestra visitas, logros del objetivo y conversión. Si Métrica aplicó muestreo, señala que las cifras son aproximadas.

Related MCP server: ya-metrics-mcp

Contenido

• Inicio rápido

• Qué se puede encargar

• Cómo funciona

• Qué puede modificar los datos

• Conexión y configuración

• Datos y telemetría

• Limitaciones

• Documentación técnica

• Soporte

Inicio rápido

Se necesita Node.js 20 o superior. El servidor se inicia mediante npx, por lo que no es necesario instalar el paquete por separado.

1. Agregue el servidor a la aplicación de IA: a continuación se muestra un ejemplo abierto para Codex; las demás aplicaciones se recogen en instrucciones plegables.

2. Escriba: «Conecta Яндекс Метрику». El asistente lo guiará a través del inicio de sesión en Yandex y verificará de inmediato que ve sus contadores.

3. Haga la primera pregunta, por ejemplo: «¿Qué fuentes dieron más visitas el mes pasado?»

A través de la interfaz de la aplicación:

1. Abra Settings → Plugins → MCP servers.

2. Haga clic en Add server.

3. Agregue el comando de inicio npx -y mcp-yandex-metrica@latest.

A través de la línea de comandos:

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

Verifique la conexión:

codex mcp list

Luego, en el chat de Codex, pida: «Conecta Яндекс Метрику».

Instrucción oficial de Codex

claude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest

Verifique el servidor con el comando:

claude mcp list

Luego comience el diálogo pidiendo conectar Métrica.

Documentación de Claude Code

Abra Settings → Developer → Edit Config y agregue el servidor en claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Después de guardar, abra un nuevo diálogo y pida conectar Métrica.

Para todos los proyectos, cree ~/.cursor/mcp.json; solo para el proyecto actual — .cursor/mcp.json:

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

En el chat de Cursor, el servidor aparecerá entre las herramientas disponibles. Pida conectar Métrica y complete el inicio de sesión a través de Yandex.

Documentación de Cursor

Abra la paleta de comandos y ejecute MCP: Open User Configuration. Agregue en mcp.json:

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Verifique el inicio con el comando MCP: List Servers, luego abra el chat y pida conectar Métrica.

Documentación de VS Code

Qué se puede encargar

Entender qué sucede con el sitio

• «¿Cuántas visitas, usuarios y vistas hubo en la última semana?»

• «Muestra la dinámica de visitas por día durante junio».

• «¿En qué dispositivos la tasa de rebote es más alta?»

Encontrar la fuente de tráfico y evaluar su calidad

• «Muestra las fuentes de tráfico del mes y ordénalas por visitas».

• «Compara la búsqueda orgánica y la publicidad por usuarios y rebotes».

• «¿Qué fuentes dieron más transiciones esta semana?»

Analizar las conversiones

• «¿Qué objetivos están configurados en el contador?»

• «¿Cuál es la conversión según el objetivo „Realizar pedido“ en 30 días?»

• «Muestra las fuentes que aportaron más logros del objetivo».

Verificar el acceso y la precisión de los datos

• «¿Qué contadores tengo disponibles?»

• «Muestra el estado de la conexión a Métrica».

• «¿Los datos de este informe son exactos o Métrica usó muestreo?»

Cómo funciona

El servidor trabaja con tres entidades habituales:

Normalmente, el asistente primero encuentra un contador disponible, luego — si es necesario — un objetivo, y solo después elabora el informe. En la respuesta de Métrica hay un total para todas las filas, el tamaño de la salida y el indicador de muestreo.

Qué puede modificar los datos

El servidor marca la escritura arbitraria como una acción potencialmente destructiva. Cómo la aplicación de IA solicita confirmación depende de la propia aplicación; antes de dicha solicitud, verifique la ruta, el método y los datos.

Conexión y configuración

Para el uso normal, no se necesita un token de antemano:

1. En el chat, pida conectar Яндекс Метрику.

2. Abra el enlace a Yandex OAuth con la cuenta que tenga acceso a los contadores necesarios.

3. Confirme el acceso y envíe el código al asistente. Es válido durante 10 minutos y se convierte en token solo dentro del servidor en ejecución.

El servidor usa PKCE: el código del chat no se puede intercambiar por un token por sí solo. El token obtenido se almacena localmente en ~/.config/mcp-yandex-metrica/credentials.json con permisos solo para el propietario. Con un refresh-token guardado, el acceso se renueva automáticamente.

Para CI e instalaciones no estándar, la configuración está disponible mediante variables de entorno:

Si usa su propia aplicación OAuth, solicite en ella el permiso «Obtención de estadísticas, lectura de parámetros de sus contadores y de los confiables» (metrika:read).

Datos y telemetría

Por defecto, el servidor envía telemetría técnica anónima: un identificador aleatorio de instalación, el nombre del evento o herramienta, la versión del servidor, la versión de Node.js, el sistema operativo e información sobre el cliente de IA conectado. No incluye token, datos de contadores, argumentos de herramientas, sus mensajes ni valores de variables de entorno.

Para desactivar la telemetría para los servidores MCP de Ask Ads, establezca la variable de entorno:

ASKADS_TELEMETRY=0

Limitaciones

• Muestreo de Métrica. En períodos grandes o informes complejos, la API puede devolver datos aproximados. Consulte los campos sampled y sample_share; para un cálculo más preciso, reduzca el período o use accuracy: "full".

• Tamaño del informe. Una solicitud devuelve hasta 10 000 filas. La paginación automática se detiene en no más de 100 páginas, 100 000 filas o aproximadamente 1 MB de datos, y marca la respuesta incompleta con el campo _truncated.

• Reintentos de solicitudes. El tiempo de espera de una solicitud es de 60 segundos. El servidor realiza hasta tres reintentos en caso de error temporal: GET — ante error de red, 429 y 5xx; POST y DELETE — solo ante 429, para no repetir una acción modificadora. El retraso tiene en cuenta Retry-After y no supera los 30 segundos.

• Datos reales. Métrica no tiene sandbox. Las herramientas especializadas leen datos, pero POST y DELETE a través de una solicitud arbitraria modifican objetos reales.

• Sin observación en segundo plano. El servidor funciona cuando la aplicación de IA lo llama y no supervisa métricas por sí mismo. Si la aplicación admite tareas programadas, puede configurar en ella una solicitud periódica de informes.

Documentación técnica

• Catálogo de capacidades MCP — páginas sobre tareas de usuario para cada herramienta.

• Todas las herramientas — parámetros, respuestas y límites de cada herramienta.

• Documentación de desarrollo — estructura del proyecto y trabajo con la demo.

• Paquete en npm.

• API de Яндекс Метрики.

Soporte

¿Encontraste un error o falta un escenario? Crea un issue o escribe en Telegram.