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.

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.

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	Refresh token expiré ou révoqué	Relancez le flux d'auth : dans Claude Code, `claude mcp remove adkumo` puis ré-ajoutez ; dans les autres clients, déconnectez puis reconnectez.
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.