WireBoard

Permite que agentes LLM (Claude Desktop, Cursor, VS Code, etc.) consulten tus análisis en tiempo real e históricos en conversación. Construido sobre el SDK oficial de JavaScript @wireboard/api.

GitHub

Prueba este MCPPatrocinado

Documentación

`wireboard-mcp`

Servidor oficial del Model Context Protocol para WireBoard.

Permite que agentes LLM (Claude Desktop, Cursor, VS Code, etc.) consulten tus análisis en tiempo real e históricos en conversación. Construido sobre el SDK oficial de JavaScript @wireboard/api.

Instalación

Dos formas de instalar, elige la que se adapte a tu configuración.

Opción A: Extensión de escritorio (recomendada para usuarios de Claude Desktop)

Descarga wireboard-mcp-x.y.z.mcpb desde la página de lanzamientos de GitHub y haz doble clic. Un solo archivo funciona en Windows, macOS y Linux — Claude Desktop incluye su propio runtime de Node, por lo que no hay dependencias del sistema que instalar.

Claude Desktop te pedirá tu token de API de WireBoard, lo almacenará de forma segura en el llavero de tu sistema operativo, y las herramientas de WireBoard estarán disponibles de inmediato.

Si el doble clic no abre el archivo, instálalo a través de Claude Desktop → Configuración → Extensiones → Configuración avanzada → Instalar extensión.

Opción B: instalación con npm (para Cursor, VS Code, sin interfaz / CI, automatización)

npm install -g @wireboard/mcp

Requiere Node 18+. Luego configura el cliente MCP de tu elección.

Configuración de Claude Desktop

Edita claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "wireboard": {
      "command": "wireboard-mcp",
      "env": {
        "WIREBOARD_TOKEN": "your_token_here"
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas de WireBoard aparecerán automáticamente.

Cursor / VS Code / otros clientes MCP

Usa el mismo patrón de comando + variable de entorno en la configuración MCP de tu cliente.

Genera un token

Necesitas un token de API de WireBoard antes de que cualquiera de las rutas de instalación funcione. Genéralo en Configuración → API con la capacidad analytics:read para herramientas REST y live:read para la herramienta de instantánea en vivo.

Lo que puedes preguntar

Una vez configurado, pregúntale a Claude cosas como:

"¿Cuántos visitantes recibió mi sitio la semana pasada?"
"Muéstrame los 10 principales referidores de los últimos 30 días."
"¿Qué está pasando en mi sitio ahora mismo?"
"¿Qué páginas bajo /checkout tienen la peor tasa de rebote este mes?"
"¿Cuántos eventos de Compra se dispararon desde utm_source=newsletter ayer?"
"Compara los conteos de visitantes día a día durante las últimas dos semanas."

Claude elegirá la herramienta correcta, la llamará y responderá en lenguaje natural.

Herramientas disponibles

Herramienta	Qué hace
`list_sites`	Cada sitio en la cuenta
`get_account`	Identidad del propietario del token + capacidades
`get_aggregate`	Totales del período: visitantes, páginas vistas, tasa de rebote, duración
`get_timeseries`	Una métrica (visitantes o páginas vistas) agrupada por hora o día
`get_history`	Visitantes por día / recurrentes / páginas vistas / rebote / duración
`get_breakdown`	Filas Top-N por dimensión (país, dispositivo, navegador, referidor, etc.)
`get_top_urls`	Métricas por URL con filtros de prefijo / contiene / exacto
`query_events`	Consultas de eventos personalizados con agrupación y filtrado
`get_live_state`	Instantánea en tiempo real (conteo de visitantes en vivo, páginas principales, sesiones activas, etc.)
`list_dimensions`	Meta: cada dimensión, métrica y límite que soporta la API

Todas las herramientas aceptan rangos de fechas naturales: "today", "yesterday", "last 7 days" (o abreviatura "30d"), "this week", "last week", "this month", "last month", o "YYYY-MM-DD..YYYY-MM-DD" explícito. Siempre en UTC.

Límite de velocidad

El MCP se limita proactivamente a 100 solicitudes/minuto (por debajo del límite de 120/minuto de la API) para que las ráfagas de LLM se espacien en lugar de recibir errores 429. Anula con la variable de entorno WIREBOARD_MCP_RATE_PER_MINUTE si tienes un caso de uso que necesite un ritmo diferente.

El SDK subyacente aún reintenta automáticamente en 429 como respaldo.

Seguridad

Trata tu token como una credencial. Tiene alcance completo de analytics:read y live:read en cada sitio de la cuenta.
No confirmes tu configuración de cliente MCP en un repositorio público con el token incluido. Usa una variable de entorno o un administrador de secretos y refiérelo desde tu configuración.
Revoca y rota si un token se filtra. Configuración → API en tu panel de control.

El MCP es de solo lectura: puede obtener datos, nunca modificarlos. La API pública de WireBoard es de solo lectura en v1.

Registros

Los registros van a stderr (para que no interfieran con el protocolo MCP en stdout).

Fuente y contribuciones

npm: @wireboard/mcp
Repositorio: github.com/wireboard/mcp
Lanzamientos (descargas .mcpb): github.com/wireboard/mcp/releases
Problemas: github.com/wireboard/mcp/issues
SDK subyacente: @wireboard/api (fuente)
Documentación de WireBoard: https://wireboard.io/docs/api-overview

Compilación local

npm install
npm test               # run vitest
npm run build          # bundle TS → dist/index.js (esbuild, ~600 KB)
npm run build:mcpb     # also pack dist/wireboard-mcp-<version>.mcpb

El .mcpb es un zip de manifest.json, icon.png y el único dist/index.js empaquetado. Todas las dependencias de runtime están integradas por esbuild.

Licencia

MIT.