Metricool MCP

Ik kan geen verbinding maken met Metricool MCP

Gebruik het productie-MCP-endpoint van Metricool https://ai.metricool.com/mcp, stem je AI-client af op de juiste verbindingsmethode en loop daarna de checks hieronder door als de server geen verbinding maakt.

Metricool’s MCP werkt met elk Metricool-abonnement, inclusief Free. Je abonnementslimieten blijven gelden nadat je verbinding hebt gemaakt. Free-accounts kunnen bijvoorbeeld niet meer dan 20 posts inplannen.

Snelle checklist voor verbinding

Controleer deze punten voordat je in clientspecifieke fixes duikt:

  • Endpoint: gebruik de productie-URL precies zo: https://ai.metricool.com/mcp.

  • Metricool-account: je hebt een Metricool-account en kunt inloggen.

  • Clientmethode: je tool gebruikt de methode die hieronder voor die tool staat (URL/OAuth, header-token, CLI of mcp-remote).

  • Authenticatie: rond de OAuth-aanmelding af en geef toegang, of stel header-auth in met de Metricool API-key wanneer de client dat vereist.

  • Clientvereisten: Claude Code heeft een Pro- of Max-abonnement nodig; Cursor heeft de Cursor Desktop-app nodig; Claude Free kan maar één aangepaste connector tegelijk gebruiken.

  • Succesindicator: de client toont Metricool als verbonden, geauthenticeerd of klaar voor gebruik (de formulering verschilt per tool).

Voor de volledige instelstappen per client, zie Hoe verbind je Metricool’s MCP.

Kies de juiste verbindingsmethode

Gebruik de methode die bij je client past. De verkeerde methode gebruiken is een veelvoorkomende reden waarom de MCP-server nooit klaar is met verbinden.

Verbindingsmethode

Hoe je je authenticatie uitvoert

Ondersteunde clients

Op URL gebaseerd (HTTP/OAuth)

Plak de MCP-URL en log daarna in bij Metricool en geef toegang

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

Header-token

Stel de headernaam X-Mc-Auth in op je Metricool API-key uit Accountinstellingen > API

N8N

CLI

Voeg de MCP toe via HTTP/CLI en authenticatie volgt wanneer daarom wordt gevraagd

Claude Code, Gemini CLI

mcp-remote

Voer npx mcp-remote uit op de Metricool-URL en gebruik daarna OAuth of X-Mc-Auth

Claude Desktop

Andere gedocumenteerde authenticatieopties voor MCP-clients zijn OAuth-aanmelding, of het opgeven van METRICOOL_USER_TOKEN en METRICOOL_USER_ID in de clientconfiguratie. Zie Veelgestelde vragen over de Metricool MCP.

Verbindingsproblemen

Open het symptoom dat overeenkomt met wat je ziet. Elke sectie behandelt één geverifieerde foutmodus en de oplossing.

Claude Desktop maakt geen verbinding via het gebruikelijke pad

Claude Desktop heeft een gedocumenteerde externe bug die het gebruikelijke MCP-verbindingspad blokkeert. Gebruik in plaats daarvan mcp-remote.

  1. Open in Claude Desktop Instellingen via je profiel.

  2. Ga naar DeveloperEdit config onder Local MCP servers.

  3. Voeg deze configuratie toe:

    {
      "mcpServers": {
        "metricool-mcp": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ai.metricool.com/mcp"
          ]
        }
      }
    }
  4. Gebruik deze configuratie om te authenticeren met een API-key in plaats van browser-OAuth:

    {
      "mcpServers": {
        "metricool-mcp": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ai.metricool.com/mcp",
            "--header",
            "X-Mc-Auth: <METRICOOL_API_KEY>"
          ]
        }
      }
    }
  5. Sla het bestand op en start Claude Desktop opnieuw op.

  6. Als je OAuth hebt gebruikt, rond dan de browserautorisatie af wanneer daarom wordt gevraagd. Als je de API-key-methode hebt gebruikt, wordt de browserstap overgeslagen.

  7. Open in een chat Connectors en controleer of Metricool verbonden is.

Volledige stappen voor Claude Desktop en Claude Code: Hoe verbind je Metricool's MCP met Claude.

De client maakt nooit af met verbinden of blijft ongeauthenticeerd

