Consultar desde tu propio asistente

Conecta Claude Code, Cursor o Claude Desktop con tu proyecto y ejecuta las mismas consultas validadas y de solo lectura que TraceLog, con resultados que puedes volver a abrir en el explorador.

La IA explica. TraceLog calcula.

Conecta tu asistente para consultar los datos de un proyecto. La clave solo permite leer datos y respeta los límites de tu plan. Cada resultado incluye un enlace para repetir la consulta en el explorador de TraceLog.

Tu asistente elige la consulta y todas las cifras salen de TraceLog al ejecutarla. TraceLog solo recibe la consulta que compone tu asistente, nunca lo que escribes.

Qué permite la clave

Una clave de asistente solo puede leer un proyecto y ejecutar estas consultas.

Lee lo mismo que un miembro puede consultar en el explorador. Se le aplican tanto tu plan como el estado de tu cuenta.
No escribe nada: no puede enviar eventos, cambiar el plan de conversión, consultar miembros ni acceder a otro proyecto.
No representa a una persona ni mantiene una sesión.

Créala en Ajustes del proyecto → Canales y credenciales → Crear clave de asistente. La clave solo se muestra al crearla. Cópiala entonces y revócala desde el mismo lugar si deja de ser segura; una clave revocada deja de funcionar al instante. Para sustituirla, crea una nueva y revoca la anterior.

HTTP

Authorization: Bearer tl_ak_xxxxxxxxxxxxxxxxxxxxxxxxxx

La clave queda en texto sin cifrar en el archivo de configuración de tu equipo, no en TraceLog. Trátala como cualquier credencial de un archivo de configuración: no la subas al repositorio y revócala si pierdes el equipo.

Endpoint

https://api.tracelog.io/v1/assistant/mcp

Usa Model Context Protocol sobre HTTP y solo admite POST. No hay un flujo de eventos ni una sesión que abrir: cada solicitud contiene una respuesta.

Claude Code

Ejecuta este comando desde el directorio en el que quieras habilitarlo:

Configuración de tu asistente

claude mcp add --transport http tracelog https://api.tracelog.io/v1/assistant/mcp \
  --header "Authorization: Bearer tl_ak_xxxxxxxxxxxxxxxxxxxxxxxxxx"

Cursor

Añádelo a .cursor/mcp.json:

Configuración de tu asistente

{
  "mcpServers": {
    "tracelog": {
      "url": "https://api.tracelog.io/v1/assistant/mcp",
      "headers": {
        "Authorization": "Bearer tl_ak_xxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Claude Desktop ejecuta sus servidores como procesos locales y necesita mcp-remote para llegar a un endpoint HTTP. Añádelo a claude_desktop_config.json:

Configuración de tu asistente

{
  "mcpServers": {
    "tracelog": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.38",
        "https://api.tracelog.io/v1/assistant/mcp",
        "--header",
        "Authorization: Bearer tl_ak_xxxxxxxxxxxxxxxxxxxxxxxxxx",
        "--transport",
        "http-only"
      ]
    }
  }
}

La versión de mcp-remote está fijada: solo cambia cuando tú la cambias.

La única herramienta

El servidor ofrece una herramienta: run_semantic_query. Cada consulta pide una métrica, sessions, events, conversions, conversion_rate o step_rate, para un intervalo de días naturales en la zona horaria del proyecto. Además, puede:

desglosar el resultado por una dimensión del origen de la sesión;
filtrar todas las cifras por un valor de una dimensión, distinta de la del desglose;
comparar el periodo con otro;
devolver el periodo semana a semana, de lunes a domingo, hasta 371 días. Una serie semanal no admite desglose ni comparación.

La descripción de la herramienta incluye las conversiones y los pasos de tu plan de conversión, para que el asistente no tenga que adivinar qué existe.

Cada respuesta incluye un enlace en el campo explorer. Al abrirlo, el explorador repite la misma consulta y muestra las mismas cifras.

Cómo se explica una limitación

Una limitación se devuelve como respuesta, no como error. Indica el motivo y una explicación para que el asistente pueda contarte qué ha ocurrido.

Si pides a un proyecto gratuito que desglose o filtre sesiones por canal, recibes:

JSON

{
  "refused": "paid_dimension",
  "sentence": "Channel, campaign, term, AI origin, device, country and landing page are included in Pro. Your data already supports them; on Free they stay closed."
}

Significa: desglosar por canal, campaña, término, origen IA, dispositivo, país o página de entrada está incluido en Pro, y tus datos ya lo permiten. Los mensajes de esta API se devuelven en inglés.

Con tu plan actual, los datos se siguen registrando; solo se limita el acceso a esa vista. La captura, las alertas y el recorrido declarado no cambian.

Las demás limitaciones se explican igual:

un proyecto aún no verificado no muestra cifras de conversión hasta que se verifica su recorrido declarado;
un elemento que tu plan no declara nunca se esperaba;
a una cuenta pausada se le indica la acción que la reanuda;
a un proyecto gratuito que pregunta por algo anterior a sus últimos 30 días, o que compara con otro periodo, se le indica que eso se incluye en Pro.

Los límites del plan no detienen la captura del recorrido declarado.

Conectores web

Los conectores integrados en claude.ai y ChatGPT requieren OAuth, mientras que este endpoint se autentica con una clave. Todavía no son compatibles; los tres clientes anteriores, sí.