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 IA à la bonne méthode de connexion, puis suivez les vérifications ci-dessous si le serveur ne se connecte pas.

Le MCP de Metricool fonctionne avec n'importe quel forfait Metricool, y compris Free. Les limites de votre forfait s'appliquent toujours après la connexion. Par exemple, les comptes gratuits ne peuvent pas programmer plus de 20 publications.

Checklist rapide de connexion

Vérifiez ces éléments avant de vous pencher sur des correctifs propres à chaque client :

  • Point de terminaison : utilisez l'URL de production exactement : https://ai.metricool.com/mcp.

  • Compte Metricool : vous avez un compte Metricool et vous 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.

  • Signal de réussite : le client affiche Metricool comme connecté, authentifié ou prêt à l'emploi (la formulation varie selon l'outil).

Pour les étapes complètes de configuration par client, consultez Comment connecter le MCP de Metricool.

Choisissez la bonne méthode de connexion

Utilisez la méthode qui correspond à votre client. Utiliser la mauvaise méthode est une raison courante pour laquelle le serveur MCP ne termine 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

Jeton d'en-tête

Définissez le nom d'en-tête X-Mc-Auth avec 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

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 Foire aux questions sur le MCP de 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 via le chemin habituel

Claude Desktop a un bug externe documenté qui bloque le chemin habituel de connexion MCP. 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 par 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 incomplète. Corrigez cela dans cet ordre :

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

  2. Vérifiez que votre client utilise la méthode indiquée dans le tableau ci-dessus. Par exemple, N8N a besoin d'une authentification par en-tête, pas d'une configuration OAuth uniquement ; Claude Desktop a besoin de 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 que vous 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 lorsque vous y êtes invité.

L'authentification par en-tête N8N échoue

N8N se connecte avec l'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.

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

  2. Définissez l'authentification sur Authentification par en-tête.

  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 reconnectez Metricool. Claude Code nécessite toujours un abonnement Pro ou Max.

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 de pouvoir 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 de 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 Metricool ou le lien web de 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 dans Cursor pour confirmer la connexion.

Le MCP se connecte, mais les actions échouent ou les données semblent limitées

C'est généralement une limite de forfait, pas une connexion serveur échouée. Le MCP fonctionne avec les forfaits Free et payants, mais les limites du forfait Metricool s'appliquent toujours à ce que le MCP peut interroger ou programmer.

  • Les comptes gratuits ne peuvent pas programmer plus de 20 publications.

  • Les forfaits payants étendent ces limites.

Si vous avez besoin d'un accès HTTP programmatique en dehors d'un client IA, il s'agit de l'API Metricool (Advanced ou Custom), pas du MCP. Consultez MCP vs API access: what is the difference?.

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 Applications après votre connexion et l'octroi de l'accès. Étapes complètes : Comment connecter le MCP de Metricool avec ChatGPT.

  • Make, Zapier, Smithery, Mistral Vibe, N8N : après l'octroi de l'accès (ou l'enregistrement des identifiants d'en-tête dans N8N), le client affiche le connecteur/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 IA ou de la plateforme 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 de récupérer le MCP.

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