Serveur MCP
Serveur MCP
advertiser-mcp est un serveur MCP distant en Streamable HTTP. Les appels d'outils passent par l'API annonceurs : droits, limite de débit, isolation par organisation, modération et validation de la première campagne sont les mêmes règles.
https://tyfrhxfejrawgdlhryfu.supabase.co/functions/v1/advertiser-mcp
Envoyez la clé annonceur à chaque requête :
Authorization: Bearer idl_adv_xxx
x-api-key: idl_adv_xxx est aussi accepté. N'envoyez pas un JWT Supabase.
Le serveur s'appelle idlen-advertiser, version 1.0.0. Les outils de lecture exigent read. Les outils d'écriture exigent write. write n'inclut pas read. La limite est de 120 requêtes par minute et par clé. Le client envoie Accept: application/json, text/event-stream.
Une clé absente ou inconnue renvoie 401 avec { "error": { "code": "unauthorized", "message": "..." } }. Au-delà de la limite, la réponse est 429 avec rate_limited, Retry-After et les en-têtes X-RateLimit-*.
Outils
| Outil | Rôle |
|---|---|
list_campaigns | Liste les campagnes de cette organisation, les plus récentes d'abord. Les campagnes archivées sont omises sauf si include_archived vaut true. |
get_campaign | Lit une campagne de cette organisation. Une campagne d'une autre organisation est introuvable. |
get_campaign_stats | Impressions, clics, dépense en centimes d'euro et conversions par jour. from et to sont des dates UTC YYYY-MM-DD. Défaut : 30 derniers jours. La plage ne peut pas dépasser 366 jours. |
create_campaign | Crée une campagne et son ensemble d'annonces. Le statut par défaut est draft. Les montants sont en centimes d'euro. |
update_campaign | Met à jour une campagne. Les champs omis ne changent pas. status à active suit les mêmes règles que resume_campaign. |
pause_campaign | Met en pause une campagne et ses ensembles d'annonces. |
resume_campaign | Active une campagne. La première campagne API est refusée. Un solde nul renvoie insufficient_balance. Sans annonce approuvée : ads_pending_moderation ou ad_required. |
list_ads | Liste les annonces, les plus récentes d'abord. campaign_id optionnel. is_approved null ou false : l'annonce n'est pas diffusée. |
create_ad | Crée une annonce sur une campagne. Titre 1 à 60 caractères, texte 150 au plus, lien en https://. |
create_ad_from_url | Lit une page et crée une annonce. Partage la limite de 10 requêtes par organisation et par heure. |
update_ad | Met à jour une annonce. Les champs omis ne changent pas. |
get_wallet | Solde du portefeuille en centimes d'euro, et le code devise (EUR). |
list_transactions | Transactions du portefeuille, les plus récentes d'abord. Dépôts positifs, dépenses négatives. Pas de référence du prestataire de paiement. |
create_deposit_checkout_link | Ouvre une URL Stripe Checkout pour un dépôt. N'effectue pas le débit tout seul. |
Les outils d'écriture acceptent idempotency_key. Il est envoyé comme Idempotency-Key. La même clé et le même corps sont rejoués 24 heures.
Une nouvelle annonce reste en attente tant qu'une personne ne l'a pas modérée, et elle n'est pas diffusée avant. Changer le titre, le texte, le bouton, le lien ou l'image la remet en attente. La première campagne que cette organisation crée via l'API ne peut pas être activée depuis l'API ni depuis MCP. Le résultat est first_campaign_requires_dashboard_validation et contient un lien vers le tableau de bord. Ouvrez le lien et activez la campagne dans Ads Manager. Une campagne suivante peut être relancée quand le portefeuille a des fonds et qu'au moins une annonce est approuvée.
Les limites de champs sont celles de Écriture.
Claude Desktop et Claude Code
Claude Desktop lit ceci dans son fichier de config. Claude Code utilise la même entrée mcpServers.
{
"mcpServers": {
"idlen-advertiser": {
"type": "http",
"url": "https://tyfrhxfejrawgdlhryfu.supabase.co/functions/v1/advertiser-mcp",
"headers": {
"Authorization": "Bearer idl_adv_xxx"
}
}
}
}
Cursor
Collez ceci dans .cursor/mcp.json ou dans Cursor Settings → MCP.
{
"mcpServers": {
"idlen-advertiser": {
"url": "https://tyfrhxfejrawgdlhryfu.supabase.co/functions/v1/advertiser-mcp",
"headers": {
"Authorization": "Bearer idl_adv_xxx"
}
}
}
}
ChatGPT et les autres clients MCP distants
Utilisez l'URL et l'en-tête Authorization. Le client envoie Accept: application/json, text/event-stream.
URL
https://tyfrhxfejrawgdlhryfu.supabase.co/functions/v1/advertiser-mcp
Header
Authorization: Bearer idl_adv_xxx
Créez la clé dans Ads Manager sous Paramètres → Clés API, avec Lecture et Écriture. La liste des routes est aussi dans le document OpenAPI.