Traqio.

API

Servidor MCP: Traqio en Claude y Cursor

Conecta Claude Code, Cursor o Claude Desktop al servidor MCP alojado de Traqio y pregunta por ROAS, cohortes y enlaces en lenguaje natural, con clave de API.

Abrir en:ChatGPTClaudePerplexity

Traqio aloja un servidor Model Context Protocol (MCP) en https://api.traqio.app/mcp. Cada una de sus herramientas ejecuta un endpoint de la API pública, con la misma clave de API y los mismos scopes — así que una clave de solo lectura también es de solo lectura en Claude. El servidor no tiene estado (Streamable HTTP, un mensaje JSON-RPC por petición).

Conectar#

  1. Crea una clave de API#

    En la consola, Ajustes → Claves de API. Da al asistente los scopes más restringidos que respondan a tus preguntas — reports:read basta para preguntar por el ROAS. La consola muestra el comando de Claude Code con la clave ya incluida, la única vez que la clave aparece en pantalla.

  2. Añade el servidor a tu cliente#

    Claude Code:

    claude mcp add --transport http traqio https://api.traqio.app/mcp \
  --header "Authorization: Bearer $TRAQIO_API_KEY"

    Cursor — .cursor/mcp.json:

    {
  "mcpServers": {
    "traqio": {
      "url": "https://api.traqio.app/mcp",
      "headers": {
        "Authorization": "Bearer tq_live_…"
      }
    }
  }
}

    Claude Desktop — claude_desktop_config.json, a través del puente mcp-remote:

    {
  "mcpServers": {
    "traqio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.traqio.app/mcp",
        "--header",
        "Authorization:${TRAQIO_AUTH}"
      ],
      "env": {
        "TRAQIO_AUTH": "Bearer tq_live_…"
      }
    }
  }
}

  3. Haz una pregunta#

    «¿Qué anuncios de Meta tuvieron el mejor ROAS la semana pasada?», «¿Funciona bien la sincronización de mi inversión en TikTok?», «Crea un enlace de seguimiento para la campaña de otoño». La herramienta traqio_status indica al asistente qué espacio de trabajo y qué scopes tiene.

Herramientas#

HerramientaHaceScope
list_appstus appsreports:read
get_roasROAS por campaña, conjunto de anuncios o anuncioreports:read
get_roas_dailyinversión, ingresos y ROAS por díareports:read
get_cohortscohortes por día de instalaciónreports:read
get_revenueingresos por moneda y por atribuciónreports:read
get_rejectionslo que Traqio rechazó, y por quéreports:read
get_connector_healthconexiones con redes publicitarias y su última sincronizaciónreports:read
sync_spendobtener la inversión ahorareports:write
list_linkslos enlaces de seguimiento de una applinks:read
create_tracking_linkcrear un enlace de seguimientolinks:write
erase_user_databorrar los datos de un usuario (RGPD) — marcado como destructivo, tu cliente te pregunta antesprivacy:write
traqio_statusel espacio de trabajo, la clave y sus scopescualquier clave

tools/list solo devuelve las herramientas que la clave puede llamar. Las fechas siguen las convenciones de la API: YYYY-MM-DD, to exclusivo.

Preguntas frecuentes#

¿Qué clientes MCP funcionan con Traqio?
Cualquier cliente que hable el transporte Streamable HTTP de MCP con una cabecera personalizada: Claude Code y Cursor de forma nativa, Claude Desktop a través del puente mcp-remote.
¿Puede el asistente cambiar algo en mi cuenta?
Solo lo que permiten los scopes de la clave. Una clave con solo reports:read únicamente puede leer informes: el servidor solo lista las herramientas que la clave puede llamar. Los scopes de escritura permiten lanzar una obtención de la inversión (reports:write), crear enlaces de seguimiento (links:write) y borrar los datos de un usuario a petición (privacy:write, una herramienta marcada como destructiva) — nunca gestionar claves, miembros, credenciales ni la facturación.

Actualizado el 14 de octubre de 2026