Conectar un asistente de IA (MCP)

El protocolo MCP (Model Context Protocol) permite que los asistentes de IA utilicen tus datos de Statsdot. Una vez conectado, puedes preguntar cosas como "¿Qué páginas atrajeron más visitantes desde Google la semana pasada?" o "Compara septiembre con agosto para shop.example.com" y el asistente leerá las cifras de Statsdot.

La dirección del servidor es https://statsdot.com/api/mcp. Claude y ChatGPT se conectan mediante OAuth: inicias sesión en Statsdot y apruebas la conexión. Las herramientas de desarrollo como Claude Code, Cursor y Codex utilizan los mismos tokens de acceso personal que la API REST.

Claude y ChatGPT (OAuth)

Claude

En Claude (web, escritorio o móvil), abre Settings > Connectors, elige Add custom connector e introduce https://statsdot.com/api/mcp. Claude abrirá una página de Statsdot: inicia sesión si es necesario y elige Allow.

ChatGPT

En ChatGPT, abre Settings > Apps and connectors, activa el modo desarrollador en Advanced si tu plan lo requiere, crea un conector con la URL https://statsdot.com/api/mcp y elige OAuth como autenticación. Aprueba la conexión en la página de Statsdot que se abrirá.

Las conexiones realizadas de este modo son de solo lectura: el asistente puede consultar tus estadísticas pero no puede modificar sitios, objetivos, notas ni tu equipo. Aparecen en Connected assistants en la página API and MCP, donde puedes desconectarlos. Una conexión sin uso caduca a los 30 días.

Herramientas de desarrollo (token de acceso)

1. Crear un token

En la página API and MCP de tu cuenta, crea un token. Read only es suficiente para realizar consultas. Elige read and write solo si deseas que el asistente añada sitios, objetivos o miembros al equipo.

2. Conectar tu asistente

Claude Code

claude mcp add --transport http statsdot https://statsdot.com/api/mcp \
  --header "Authorization: Bearer 12|your-token"

Cursor

En ~/.cursor/mcp.json:

{
  "mcpServers": {
    "statsdot": {
      "url": "https://statsdot.com/api/mcp",
      "headers": { "Authorization": "Bearer 12|your-token" }
    }
  }
}

Codex

En ~/.codex/config.toml:

[mcp_servers.statsdot]
url = "https://statsdot.com/api/mcp"
http_headers = { "Authorization" = "Bearer 12|your-token" }

Otros clientes que admiten servidores MCP remotos a través de HTTP con una cabecera personalizada funcionan de la misma manera.

Herramientas

Herramienta	Función
get-account	Tu plan, eventos usados e incluidos, límites
list-sites	Sitios que puedes ver, con sus identificadores
get-overview	Visitantes, páginas vistas, tasa de rebote y duración de la visita, comparados con el periodo anterior
get-timeseries	Visitantes y páginas vistas por día o mes
get-breakdown	Páginas principales, páginas de entrada y salida, referentes, campañas, países, dispositivos, navegadores, sistemas, eventos
get-goal-results	Objetivos con conversiones y tasa de conversión
get-realtime	Visitantes en los últimos cinco minutos
get-bot-traffic	Rastreadores de IA que leen el sitio y las páginas que solicitaron
list-funnels, get-funnel-results, create-funnel, delete-funnel	Embudos y los visitantes en cada paso
create-site, update-site, delete-site	Gestionar sitios, incluyendo alertas y el objetivo principal (tokens de escritura)
create-goal, delete-goal	Gestionar objetivos (tokens de escritura)
list-notes, create-note, delete-note	Notas en el gráfico que explican cambios en el tráfico
list-team, invite-team-member, remove-team-member	Gestionar tu equipo (tokens de escritura)

Las herramientas de lectura están marcadas como de solo lectura, y las herramientas que eliminan están marcadas como destructivas, por lo que los asistentes preguntarán antes de usarlas. Los rangos y filtros funcionan igual que en la API.

Privacidad

El asistente ve las mismas estadísticas agregadas que tu panel. Statsdot no almacena datos personales sobre tus visitantes, por lo que no hay nada que compartir. Revoca el token o desconecta el asistente en la página API and MCP para cortar la conexión en cualquier momento.