Pour les développeurs · Claude et Cursor pris en charge

Guide d'intégration MCP

Utilisez le Model Context Protocol pour permettre à Claude, Cursor ou votre propre agent IA de consulter vos données DEXUN AdWhiz : comptes publicitaires connectés sur les trois plateformes, recommandations de l'IA et activité récente. En lecture seule.

Qu'est-ce que MCP ?

MCP (Model Context Protocol) est le standard ouvert lancé par Anthropic en 2024 pour définir comment les applications d'IA accèdent de façon sécurisée à des données et outils externes. Voyez-le comme « l'USB-C de l'IA » : une interface unique qui permet à n'importe quel client MCP (Claude Desktop, Cursor, votre propre agent) d'appeler n'importe quel serveur MCP (DEXUN AdWhiz, Notion, GitHub, etc.).

Le serveur MCP de DEXUN AdWhiz expose 5 outils en lecture seule : vos comptes publicitaires connectés, les recommandations en attente de l'IA, le résumé de vos économies, l'activité récente du compte et votre quota d'API. Il ne peut rien modifier, suspendre ni créer dans vos comptes publicitaires. Chaque appel est authentifié par votre clé API et soumis aux mêmes limites par forfait que notre API REST.

Démarrage rapide

Trois étapes. Environ cinq minutes avant de pouvoir interroger votre assistant IA sur vos comptes publicitaires.

1

Configurer Claude Desktop

Modifiez claude_desktop_config.json (macOS : ~/Library/Application Support/Claude/, Windows : %APPDATA%\Claude\) et ajoutez :

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

Configurer Cursor

Via le fichier .cursor/mcp.json du projet ou la configuration globale :

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

Vérifier

Redémarrez Claude ou Cursor, puis essayez ce prompt. Si l'IA appelle list_ad_accounts ou list_recommendations et renvoie vos données réelles, vous êtes connecté.

Demandez à Claude :

« Liste mes comptes publicitaires connectés et résume les recommandations en attente de l'IA : quelles campagnes suggère-t-elle de modifier, et pourquoi ? »

Catalogue des outils

Le serveur MCP expose 5 outils, tous en lecture seule. Chacun dispose d'un JSON Schema complet : l'IA décide seule lequel appeler et quand.

list_ad_accounts

Lecture seule

Vos comptes Google Ads, Meta Ads et TikTok Ads connectés et leur état de connexion.

list_recommendations

Lecture seule

Les recommandations d'optimisation en attente de l'IA (hausse de budget, baisse, mise en pause), chacune avec son motif, son impact attendu et son niveau de confiance.

get_savings_summary

Lecture seule

Le résumé de vos économies : renvoie aux chiffres d’économies de votre tableau de bord, avec votre forfait.

get_recent_activity

Lecture seule

Activité récente du compte : connexions, modifications de clés API, comptes publicitaires connectés et changements d'abonnement.

get_quota

Lecture seule

Votre limite d'API actuelle : requêtes par minute, nombre restant et heure de réinitialisation de la fenêtre.

Votre client IA liste ces mêmes outils, avec leurs paramètres, via la requête MCP standard tools/list.

Exemple de session

Un exemple de conversation (données fictives) qui montre à quoi ressemble l'accès en lecture seule :

Quels comptes publicitaires ai-je connectés à AdWhiz ?

Vous avez trois comptes connectés : un Google Ads, un Meta Ads et un TikTok Ads. Les trois apparaissent comme connectés.

list_ad_accounts

Que recommande l'IA en ce moment ?

Il y a 2 recommandations en attente : ① baisser le budget quotidien de la campagne Meta « Lookalike 1% », dont le ROAS est inférieur à la moyenne du compte depuis une semaine ; ② augmenter le budget d'une campagne TikTok Spark Ads. Chacune indique son motif et un niveau de confiance. Pour les appliquer, faites-le dans votre plateforme publicitaire — je ne peux rien modifier d'ici.

list_recommendations

Y a-t-il eu des changements récents sur mon compte ?

Ces 7 derniers jours : 2 connexions, 1 nouvelle clé API et la reconnexion de votre compte TikTok Ads. Rien d'autre n'est enregistré.

get_recent_activity

Sécurité et autorisations

  • Les 5 outils sont en lecture seule : l'IA peut consulter vos données, mais pas modifier les budgets, suspendre des publicités ni créer de campagnes
  • Le serveur MCP s'exécute en local — votre clé API dxk_ ne quitte jamais votre machine vers des tiers
  • Les appels sont authentifiés par votre clé API et partagent les limites de l'API REST de votre forfait (consultez-les avec get_quota)
  • Les modifications de vos campagnes sont faites par vous, pas via MCP
  • Révoquez l'accès MCP à tout moment dans tableau de bord → Paramètres → API Keys