Utilisez le point de terminaison MCP de production de Metricool https://ai.metricool.com/mcp, faites correspondre votre client d’IA à la bonne méthode de connexion, puis suivez les vérifications ci-dessous si le serveur ne se connecte pas.
Vérifiez ces éléments avant d’entrer dans les corrections spécifiques au client :
Point de terminaison : utilisez l’URL de production exactement : https://ai.metricool.com/mcp.
Compte Metricool : vous avez 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 MCP et exigences du forfait.
Signal de réussite : le client affiche Metricool comme connecté, authentifié ou prêt à l’emploi (la formulation varie selon l’outil).
Choisissez la bonne méthode de connexion
Utilisez la méthode qui correspond à votre client. L’utilisation de la mauvaise méthode est une raison fréquente pour laquelle le serveur MCP n’achève jamais la connexion.
Méthode de connexion
Comment vous vous authentifiez
Clients pris en charge
Basée sur l’URL (HTTP/OAuth)
Collez l’URL MCP, puis connectez-vous à Metricool et accordez l’accès
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 sur l’URL Metricool, puis OAuth ou X-Mc-Auth
Claude Desktop
Autres options d’authentification documentées pour les clients MCP : la connexion OAuth, ou la fourniture de METRICOOL_USER_TOKEN et METRICOOL_USER_ID dans la configuration du client. Voir Foire aux questions sur le MCP Metricool.
Problèmes de connexion
Ouvrez le symptôme qui correspond à ce que vous voyez. Chaque section couvre un mode d’échec vérifié et sa solution.
Claude Desktop ne se connecte pas par le chemin habituel
Claude Desktop a un bug externe documenté qui bloque le chemin de connexion MCP habituel. Utilisez plutôt mcp-remote.
Dans Claude Desktop, ouvrez Paramètres depuis votre profil.
Allez dans Développeur → Modifier la configuration sous Serveurs MCP locaux.
Enregistrez le fichier et redémarrez Claude Desktop.
Si vous avez utilisé OAuth, terminez l’autorisation dans le navigateur lorsque vous y êtes invité. Si vous avez utilisé la méthode de clé API, l’étape du navigateur est ignorée.
Dans une conversation, ouvrez Connecteurs et vérifiez 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 incomplet. Corrigez-le dans cet ordre :
Vérifiez que l’URL du serveur est exactement https://ai.metricool.com/mcp (aucun chemin, espace ou hôte alternatif supplémentaire).
Vérifiez que votre client utilise la méthode du tableau ci-dessus. Par exemple, N8N nécessite une authentification par en-tête, pas une configuration OAuth uniquement ; Claude Desktop nécessite mcp-remote.
Terminez la connexion dans le navigateur et choisissez Accorder l’accès lorsque Metricool 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 lorsqu’on vous le demande.
L’authentification par en-tête N8N échoue
N8N se connecte avec une authentification par jeton d’en-tête, pas avec le flux OAuth uniquement par URL utilisé par la plupart des autres clients.
Dans l’outil MCP Client, définissez le point de terminaison sur https://ai.metricool.com/mcp.
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 sur Claude Free, Pro, Max, Team et Enterprise. Les utilisateurs Free ne peuvent utiliser qu’un seul connecteur personnalisé à la fois.
Supprimez ou remplacez le connecteur personnalisé existant, puis connectez à nouveau Metricool. Claude Code nécessite toujours un abonnement Pro ou Max. Voir Comment connecter le MCP de Metricool avec Claude.
Claude Code n’accepte pas la commande d’ajout MCP
Claude Code nécessite un abonnement Pro ou Max et une installation depuis la page produit Claude Code avant que vous puissiez ajouter Metricool.
Vérifiez que Claude Code est installé et que vous êtes sur 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 et authentifiez-vous.
Cursor n’affiche pas le flux d’installation du MCP Metricool
La configuration MCP de Cursor nécessite l’application Cursor Desktop. Cursor dans le navigateur seul ne peut pas terminer le chemin d’installation documenté.
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 du serveur. Le MCP fonctionne sur les forfaits Free et payants, mais les limites du forfait Metricool s’appliquent toujours à ce que le MCP peut interroger ou planifier.
Consultez les exemples du forfait Free, les exigences côté client et la frontière entre le MCP et l’API dans Limites MCP et exigences du forfait. Si vous avez besoin d’un accès HTTP programmatique en dehors d’un client d’IA, il s’agit de l’API Metricool (Advanced ou Custom), et non du MCP. Voir Accès MCP vs API : quelle est la différence ?.
Confirmez que la connexion a réussi
Utilisez le signal de réussite correspondant à votre client :
Claude Desktop : Metricool apparaît dans Connecteurs comme connecté.
Claude Code : après l’autorisation dans le navigateur, /mcp affiche Metricool comme connecté.
Cursor : après l’autorisation dans le navigateur, Cursor se rouvre avec Metricool connecté.
Gemini CLI : après /mcp auth metricool et l’autorisation dans le navigateur, le MCP est connecté dans la session du terminal.
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 affiche le connecteur ou les outils comme disponibles.
Révoquer l’accès et reconnecter
Pour révoquer l’accès, supprimez ou déconnectez le connecteur Metricool du client ou de la plateforme d’IA où 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 de ce client et en accordant à nouveau l’accès si vous avez besoin du MCP.