# Serveur MCP : Traqio dans Claude et Cursor

URL: https://traqio.app/fr/docs/api/mcp
Last updated: 2026-10-14

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.

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](https://traqio.app/fr/docs/api), 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

### 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.

### Ajoutez le serveur à votre client

Claude Code :

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

Cursor — `.cursor/mcp.json` :

```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` :

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

### 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

| Outil | Fait | Scope |
| --- | --- | --- |
| list_apps | vos apps | reports:read |
| get_roas | ROAS par campagne, ensemble de publicités ou publicité | reports:read |
| get_roas_daily | dépenses, revenus et ROAS par jour | reports:read |
| get_cohorts | cohortes par jour d’installation | reports:read |
| get_revenue | revenus par devise et par attribution | reports:read |
| get_rejections | ce que Traqio a refusé, et pourquoi | reports:read |
| get_connector_health | connexions aux réseaux publicitaires et leur dernière synchronisation | reports:read |
| sync_spend | récupérer les dépenses maintenant | reports:write |
| list_links | les liens de tracking d’une app | links:read |
| create_tracking_link | créer un lien de tracking | links:write |
| erase_user_data | effacer les données d’un utilisateur (RGPD) — marqué destructif, votre client vous demande d’abord | privacy:write |
| traqio_status | l’espace de travail, la clé et ses scopes | toute 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.