Ich kann keine Verbindung zu Metricool MCP herstellen
Aktualisiert vor 4 Tagen
Verwende den produktiven MCP-Endpunkt von Metricool: https://ai.metricool.com/mcp, wähle für deinen KI-Client die richtige Verbindungsmethode und arbeite die folgenden Prüfungen durch, wenn keine Verbindung zum Server hergestellt wird.
Überprüfe diese Punkte, bevor du dich mit den client-spezifischen Lösungen beschäftigst:
Endpunkt: Verwende genau diese produktive URL: https://ai.metricool.com/mcp.
Metricool-Konto: Du hast ein Metricool-Konto und kannst dich anmelden.
Client-Methode: Dein Tool verwendet die unten dafür aufgeführte Methode (URL/OAuth, Header-Token, CLI oder mcp-remote).
Authentifizierung: Schließe die OAuth-Anmeldung ab und gewähre Zugriff, oder richte die Header-Authentifizierung mit dem Metricool-API-Schlüssel ein, wenn der Client dies erfordert.
Voraussetzungen des Clients: Für Claude Code benötigst du ein Pro- oder Max-Abonnement, für Cursor die Cursor-Desktop-App. Mit Claude Free kannst du jeweils nur einen benutzerdefinierten Connector verwenden. Die vollständige Liste findest du unter MCP-Limits und Tarifanforderungen.
Erfolgssignal: Der Client zeigt Metricool als verbunden, authentifiziert oder einsatzbereit an (die Formulierung variiert je nach Tool).
Wähle die richtige Verbindungsmethode
Verwende die Methode, die zu deinem Client passt. Die Verwendung der falschen Methode ist ein häufiger Grund dafür, dass die Verbindung zum MCP-Server nie abgeschlossen wird.
Verbindungsmethode
So authentifizierst du dich
Unterstützte Clients
URL-basiert (HTTP/OAuth)
Füge die MCP-URL ein, melde dich anschließend bei Metricool an und gewähre Zugriff
ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind, Claude Desktop und Claude.ai (über das Connector-Verzeichnis)
Header-Token
Setze den Header-Namen X-Mc-Auth auf deinen Metricool-API-Schlüssel aus den Kontoeinstellungen > API
N8N
CLI
Füge MCP über HTTP/CLI hinzu und authentifiziere dich anschließend, wenn du dazu aufgefordert wirst
Claude Code, Gemini CLI
mcp-remote
Führe npx mcp-remote mit der Metricool-URL aus und verwende anschließend OAuth oder X-Mc-Auth
Claude Desktop (nur manueller Fallback, nicht der Standardweg)
Claude Desktop und Claude.ai stellen die Verbindung auf dieselbe Weise her: Einstellungen → Connectors → Connectors durchsuchen → nach Metricool suchen → Zugriff gewähren. Dieser OAuth-Ablauf benötigt keinen Metricool-API-Schlüssel. mcp-remote ist nur für Claude Desktop ein Fallback, wenn der Verzeichniseintrag nicht verfügbar ist oder der Ablauf nicht abgeschlossen wird.
Weitere dokumentierte Authentifizierungsoptionen für MCP-Clients sind die OAuth-Anmeldung oder die Angabe von METRICOOL_USER_TOKEN und METRICOOL_USER_ID in der Client-Konfiguration. Siehe Häufig gestellte Fragen zu Metricool MCP.
Verbindungsprobleme
Öffne das Symptom, das deiner Beobachtung entspricht. Jeder Abschnitt behandelt einen verifizierten Fehlerfall und die passende Lösung.
Claude Desktop stellt über den üblichen Weg keine Verbindung her
Beginne mit dem Connector-Verzeichnis: Einstellungen → Connectors → Connectors durchsuchen → nach Metricool suchen → Zugriff gewähren. Dies ist derselbe OAuth-Ablauf wie bei Claude.ai und erfordert keinen Metricool-API-Schlüssel. Wenn dieser Weg nicht abgeschlossen wird, stelle die Verbindung stattdessen manuell mit mcp-remote her.
Öffne in Claude Desktop über dein Profil die Einstellungen.
Gehe unter Lokale MCP-Server zu Entwickler → Konfiguration bearbeiten.
Diese OAuth-Konfiguration benötigt keinen API-Schlüssel. Wenn du dich statt über Browser-OAuth mit einem API-Schlüssel authentifizieren möchtest, verwende diese Konfiguration:
Speichere die Datei und starte Claude Desktop neu.
Wenn du OAuth verwendet hast, schließe die Browser-Autorisierung ab, sobald du dazu aufgefordert wirst. Bei Verwendung der API-Schlüssel-Methode wird der Browserschritt übersprungen.
Öffne in einem Chat Connectors und bestätige, dass Metricool verbunden ist.
Der Client stellt die Verbindung nicht fertig oder bleibt nicht authentifiziert
Der Endpunkt, die Methode oder der Autorisierungsschritt ist unvollständig. Behebe das Problem in dieser Reihenfolge:
Bestätige, dass die Server-URL genau https://ai.metricool.com/mcp lautet (kein zusätzlicher Pfad, kein Leerzeichen und kein alternativer Host).
Bestätige, dass dein Client die Methode aus der obigen Tabelle verwendet. N8N benötigt beispielsweise Header-Authentifizierung und keine reine OAuth-Einrichtung. Claude Desktop beginnt mit dem Connector-Verzeichnis und verwendet mcp-remote nur als Fallback, wenn dieser Ablauf nicht abgeschlossen wird.
Schließe die Browser-Anmeldung ab und wähle Zugriff gewähren, wenn Metricool nach Berechtigungen fragt.
In Cursor kann der Server nach der Installation als nicht authentifiziert angezeigt werden, bis du auf Verbinden klickst und die Browser-Autorisierung abschließt.
Führe nach dem Hinzufügen der Konfiguration in Gemini CLI /mcp auth metricool aus und schließe die Browser-Autorisierung ab.
Führe in Claude Code /mcp aus, wähle Metricool und authentifiziere dich, wenn du dazu aufgefordert wirst.
Die Header-Authentifizierung von N8N schlägt fehl
N8N stellt die Verbindung mit Header-Token-Authentifizierung her, nicht über den URL-basierten OAuth-Ablauf, den die meisten anderen Clients verwenden.
Setze im MCP Client Tool den Endpunkt auf https://ai.metricool.com/mcp.
Speichere den Zugang und führe den Workflow erneut aus.
Claude Free kann Metricool nicht als weiteren benutzerdefinierten Connector hinzufügen
Benutzerdefinierte Remote-MCP-Connectoren sind in Claude Free, Pro, Max, Team und Enterprise verfügbar. Nutzer von Free können jeweils nur einen benutzerdefinierten Connector verwenden.
Entferne oder ersetze den vorhandenen benutzerdefinierten Connector und verbinde Metricool anschließend erneut. Für Claude Code ist weiterhin ein Pro- oder Max-Abonnement erforderlich. Siehe So verbindest du Metricool MCP mit Claude.
Claude Code akzeptiert den MCP-Hinzufügebefehl nicht
Für Claude Code benötigst du ein Pro- oder Max-Abonnement sowie eine Installation über die Claude-Code-Produktseite, bevor du Metricool hinzufügen kannst.
Bestätige, dass Claude Code installiert ist und du Pro oder Max verwendest.
Führe Folgendes aus:
claude mcp add --transport http metricool https://ai.metricool.com/mcp
Starte Claude Code mit claude, führe /mcp aus, wähle Metricool und authentifiziere dich.
Cursor zeigt den Installationsablauf für Metricool MCP nicht an
Für die Einrichtung von Cursor MCP ist die Cursor-Desktop-App erforderlich. Cursor ausschließlich im Browser kann den dokumentierten Installationsweg nicht abschließen.
Klicke auf Verbinden, autorisiere Metricool im Browser und kehre zu Cursor zurück, um die Verbindung zu bestätigen.
MCP stellt die Verbindung her, aber Aktionen schlagen fehl oder die Daten wirken eingeschränkt
Das ist normalerweise ein Tariflimit und keine fehlgeschlagene Serververbindung. MCP funktioniert mit kostenlosen und kostenpflichtigen Tarifen, aber die Metricool-Tariflimits gelten weiterhin dafür, welche Daten MCP abfragen oder planen kann.
Prüfe Beispiele für den Free-Tarif, clientseitige Anforderungen und die Abgrenzung zwischen MCP und API unter MCP-Limits und Tarifanforderungen. Wenn du programmatischen HTTP-Zugriff außerhalb eines KI-Clients benötigst, handelt es sich dabei um die Metricool API (Advanced oder Custom), nicht um MCP. Siehe MCP- und API-Zugriff: Was ist der Unterschied?.
Bestätige, dass die Verbindung erfolgreich hergestellt wurde
Verwende das Erfolgssignal für deinen Client:
Claude Desktop: Metricool wird unter Connectors als verbunden angezeigt.
Claude Code: Nach der Browser-Autorisierung zeigt /mcp Metricool als verbunden an.
Cursor: Nach der Browser-Autorisierung wird Cursor mit einer bestehenden Metricool-Verbindung erneut geöffnet.
Gemini CLI: Nach /mcp auth metricool und der Browser-Autorisierung ist MCP in der Terminalsitzung verbunden.
ChatGPT: Metricool ist unter Apps verbunden, nachdem du dich angemeldet und Zugriff gewährt hast. Die vollständigen Schritte findest du unter So verbindest du Metricool MCP mit ChatGPT.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N: Nach dem Gewähren des Zugriffs (oder dem Speichern der Header-Zugangsdaten in N8N) zeigt der Client den Connector oder die Tools als verfügbar an.
Zugriff widerrufen und Verbindung erneut herstellen
Um den Zugriff zu widerrufen, entferne oder trenne den Metricool-Connector von dem KI-Client oder der Plattform, auf der du ihn autorisiert hast (z. B. Claude, ChatGPT, Cursor oder einen anderen MCP-Client). Du kannst diese Connector-Berechtigung nicht innerhalb von Metricool widerrufen.
Nachdem du den Zugriff auf der Plattform widerrufen hast, stelle die Verbindung erneut her, indem du die Verbindungsschritte für diesen Client wiederholst und bei Bedarf erneut Zugriff gewährst.