Serveur MCP (Claude, Cursor…)

Le serveur MCP de DURUM branche vos données directement dans votre assistant IA. Vous posez vos questions en langage naturel — « Quel était mon ROAS le mois dernier ? », « Résume les scorecards de mes appels avec jean@exemple.com » — et l'assistant interroge votre compte DURUM en lecture seule.

C'est une façade mince sur l'API REST : votre clé porte votre compte et ses scopes, donc chaque outil est automatiquement limité à vos données.

Il y a deux façons de connecter DURUM.

Option A — Connecteur DURUM (recommandé, OAuth)

C'est un serveur MCP distant avec connexion « Se connecter avec DURUM » — rien à installer.

1. Dans Claude (ou tout client compatible connecteurs), ajoutez un connecteur avec l'URL : https://app.durum.ai/mcp
2. Une page DURUM s'ouvre : connectez-vous et autorisez l'accès (lecture seule, vous choisissez les permissions).
3. C'est prêt — les outils DURUM apparaissent.

L'accès est révocable à tout moment dans Paramètres → Clés API. Aucune clé à copier : l'autorisation se fait via votre compte DURUM (OAuth 2.1 + PKCE).

Option B — Local via clé API (développeurs)

Pour Claude Desktop/Code ou Cursor en configuration manuelle avec une clé API :

1. Créez une clé — voir Authentification.
2. Ajoutez à la configuration MCP de votre client :

{
  "mcpServers": {
    "durum": {
      "command": "npx",
      "args": ["-y", "@durum/mcp"],
      "env": { "DURUM_API_KEY": "durum_sk_live_VOTRE_CLE" }
    }
  }
}

Redémarrez le client — les outils DURUM apparaissent.

3. Poser vos questions

« Quel a été mon ROAS le mois dernier, et quelle campagne a généré le plus de revenus attribués ? »

« Montre-moi la conversion de mon funnel par source sur 30 jours. »

« Résume les scorecards de mes appels avec jean@exemple.com. »

Outils disponibles

Outil	Scope	Retourne
get_dashboard_kpis / _daily / _breakdowns	read:dashboard	KPIs
get_ad_spend / get_ad_campaigns	read:ads	Dépenses & performance
get_attribution / get_attribution_health	read:attribution	Attribution multi-touch
get_events / get_events_summary	read:events	Événements CRM
get_sales_summary	read:sales	KPIs commerciaux
get_finance_pnl	read:finance	P&L (marges non exposées)
get_funnel	read:funnel	Funnel & conversion
get_contacts / get_contact_calls	read:contacts / read:calls	Contacts & appels
get_icp_criteria	read:icp	Critères ICP
get_capi_health	read:capi	Santé des conversions
get_health_scores / get_goals	read:health / read:goals	Santé & objectifs

Un outil renvoie insufficient_scope si votre clé n'inclut pas son scope — créez alors une clé avec les scopes nécessaires.

Configuration

• DURUM_API_KEY (requis) — votre clé API.
• DURUM_API_BASE (optionnel) — défaut https://app.durum.ai/api/v1.