Utilisez le point de terminaison MCP de production de Metricool https://ai.metricool.com/mcp, associez votre client IA à la méthode de connexion appropriée, puis suivez les vérifications ci-dessous si le serveur ne se connecte pas.
Vérifiez les éléments suivants avant de passer aux solutions propres à chaque client :
Point de terminaison : utilisez exactement l’URL de production : https://ai.metricool.com/mcp.
Compte Metricool : vous disposez d’un compte Metricool et pouvez vous connecter.
Méthode du client : votre outil utilise la méthode indiquée ci-dessous (URL/OAuth, jeton d’en-tête, CLI ou mcp-remote).
Authentification : terminez la connexion OAuth et accordez l’accès, ou configurez l’authentification par en-tête avec la clé API Metricool lorsque le client l’exige.
Prérequis du client : Claude Code nécessite un abonnement Pro ou Max ; Cursor nécessite l’application Cursor Desktop ; Claude Free ne peut utiliser qu’un seul connecteur personnalisé à la fois. Liste complète : Limites du MCP et exigences liées au forfait.
Confirmation de réussite : le client indique que Metricool est connecté, authentifié ou prêt à l’emploi (la formulation varie selon l’outil).
Choisissez la méthode de connexion appropriée
Utilisez la méthode correspondant à votre client. L’utilisation d’une méthode incorrecte est une raison fréquente pour laquelle le serveur MCP ne termine jamais sa connexion.
Méthode de connexion
Comment vous authentifier
Clients compatibles
Basée sur une URL (HTTP/OAuth)
Collez l’URL MCP, puis connectez-vous à Metricool et accordez l’accès
ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind, Claude Desktop et Claude.ai (via le répertoire des connecteurs)
Ajoutez le MCP via HTTP/CLI, puis authentifiez-vous lorsque vous y êtes invité
Claude Code, Gemini CLI
mcp-remote
Exécutez npx mcp-remote avec l’URL Metricool, puis utilisez OAuth ou X-Mc-Auth
Claude Desktop (solution de secours manuelle uniquement, et non la méthode par défaut)
Claude Desktop et Claude.ai se connectent de la même manière : Paramètres → Connecteurs → Parcourir les connecteurs → recherchez Metricool → Accorder l’accès. Ce flux OAuth ne nécessite pas de clé API Metricool. mcp-remote est une solution de secours uniquement pour Claude Desktop, lorsque la liste du répertoire n’est pas disponible ou que ce flux n’aboutit pas.
Les autres options d’authentification documentées pour les clients MCP sont la connexion OAuth ou la fourniture de METRICOOL_USER_TOKEN et METRICOOL_USER_ID dans la configuration du client. Consultez la Foire aux questions sur le MCP de Metricool.
Problèmes de connexion
Ouvrez le symptôme qui correspond à ce que vous observez. Chaque section couvre un mode de défaillance vérifié et sa solution.
Claude Desktop ne se connecte pas avec la méthode habituelle
Commencez par le répertoire des connecteurs : Paramètres → Connecteurs → Parcourir les connecteurs → recherchez Metricool → Accorder l’accès. Il s’agit du même flux OAuth que celui utilisé sur Claude.ai et il ne nécessite pas de clé API Metricool. Si cette méthode n’aboutit pas, connectez-vous manuellement avec mcp-remote à la place.
Dans Claude Desktop, ouvrez Paramètres depuis votre profil.
Accédez à Développeur → Modifier la configuration sous Serveurs MCP locaux.
Cette configuration OAuth ne nécessite pas de clé API. Pour vous authentifier avec une clé API au lieu d’utiliser OAuth dans le navigateur, utilisez cette configuration :
Enregistrez le fichier et redémarrez Claude Desktop.
Si vous avez utilisé OAuth, effectuez l’autorisation dans le navigateur lorsque vous y êtes invité. Si vous avez utilisé la méthode avec clé API, l’étape dans le navigateur est ignorée.
Dans une conversation, ouvrez Connecteurs et confirmez que Metricool est connecté.
Le client ne termine jamais la connexion ou reste non authentifié
Le point de terminaison, la méthode ou l’étape d’autorisation est incomplète. Corrigez le problème dans cet ordre :
Vérifiez que l’URL du serveur est exactement https://ai.metricool.com/mcp (sans chemin, espace ou hôte différent).
Vérifiez que votre client utilise la méthode indiquée dans le tableau ci-dessus. Par exemple, N8N nécessite une authentification par en-tête, et non une configuration OAuth seule ; Claude Desktop commence par le répertoire des connecteurs et utilise mcp-remote uniquement si cette méthode n’aboutit pas.
Terminez la connexion dans le navigateur et sélectionnez Accorder l’accès lorsque Metricool vous demande des autorisations.
Dans Cursor, après l’installation, le serveur peut apparaître comme non authentifié jusqu’à ce que vous cliquiez sur Connecter et terminiez l’autorisation dans le navigateur.
Dans Gemini CLI, après avoir ajouté la configuration, exécutez /mcp auth metricool et terminez l’autorisation dans le navigateur.
Dans Claude Code, exécutez /mcp, sélectionnez Metricool, puis authentifiez-vous lorsque vous y êtes invité.
L’authentification par en-tête de N8N échoue
N8N se connecte avec une authentification par jeton d’en-tête, et non avec le flux OAuth basé uniquement sur l’URL utilisé par la plupart des autres clients.
Dans MCP Client Tool, définissez le point de terminaison sur https://ai.metricool.com/mcp.
Définissez l’option Authentication sur Header Auth.
Enregistrez l’identifiant et réessayez le workflow.
Claude Free ne peut pas ajouter Metricool comme autre connecteur personnalisé
Les connecteurs personnalisés MCP distants sont disponibles dans Claude Free, Pro, Max, Team et Enterprise. Les utilisateurs de l’offre Free ne peuvent utiliser qu’un seul connecteur personnalisé à la fois.
Supprimez ou remplacez le connecteur personnalisé existant, puis reconnectez Metricool. Claude Code nécessite toujours un abonnement Pro ou Max. Consultez Comment connecter le MCP de Metricool avec Claude.
Claude Code n’accepte pas la commande d’ajout du MCP
Claude Code nécessite un abonnement Pro ou Max et doit être installé depuis la page produit de Claude Code avant que vous puissiez ajouter Metricool.
Vérifiez que Claude Code est installé et que vous utilisez un abonnement Pro ou Max.
Exécutez :
claude mcp add --transport http metricool https://ai.metricool.com/mcp
Démarrez Claude Code avec claude, exécutez /mcp, sélectionnez Metricool, puis authentifiez-vous.
Cursor n’affiche pas le flux d’installation de Metricool MCP
La configuration de Cursor MCP nécessite l’application Cursor Desktop. La version de Cursor utilisée uniquement dans le navigateur ne peut pas suivre le parcours d’installation documenté.
Utilisez le lien d’installation profond ou le lien web de Metricool indiqué dans Comment connecter le MCP de Metricool, ou ajoutez un MCP personnalisé avec :
Cliquez sur Connecter, autorisez Metricool dans le navigateur, puis revenez à Cursor pour confirmer la connexion.
Le MCP se connecte, mais les actions échouent ou les données semblent limitées
Il s’agit généralement d’une limite de forfait, et non d’un échec de connexion au serveur. Le MCP fonctionne avec les forfaits Free et payants, mais les limites de forfait Metricool s’appliquent toujours aux données que le MCP peut interroger ou aux programmations qu’il peut effectuer.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N : après avoir accordé l’accès (ou enregistré les identifiants d’en-tête dans N8N), le client indique que le connecteur ou les outils sont disponibles.
Révoquer l’accès et se reconnecter
Pour révoquer l’accès, supprimez ou déconnectez le connecteur Metricool du client IA ou de la plateforme sur laquelle vous l’avez autorisé (par exemple Claude, ChatGPT, Cursor ou un autre client MCP). Vous ne pouvez pas révoquer cette autorisation de connecteur depuis Metricool.
Après avoir révoqué l’accès sur la plateforme, reconnectez-vous en répétant les étapes de connexion du client concerné et en accordant à nouveau l’accès si vous avez besoin de réutiliser le MCP.