Gebruik het productie-MCP-eindpunt van Metricool, https://ai.metricool.com/mcp, gebruik in je AI-client de juiste verbindingsmethode en doorloop de onderstaande controles als de server geen verbinding maakt.
Controleer deze punten voordat je specifieke oplossingen voor je client onderzoekt:
Eindpunt: gebruik exact deze productie-URL: https://ai.metricool.com/mcp.
Metricool-account: je hebt een Metricool-account en kunt je aanmelden.
Clientmethode: je tool gebruikt de hieronder vermelde methode (URL/OAuth, headertoken, CLI of mcp-remote).
Authenticatie: voltooi de OAuth-aanmelding en geef toegang, of configureer headerauthenticatie met de Metricool API-sleutel wanneer de client dit vereist.
Vereisten voor de client: voor Claude Code heb je een Pro- of Max-abonnement nodig; voor Cursor heb je de Cursor Desktop-app nodig; met Claude Free kun je slechts één aangepaste connector tegelijk gebruiken. Volledige lijst: MCP-limieten en abonnementsvereisten.
Signaal dat de verbinding is geslaagd: de client geeft aan dat Metricool verbonden, geauthenticeerd of klaar voor gebruik is (de bewoording verschilt per tool).
Kies de juiste verbindingsmethode
Gebruik de methode die bij je client past. Het gebruik van de verkeerde methode is een veelvoorkomende reden waarom de MCP-server nooit volledig verbinding maakt.
Verbindingsmethode
Hoe je je authenticeert
Ondersteunde clients
Op URL gebaseerd (HTTP/OAuth)
Plak de MCP-URL en meld je vervolgens aan bij Metricool en geef toegang
ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind, Claude Desktop en Claude.ai (via de Connectors-directory)
Voeg de MCP toe via HTTP/CLI en authenticeer wanneer daarom wordt gevraagd
Claude Code, Gemini CLI
mcp-remote
Voer npx mcp-remote uit voor de Metricool-URL en gebruik daarna OAuth of X-Mc-Auth
Claude Desktop (alleen als handmatige fallback, niet de standaardmethode)
Claude Desktop en Claude.ai maken op dezelfde manier verbinding: Settings → Connectors → Browse connectors → zoek naar Metricool → Grant access. Voor deze OAuth-flow is geen Metricool API-sleutel nodig. mcp-remote is alleen een fallback voor Claude Desktop, wanneer de directoryvermelding niet beschikbaar is of deze flow niet wordt voltooid.
Andere gedocumenteerde authenticatieopties voor MCP-clients zijn aanmelden via OAuth of METRICOOL_USER_TOKEN en METRICOOL_USER_ID opgeven 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 bijbehorende oplossing.
Claude Desktop maakt geen verbinding via de gebruikelijke methode
Begin met de Connectors-directory: Settings → Connectors → Browse connectors → zoek naar Metricool → Grant access. Dit is dezelfde OAuth-flow als op Claude.ai en vereist geen Metricool API-sleutel. Als deze methode niet wordt voltooid, maak dan handmatig verbinding met mcp-remote.
Open in Claude Desktop je profiel en kies Settings.
Ga naar Developer → Edit config onder Local MCP servers.
Voor deze OAuth-configuratie is geen API-sleutel nodig. Gebruik deze configuratie om je met een API-sleutel te authenticeren in plaats van via browser-OAuth:
Sla het bestand op en start Claude Desktop opnieuw.
Als je OAuth hebt gebruikt, voltooi dan de browserautorisatie wanneer daarom wordt gevraagd. Als je de API-sleutelmethode hebt gebruikt, wordt de browserstap overgeslagen.
Open in een chat Connectors en controleer of Metricool verbonden is.
De client maakt nooit volledig verbinding of blijft niet-geauthenticeerd
Het eindpunt, de methode of de autorisatiestap is niet volledig ingesteld. Los dit in deze volgorde op:
Controleer of de server-URL exact https://ai.metricool.com/mcp is (zonder extra pad, spatie of alternatieve host).
Controleer of je client de methode uit de bovenstaande tabel gebruikt. N8N heeft bijvoorbeeld headerauthenticatie nodig, niet een configuratie die alleen OAuth gebruikt; Claude Desktop begint met de Connectors-directory en schakelt alleen over op mcp-remote als dat niet wordt voltooid.
Voltooi de aanmelding in de browser en kies Grant access wanneer Metricool om machtigingen vraagt.
In Cursor kan de server na de installatie als niet-geauthenticeerd worden weergegeven totdat je op Connect klikt en de browserautorisatie voltooit.
Voer in Gemini CLI na het toevoegen van de configuratie /mcp auth metricool uit en voltooi de browserautorisatie.
Voer in Claude Code /mcp uit, selecteer Metricool en authenticeer wanneer daarom wordt gevraagd.
N8N-headerauthenticatie mislukt
N8N maakt verbinding met headertoken-authenticatie, niet met de URL-only OAuth-flow die de meeste andere clients gebruiken.
Stel in de MCP Client Tool het eindpunt in op https://ai.metricool.com/mcp.
Sla de credential op en probeer de workflow opnieuw.
Claude Free kan Metricool niet als extra aangepaste connector toevoegen
Aangepaste Remote MCP-connectors zijn beschikbaar voor Claude Free, Pro, Max, Team en Enterprise. Gratis gebruikers kunnen slechts één aangepaste connector tegelijk gebruiken.
Verwijder of vervang de bestaande aangepaste connector en verbind Metricool opnieuw. Voor Claude Code is nog steeds een Pro- of Max-abonnement vereist. Zie Zo verbind je Metricool's MCP met Claude.
Claude Code accepteert de opdracht om MCP toe te voegen niet
Voor Claude Code heb je een Pro- of Max-abonnement nodig en moet je het programma vanaf de Claude Code-productpagina installeren voordat je Metricool kunt toevoegen.
Controleer of Claude Code is geïnstalleerd en of je een Pro- of Max-abonnement hebt.
Voer uit:
claude mcp add --transport http metricool https://ai.metricool.com/mcp
Start Claude Code met claude, voer /mcp uit, selecteer Metricool en authenticeer.
Cursor toont de installatiestroom voor Metricool MCP niet
Voor het instellen van Cursor MCP heb je de Cursor Desktop-app nodig. Met de browserversie van Cursor kun je de gedocumenteerde installatiemethode niet voltooien.
Klik op Connect, autoriseer Metricool in de browser en ga terug naar Cursor om de verbinding te bevestigen.
De MCP maakt verbinding, maar acties mislukken of gegevens lijken beperkt
Dit is meestal een abonnementslimiet en geen mislukte serververbinding. De MCP werkt met gratis en betaalde abonnementen, maar de abonnementslimieten van Metricool bepalen nog steeds wat de MCP kan opvragen of inplannen.
Bekijk voorbeelden voor het gratis abonnement, vereisten aan de clientzijde en het verschil tussen MCP en API in MCP-limieten en abonnementsvereisten. Als je programmatische HTTP-toegang buiten een AI-client nodig hebt, gaat het om de Metricool API (Advanced of Custom), niet om MCP. Zie MCP- en API-toegang: wat is het verschil?.
Bevestig dat de verbinding is geslaagd
Gebruik het succes signaal voor je client:
Claude Desktop: Metricool wordt in Connectors als verbonden weergegeven.
Claude Code: na de browserautorisatie toont /mcp dat Metricool verbonden is.
Cursor: na de browserautorisatie wordt Cursor opnieuw geopend en is Metricool verbonden.
Gemini CLI: na /mcp auth metricool en browserautorisatie is de MCP verbonden in de terminalsessie.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N: nadat je toegang hebt gegeven (of de headercredentials in N8N hebt opgeslagen), toont de client de connector of tools als beschikbaar.
Toegang intrekken en opnieuw verbinding maken
Als je toegang wilt intrekken, verwijder of verbreek je de Metricool-connector in de AI-client of het platform waarvoor je toestemming hebt gegeven (bijvoorbeeld Claude, ChatGPT, Cursor of een andere MCP-client). Je kunt die connectormachtiging niet vanuit Metricool intrekken.
Nadat je de toegang op het platform hebt ingetrokken, maak je opnieuw verbinding door de verbindingsstappen voor die client te herhalen en indien nodig opnieuw toegang te geven tot de MCP.