Metricool MCP

Je n’arrive pas à me connecter à Metricool MCP

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.

Pour les étapes de configuration par client, voir Comment connecter le MCP de Metricool. Pour les limites du forfait qui s’appliquent après une connexion réussie, voir Limites MCP et exigences du forfait.

Liste de vérification rapide de connexion

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

ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind

Jeton d’en-tête

Définissez le nom d’en-tête X-Mc-Auth sur votre clé API Metricool depuis Paramètres du compte > API

N8N

CLI

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.

  1. Dans Claude Desktop, ouvrez Paramètres depuis votre profil.

  2. Allez dans DéveloppeurModifier la configuration sous Serveurs MCP locaux.

  3. Ajoutez cette configuration :

    {
      "mcpServers": {
        "metricool-mcp": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ai.metricool.com/mcp"
          ]
        }
      }
    }
  4. Pour vous authentifier avec une clé API au lieu de l’OAuth dans le navigateur, utilisez cette configuration :

    {
      "mcpServers": {
        "metricool-mcp": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ai.metricool.com/mcp",
            "--header",
            "X-Mc-Auth: <METRICOOL_API_KEY>"
          ]
        }
      }
    }
  5. Enregistrez le fichier et redémarrez Claude Desktop.

  6. 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.

  7. Dans une conversation, ouvrez Connecteurs et vérifiez que Metricool est connecté.

Étapes complètes pour Claude Desktop et Claude Code : Comment connecter le MCP de Metricool avec Claude.

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 :

  1. Vérifiez que l’URL du serveur est exactement https://ai.metricool.com/mcp (aucun chemin, espace ou hôte alternatif supplémentaire).

  2. 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.

  3. Terminez la connexion dans le navigateur et choisissez Accorder l’accès lorsque Metricool demande des autorisations.

  4. 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.

  5. Dans Gemini CLI, après avoir ajouté la configuration, exécutez /mcp auth metricool et terminez l’autorisation dans le navigateur.

  6. 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.

  1. Dans l’outil MCP Client, définissez le point de terminaison sur https://ai.metricool.com/mcp.

  2. Définissez l’authentification sur Header Auth.

  3. Créez un identifiant avec le nom X-Mc-Auth.

  4. Définissez la valeur sur votre clé API Metricool depuis Paramètres du compte > API.

  5. 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.

  1. Vérifiez que Claude Code est installé et que vous êtes sur Pro ou Max.

  2. Exécutez :

    claude mcp add --transport http metricool https://ai.metricool.com/mcp
  3. 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é.

  1. Installez et ouvrez Cursor Desktop.

  2. Utilisez le lien d’installation profond ou le lien web Metricool depuis Comment connecter le MCP de Metricool, ou ajoutez un MCP personnalisé avec :

    "metricool-mcp": {
      "url": "https://ai.metricool.com/mcp",
      "type": "http"
    }
  3. 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.

  • ChatGPT : Metricool est connecté depuis Apps après votre connexion et l’accord de l’accès. Étapes complètes : Comment connecter le MCP de Metricool avec ChatGPT.

  • 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.


Articles connexes

Cela vous a-t-il été utile ?