MCP Convertmax | Convertmax Docs

Le serveur MCP Convertmax est hébergé à une URL. Pointez un client vers cette adresse, approuvez l’accès dans le navigateur, et Max peut lire le revenu, l’attribution et les données commerce du workspace choisi.

https://mcp.convertmax.ai/mcp

La connexion ouvre le navigateur sur auth.convertmax.io pour que vous puissiez vous connecter. C’est le même hôte de login que Slack et Make. Vous choisissez le workspace (ou un compte agence), ce que cette IA a le droit de voir, puis Allow.

Chaque approbation crée une connexion pour ce client (Cursor, Claude, ChatGPT, …) vers ce workspace. Ce n’est pas la clé API du workspace. Gérez les connexions dans Convertmax :

https://app.convertmax.io/mcp/grants

Vous y voyez quelle IA est connectée, quel workspace elle utilise, ce qu’elle peut lire, et vous pouvez la déconnecter. Déconnecter Cursor ne casse pas Slack, Make ni l’API Convertmax. Le prochain appel d’un client déconnecté ou restreint est refusé.

Connecter un client

Utilisez HTTP Streamable. Le client découvre OAuth auprès du serveur ; vous n’avez pas à coller d’identifiants client ni d’URL de redirection.

Cursor

Ajoutez ceci à .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (utilisateur) :

{
  "mcpServers": {
    "convertmax": {
      "type": "http",
      "url": "https://mcp.convertmax.ai/mcp"
    }
  }
}

Rechargez les serveurs MCP dans Cursor. Une fenêtre de navigateur s’ouvre pour le consentement Convertmax.

Claude Code

claude mcp add --transport http convertmax https://mcp.convertmax.ai/mcp

Claude Desktop

Dans Settings → Connectors, ajoutez un connecteur personnalisé avec l’URL https://mcp.convertmax.ai/mcp. Claude Desktop ouvre la même page de consentement Convertmax.

ChatGPT

Dans ChatGPT, ajoutez un connecteur MCP personnalisé et collez https://mcp.convertmax.ai/mcp. ChatGPT ne s’exécute pas sur votre machine : une URL distante avec OAuth est obligatoire ; un serveur stdio local ne fonctionne pas.

VS Code (Copilot)

{
  "servers": {
    "convertmax": {
      "type": "http",
      "url": "https://mcp.convertmax.ai/mcp"
    }
  }
}

Codex

codex mcp add convertmax --url https://mcp.convertmax.ai/mcp

Tout autre client MCP qui gère HTTP distant et OAuth utilise la même URL.

Pas de navigateur ? Utilisez une clé API

OAuth suppose un navigateur et quelqu’un pour cliquer sur Allow. Un job CI n’a ni l’un ni l’autre, donc le serveur accepte aussi une clé API workspace en en-tête :

claude mcp add --scope user --transport http convertmax https://mcp.convertmax.ai/mcp \
  --header "Authorization: Bearer private-<your_key>"

Prenez une clé dans Account → API. La clé est liée à un seul workspace ; il n’y a pas de sélecteur de compte sur ce chemin. Préférez une clé restreinte, et ne la commitez pas. OAuth est le bon chemin pour Cursor, Claude et ChatGPT sur un laptop.

Vous pouvez aussi envoyer x-api-key: private-<your_key> si le client ne peut pas envoyer Authorization.

Ce que le serveur peut faire

Le catalogue est uniquement des outils. Après la connexion, posez la question en langage naturel ; le client appelle les outils. Vous ne passez pas d’identifiant de tenant.

Questions typiques :

Quelles campagnes ont généré le plus de revenu ce mois-ci ?
Comment le revenu se compare-t-il à la semaine dernière ?
Décomposer l’acquisition par source.
Résumer les conversions et le revenu par type d’événement.
Afficher le profit, l’acquisition, la rétention ou le LTV produit sur une période.
Quelles étaient les principales requêtes de recherche la semaine dernière ?

Les outils couvrent la santé du service, la vue reporting, la recherche, l’acquisition et le PPC, les conversions, le profit commerce et le LTV, et les insights tenant. Les actions d’écriture (mcp.actions.write) restent désactivées sauf si vous les activez au moment de cliquer sur Allow.

Ces cases déterminent les outils visibles par le client :

Scope	Accès
`mcp.workspace.read`	Identité du workspace pour le compte choisi
`mcp.metrics.read`	Reporting, recherche, trafic et synthèses de conversion
`mcp.attribution.read`	Ventilations d’attribution
`mcp.revenue_graph.read`	Lectures du graphe de revenu
`mcp.sales.read`	Lectures d’intelligence commerciale
`mcp.commerce.read`	Profit, LTV, acquisition, rétention et analyse des dépenses
`mcp.crm.read`	Lectures CRM
`mcp.actions.write`	Outils qui modifient des données (désactivé par défaut)

Par défaut, Allow donne la lecture workspace, métriques et commerce. Décochez ce que vous ne voulez pas donner à ce client. Vous pouvez changer cela plus tard sur les connexions MCP sans toucher Slack ni les autres intégrations.

Pourquoi un serveur distant

Les agents qui tournent dans un navigateur ou un datacenter (ChatGPT, Claude sur le web, agents d’hébergement) ne peuvent pas lancer un processus local ni lire une clé sur votre laptop. Un endpoint HTTP avec OAuth se comporte de la même façon dans le terminal ou ailleurs.

Un plugin public ou un mcp.json partagé ne peut pas non plus contenir une vraie clé API. OAuth sort le secret du package : l’URL est publique, vous approuvez dans le navigateur, et chaque IA a sa propre connexion dans Convertmax.

Tester la connexion

Quand le client affiche Convertmax comme connecté, demandez :

Résume la performance revenu des 7 derniers jours

Si Max répond avec les données du workspace approuvé, la connexion fonctionne.

Vous pouvez aussi essayer :

Lance un health check du serveur MCP Convertmax.
Quelles étaient les principales requêtes de recherche la semaine dernière ?
Compare le revenu search payant de ce mois avec le mois dernier.

Pour interroger Max dans Slack plutôt que via un client MCP, voir Slack.

Dépannage

Le navigateur ne s’ouvre jamais

Vérifiez que le client utilise HTTP (ou HTTP Streamable), pas stdio/npx. L’URL doit être exactement https://mcp.convertmax.ai/mcp.

Le consentement a réussi mais les outils échouent en 401

Le jeton d’accès a expiré ou la connexion a été coupée dans Convertmax. Déconnectez puis reconnectez le serveur dans le client, ou ouvrez les connexions MCP et confirmez qu’elle est encore active.

Max n’a pas les données attendues

Vérifiez que vous avez choisi le bon workspace à l’écran de consentement, surtout sur un compte agence avec plusieurs clients. Confirmez que les sources de données de ce workspace sont connectées dans Convertmax.

Je veux que ce client voie moins

Ouvrez les connexions MCP et réduisez ce que ce client peut voir, ou déconnectez-le. Le prochain appel d’outil utilise les nouvelles permissions. Reconnectez seulement pour un second client sur un autre workspace.

Vous êtes prêt

Votre agent de code peut maintenant poser à Convertmax les mêmes questions qu’à un analyste revenu :

Ask → Understand → Act