MCP (asistentes de IA)

MCP (asistentes de IA)

MetriXs expone un endpoint MCP de solo lectura (Model Context Protocol) para consultar tus analíticas desde un asistente de IA: «¿cuántos visitantes tuvo mi sitio esta semana y de dónde vinieron?», con datos reales en lugar de una estimación.

Endpoint: https://mcp.metrixs.eu/api/mcp

MetriXs nunca llama a un proveedor de IA por su cuenta. Conectas tu propio asistente con tus propias credenciales; solo los números agregados de las analíticas llegan al chat que elijas.

Agencias: los clientes no pueden conectar el servidor MCP

Las cuentas de cliente de los planes Agency no pueden usar el servidor MCP: el flujo de consentimiento rechaza las cuentas de cliente sin excepción, y los clientes tampoco pueden crear claves de API en el panel. Si un cliente quiere acceso de IA a sus analíticas, la agencia crea una clave de API del sitio (Ajustes → Sitios → Claves API) y se la comparte. La clave queda vinculada a ese único sitio y es de solo lectura.

Dos formas de conectar

1. Clave API (Claude Code, Codex CLI, Gemini CLI, VS Code / GitHub Copilot, Cursor, JetBrains)

1. En el panel, abre Ajustes → Sitios y crea una clave API para el sitio que quieres compartir. La clave se muestra una sola vez.
2. Añade el servidor en tu cliente con la URL de arriba y la cabecera Authorization: Bearer <clave>:

Cliente	Dónde
Claude Code	claude mcp add metrixs --transport http https://mcp.metrixs.eu/api/mcp --header "Authorization: Bearer <clave>"
VS Code / GitHub Copilot	.vscode/mcp.json → servers.metrixs con type: "http", la URL y la cabecera
Codex CLI	~/.codex/config.toml → [mcp_servers.metrixs] con url + bearer_token_env_var
Gemini CLI	~/.gemini/settings.json → mcpServers.metrixs con httpUrl + headers
Cursor	Ajustes MCP → añadir un servidor personalizado (HTTP) con la URL y la cabecera
JetBrains AI Assistant	Ajustes → MCP, añadir un servidor remoto con la URL y la cabecera

2. OAuth (Claude Desktop, conectores de ChatGPT, Cursor, JetBrains)

1. En tu asistente, añade un servidor MCP remoto personalizado / conector con la URL de arriba. Claude Desktop y ChatGPT solo admiten este flujo; una clave API simple se rechaza ahí.
2. El asistente abre una página de MetriXs en tu navegador. Inicia sesión, elige un sitio y permite el acceso.
3. Listo. El asistente ya puede leer las analíticas de ese sitio.

Cada conexión OAuth aparece como una clave API llamada MCP: <asistente> en Ajustes → Sitios → Claves API. Al eliminar esa fila se revoca la conexión al instante, incluidas las sesiones activas.

Herramientas disponibles (todas de solo lectura)

list_sites, get_current_visitors, get_overview, get_timeseries, get_breakdown (páginas, fuentes, países, dispositivos, UTM, …), get_events, get_event_props, get_revenue, get_funnel, get_top_products (sitios de comercio), get_ai_traffic, get_blocked_bots, get_security_audit (última auditoría de seguridad, planes Team, Pro y Agency).

Privacidad

• Solo lectura: ninguna herramienta puede cambiar ajustes, sitios ni datos.
• Un sitio por conexión: una clave está vinculada a un único sitio; los asistentes nunca ven más allá.
• Solo agregados: no existen identificadores de visitante que divulgar; los IDs de visitante son hashes con rotación diaria y nunca aparecen en una respuesta de herramienta.
• Alojado en la UE: MetriXs no llama a ninguna IA. Tu asistente habla con MetriXs; MetriXs nunca habla con un proveedor de IA.