Het endpoint, de methode of de autorisatiestap is niet compleet. Los het in deze volgorde op:

  1. Controleer of de server-URL precies https://ai.metricool.com/mcp is (geen extra pad, spatie of andere host).

  2. Controleer of je client de methode uit de tabel hierboven gebruikt. N8N heeft bijvoorbeeld header-auth nodig, niet een gewone OAuth-only setup; Claude Desktop heeft mcp-remote nodig.

  3. Rond de browseraanmelding af en kies Toegang geven wanneer Metricool om rechten vraagt.

  4. In Cursor kan de server na installatie ongeauthenticeerd lijken totdat je op Verbinden klikt en de browserautorisatie afrondt.

  5. In Gemini CLI, voer na het toevoegen van de configuratie /mcp auth metricool uit en rond de browserautorisatie af.

  6. In Claude Code, voer /mcp uit, selecteer Metricool en autenticeer wanneer daarom wordt gevraagd.

N8N-headerauthenticatie mislukt

N8N maakt verbinding met header-token-auth, niet met de URL-only OAuth-flow die de meeste andere clients gebruiken.

  1. Stel in de MCP Client Tool het endpoint in op https://ai.metricool.com/mcp.

  2. Zet Authenticatie op Header Auth.

  3. Maak een credential aan met Naam X-Mc-Auth.

  4. Stel de waarde in op je Metricool API-key uit Accountinstellingen > API.

  5. Sla de credential op en probeer de workflow opnieuw.

Claude Free kan Metricool niet toevoegen als nog een andere aangepaste connector

Aangepaste Remote MCP-connectors zijn beschikbaar in Claude Free, Pro, Max, Team en Enterprise. Free-gebruikers kunnen maar één aangepaste connector tegelijk gebruiken.

Verwijder of vervang de bestaande aangepaste connector en verbind Metricool daarna opnieuw. Claude Code heeft nog steeds een Pro- of Max-abonnement nodig.

Claude Code accepteert de MCP-add-opdracht niet

Claude Code vereist een Pro- of Max-abonnement en installatie vanaf de Claude Code-productpagina voordat je Metricool kunt toevoegen.

  1. Controleer of Claude Code geïnstalleerd is en dat je Pro of Max gebruikt.

  2. Voer uit:

    claude mcp add --transport http metricool https://ai.metricool.com/mcp
  3. Start Claude Code met claude, voer /mcp uit, selecteer Metricool en autenticeer.

Cursor toont de installatiestroom voor Metricool MCP niet

Voor de Cursor MCP-instelling is de Cursor Desktop-app nodig. Browser-only Cursor kan het gedocumenteerde installatiepad niet afronden.

  1. Installeer en open Cursor Desktop.

  2. Gebruik de diepeling of weblink voor de Metricool-installatie uit Hoe verbind je Metricool’s MCP, of voeg een aangepaste MCP toe met:

    "metricool-mcp": {
      "url": "https://ai.metricool.com/mcp",
      "type": "http"
    }
  3. Klik op Verbinden, autoriseer Metricool in de browser en ga terug naar Cursor om de verbinding te bevestigen.

De MCP maakt verbinding, maar acties mislukken of data lijkt beperkt

Dat is meestal een limiet van je abonnement, niet een mislukte serververbinding. De MCP werkt op Free- en betaalde abonnementen, maar de abonnementslimieten van Metricool blijven gelden voor wat de MCP kan opvragen of inplannen.

  • Free-accounts kunnen niet meer dan 20 posts inplannen.

  • Betaalde abonnementen verruimen die limieten.

Als je programmatic HTTP-toegang nodig hebt buiten een AI-client, dan is dat de Metricool API (Advanced of Custom), niet MCP. Zie MCP vs API-toegang: wat is het verschil?.

Bevestig dat de verbinding is geslaagd

Gebruik de succesindicator voor je client:

  • Claude Desktop: Metricool verschijnt in Connectors als verbonden.

  • Claude Code: na browserautorisatie toont /mcp dat Metricool verbonden is.

  • Cursor: na browserautorisatie opent Cursor opnieuw met Metricool verbonden.

  • Gemini CLI: na /mcp auth metricool en browserautorisatie is de MCP verbonden in de terminalsessie.

  • ChatGPT: Metricool is verbonden vanuit Apps nadat je hebt ingelogd en toegang hebt gegeven. Volledige stappen: Hoe verbind je Metricool's MCP met ChatGPT.

  • Make, Zapier, Smithery, Mistral Vibe, N8N: na toegang geven (of het opslaan van de header-credentials in N8N) toont de client de connector/tools als beschikbaar.

Toegang intrekken en opnieuw verbinden

Om toegang in te trekken, verwijder of ontkoppel je de Metricool-connector van de AI-client of het platform waar je die hebt geautoriseerd (bijvoorbeeld Claude, ChatGPT, Cursor of een andere MCP-client). Je kunt die connectormachtiging niet intrekken vanuit Metricool zelf.

Nadat je de toegang op het platform hebt ingetrokken, maak je opnieuw verbinding door de verbindingsstappen van die client te herhalen en opnieuw toegang te geven als je de MCP weer nodig hebt.

Was dit nuttig?