Serveur MCP

Adkumo expose un serveur Model Context Protocol, pour que tout client MCP — Claude Code, Claude Desktop, Cursor, ChatGPT — puisse piloter Adkumo sans quitter son interface de chat native. Cherchez des entreprises, parcourez des annonces, listez et créez des créations, et publiez sur vos plateformes publicitaires connectées, le tout depuis votre assistant.

Endpoint

https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

La <project-ref> exacte de votre espace de travail se trouve dans l'URL de votre compte. En auto-hébergement, remplacez l'hôte par le vôtre.

Authentification

L'authentification utilise OAuth 2.1 — vous vous connectez une fois avec votre compte Adkumo, le client stocke un refresh token et la connexion reste active. Aucune clé API à générer ou à coller.

À la première connexion d'un client, votre navigateur s'ouvre sur la connexion Adkumo. Après approbation, le client reçoit un access token de courte durée plus un refresh token. Le rafraîchissement est automatique — vous ne vous connectez qu'une fois.

Forfait requis

Le serveur MCP est disponible à partir du forfait Starter. Tout compte Adkumo peut s'authentifier et se connecter — votre client affiche le serveur comme connecté avec la liste complète des outils — mais sur le forfait Free, chaque appel d'outil renvoie un message vous invitant à passer à un forfait supérieur au lieu de s'exécuter. Passez au niveau supérieur sur app.adkumo.com/settings/billing pour débloquer les outils.

Connecter Claude Code

Une commande dans votre terminal :

claude mcp add adkumo \
  --transport http \
  --url https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

Claude Code ouvre un onglet de navigateur, vous vous connectez à Adkumo, et la connexion est active. Vérifiez avec claude mcp list.

Se connecter depuis une machine distante ou SSH

OAuth ouvre un navigateur et redirige vers un callback localhost sur la machine qui exécute le client. Si Claude Code s'exécute sur une machine distante ou SSH alors que votre navigateur est sur votre ordinateur portable, ce callback ne peut pas atteindre la CLI et la connexion semble bloquée. Deux solutions :

Transférez le port de callback. Fixez-le avec claude --callback-port 8765 ..., puis depuis votre ordinateur portable exécutez ssh -L 8765:localhost:8765 <hôte> et terminez la connexion dans votre navigateur local.
Collez l'URL de callback. Si la redirection du navigateur échoue après approbation, copiez l'URL de callback complète depuis la barre d'adresse et collez-la dans l'invite affichée par Claude Code.

Connecter Claude Desktop

Modifiez ~/Library/Application Support/Claude/claude_desktop_config.json (macOS — adaptez le chemin sous Windows / Linux) :

{
  "mcpServers": {
    "adkumo": {
      "type": "http",
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp"
    }
  }
}

Redémarrez Claude Desktop. À la première utilisation, votre navigateur s'ouvre pour la connexion, puis les outils Adkumo apparaissent dans le sélecteur d'outils de chaque conversation.

Connecter Cursor

Ajoutez le même serveur à ~/.cursor/mcp.json (ou un .cursor/mcp.json au niveau du projet) :

{
  "mcpServers": {
    "adkumo": {
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp"
    }
  }
}

Rechargez Cursor et approuvez la connexion lorsque vous y êtes invité.

Dépannage

Symptôme	Cause probable	Solution
401 Unauthorized à chaque appel	Token expiré ou révoqué — vous êtes déconnecté	Relancez le flux d'auth : dans Claude Code, `claude mcp remove adkumo` puis ré-ajoutez ; dans les autres clients, déconnectez puis reconnectez.
Les outils répondent « passez à un forfait supérieur »	Votre forfait n'inclut pas l'accès MCP	Le serveur MCP nécessite le forfait Starter ou supérieur. La connexion fonctionne toujours, mais les outils restent verrouillés jusqu'à ce que vous passiez au niveau supérieur sur app.adkumo.com/settings/billing.
405 Method Not Allowed	Le client a envoyé `GET` / `DELETE` à `/mcp`	Le transport est sans état et uniquement POST — généralement une mauvaise config du client.
Les outils agissent sur la mauvaise marque	Une autre marque est active	Demandez au client de changer de marque — voir Exemples.

Une fois connecté, voir Exemples pour le catalogue complet des outils et des prompts à essayer.