Traqio.

API

Serveur MCP : Traqio dans Claude et Cursor

Connectez Claude Code, Cursor ou Claude Desktop au serveur MCP hébergé de Traqio : ROAS, cohortes et liens en langage naturel, avec une clé API à scopes.

Ouvrir dans :ChatGPTClaudePerplexity

Traqio héberge un serveur Model Context Protocol (MCP) à l’adresse https://api.traqio.app/mcp. Chacun de ses outils exécute un endpoint de l’API publique, avec la même clé API et les mêmes scopes — une clé en lecture seule l’est donc aussi dans Claude. Le serveur est sans état (Streamable HTTP, un message JSON-RPC par requête).

Connexion#

  1. Créez une clé API#

    Dans la console, Paramètres → Clés d’API. Donnez à l’assistant les scopes les plus restreints qui répondent à vos questions — reports:read suffit pour interroger sur le ROAS. La console affiche la commande Claude Code avec la clé déjà renseignée, la seule fois où la clé est à l’écran.

  2. Ajoutez le serveur à votre client#

    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, via le pont 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. Posez une question#

    « Quelles publicités Meta ont eu le meilleur ROAS la semaine dernière ? », « La synchronisation de mes dépenses TikTok fonctionne-t-elle ? », « Crée un lien de tracking pour la campagne d’automne ». L’outil traqio_status indique à l’assistant quel espace de travail et quels scopes il détient.

Outils#

OutilFaitScope
list_appsvos appsreports:read
get_roasROAS par campagne, ensemble de publicités ou publicitéreports:read
get_roas_dailydépenses, revenus et ROAS par jourreports:read
get_cohortscohortes par jour d’installationreports:read
get_revenuerevenus par devise et par attributionreports:read
get_rejectionsce que Traqio a refusé, et pourquoireports:read
get_connector_healthconnexions aux réseaux publicitaires et leur dernière synchronisationreports:read
sync_spendrécupérer les dépenses maintenantreports:write
list_linksles liens de tracking d’une applinks:read
create_tracking_linkcréer un lien de trackinglinks:write
erase_user_dataeffacer les données d’un utilisateur (RGPD) — marqué destructif, votre client vous demande d’abordprivacy:write
traqio_statusl’espace de travail, la clé et ses scopestoute clé

tools/list ne renvoie que les outils que la clé peut appeler. Les dates suivent les conventions de l’API : YYYY-MM-DD, to exclu.

Questions fréquentes#

Quels clients MCP fonctionnent avec Traqio ?
Tout client qui parle le transport Streamable HTTP de MCP avec un en-tête personnalisé : Claude Code et Cursor nativement, Claude Desktop via le pont mcp-remote.
L’assistant peut-il modifier quelque chose dans mon compte ?
Seulement ce que les scopes de la clé autorisent. Une clé avec reports:read seul ne peut que lire des rapports : le serveur ne liste que les outils que la clé peut appeler. Les scopes d’écriture permettent de déclencher une récupération des dépenses (reports:write), de créer des liens de tracking (links:write) et d’effacer les données d’un utilisateur sur demande (privacy:write, un outil marqué destructif) — jamais de gérer les clés, les membres, les identifiants ou la facturation.

Mis à jour le 14 octobre 2026