Serveur MCP
DURUM.ai expose un serveur MCP (Model Context Protocol) pour brancher un assistant IA, comme Claude ou ChatGPT, directement sur vos données : dépenses publicitaires, attribution, funnel, contacts, appels et règles d'ads.
Palier payant requis
Le serveur MCP est réservé aux paliers payants (Starter, Growth, Scale). Sur le plan Découverte, la connexion est refusée à l'écran de consentement et chaque appel répond 403 plan_free_no_api. Pour passer au payant : Paramètres, Facturation, Passer au payant.
Se connecter
- Dans votre client MCP, ajoutez un serveur distant avec l'adresse
https://app.durum.ai/mcp. - Le client ouvre une page de consentement DURUM.ai : connectez-vous, choisissez le compte (business) et les accès accordés, puis approuvez.
- Seuls le propriétaire du compte et ses administrateurs peuvent approuver une connexion.
L'accès suit les mêmes règles que les clés API : les scopes approuvés limitent ce que l'assistant peut lire ou modifier, et chaque appel est journalisé.
Se connecter avec une clé API (plateformes sans OAuth)
Certaines plateformes d'agents ne proposent qu'une adresse et des en-têtes, sans page de consentement. Dans ce cas :
- Dans DURUM.ai, Paramètres, Clés API : créez une clé avec les scopes voulus (par exemple
read:dashboard,read:ads,read:calls). Elle ne s'affiche qu'une fois. - Dans la plateforme, adresse
https://app.durum.ai/mcp, puis un en-tête :
| En-tête | Valeur |
|---|---|
Authorization | Bearer durum_sk_live_... |
La clé fixe le compte et les scopes : l'assistant ne voit que les outils de ces scopes. Une clé d'organisation donne l'outil list_accounts et demande client_key à chaque appel. Une clé révoquée ou expirée répond 401.
Erreurs fréquentes
| Code | Cause |
|---|---|
plan_free_no_api | l'espace de travail est sur le plan Découverte |
insufficient_scope | l'accès approuvé ne couvre pas cet outil |
forbidden | la ressource n'appartient pas au compte connecté |