Ich kann keine Verbindung zu Metricool MCP herstellen
Aktualisiert vor 2 Monaten
Verwende den Production-MCP-Endpunkt von Metricool https://ai.metricool.com/mcp, richte deinen KI-Client mit der passenden Verbindungsmethode ein und arbeite dann die Prüfungen unten durch, falls der Server keine Verbindung herstellt.
Bestätige diese Punkte, bevor du dich in client-spezifische Korrekturen vertiefst:
Endpunkt: Verwende genau die Production-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 den OAuth-Login ab und erteile Zugriff, oder richte die Header-Authentifizierung mit dem Metricool API-Schlüssel ein, wenn der Client das verlangt.
Client-Voraussetzungen: Claude Code braucht ein Pro- oder Max-Abonnement; Cursor braucht die Cursor Desktop-App; Claude Free kann nur jeweils einen benutzerdefinierten Connector verwenden. Vollständige Liste: MCP limits and plan requirements.
Erfolgsanzeige: 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 falsche Methode zu verwenden ist ein häufiger Grund dafür, dass der MCP-Server nie mit dem Verbinden fertig wird.
Verbindungsmethode
So authentifizierst du dich
Unterstützte Clients
URL-basiert (HTTP/OAuth)
Füge die MCP-URL ein und melde dich dann bei Metricool an, um Zugriff zu gewähren
Setze den Header-Namen X-Mc-Auth auf deinen Metricool API-Schlüssel aus Kontoeinstellungen > API
N8N
CLI
Füge den MCP über HTTP/CLI hinzu und authentifiziere dich dann, wenn du dazu aufgefordert wirst
Claude Code, Gemini CLI
mcp-remote
Führe npx mcp-remote gegen die Metricool-URL aus, dann OAuth oder X-Mc-Auth
Claude Desktop
Weitere dokumentierte Auth-Optionen für MCP-Clients sind der OAuth-Login oder das Bereitstellen von METRICOOL_USER_TOKEN und METRICOOL_USER_ID in der Client-Konfiguration. Siehe Häufig gestellte Fragen about the Metricool MCP.
Verbindungsprobleme
Öffne das Symptom, das zu dem passt, was du siehst. Jeder Abschnitt behandelt einen verifizierten Fehlermodus und die Lösung.
Claude Desktop stellt über den üblichen Weg keine Verbindung her
Claude Desktop hat einen dokumentierten externen Fehler, der den üblichen MCP-Verbindungsweg blockiert. Verwende stattdessen mcp-remote.
Öffne in Claude Desktop über dein Profil Settings.
Gehe zu Developer → Edit config unter Local MCP servers.
Speichere die Datei und starte Claude Desktop neu.
Wenn du OAuth verwendet hast, schließe die Browser-Autorisierung ab, wenn du dazu aufgefordert wirst. Wenn du die API-Schlüssel-Methode verwendet hast, wird der Browser-Schritt übersprungen.
Öffne in einem Chat Connectors und bestätige, dass Metricool verbunden ist.
Der Client beendet die Verbindung nie oder bleibt nicht authentifiziert
Der Endpunkt, die Methode oder der Autorisierungsschritt ist unvollständig. Behebe das in dieser Reihenfolge:
Bestätige, dass die Server-URL genau https://ai.metricool.com/mcp ist (kein zusätzlicher Pfad, kein Leerzeichen und kein anderer Host).
Bestätige, dass dein Client die Methode aus der Tabelle oben verwendet. Zum Beispiel braucht N8N Header-Authentifizierung und nicht ein reines OAuth-Setup; Claude Desktop braucht mcp-remote.
Schließe die Browser-Anmeldung ab und wähle Grant access, wenn Metricool nach Berechtigungen fragt.
In Cursor kann der Server nach der Installation als nicht authentifiziert erscheinen, bis du auf Connect klickst und die Browser-Autorisierung abschließt.
In Gemini CLI führe nach dem Hinzufügen der Konfiguration /mcp auth metricool aus und schließe die Browser-Autorisierung ab.
In Claude Code führe /mcp aus, wähle Metricool aus und authentifiziere dich dann, wenn du dazu aufgefordert wirst.
N8N-Header-Authentifizierung schlägt fehl
N8N verbindet sich mit Header-Token-Authentifizierung, nicht mit dem URL-only-OAuth-Flow, den die meisten anderen Clients verwenden.
Im MCP Client Tool setze den Endpunkt auf https://ai.metricool.com/mcp.
Setze Authentication auf Header Auth.
Erstelle eine Anmeldedaten mit dem Namen X-Mc-Auth.
Speichere die Anmeldedaten und versuche den Workflow erneut.
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. Free-Nutzer können jeweils nur einen benutzerdefinierten Connector verwenden.
Entferne oder ersetze den vorhandenen benutzerdefinierten Connector und verbinde Metricool dann erneut. Claude Code benötigt weiterhin ein Pro- oder Max-Abonnement. Siehe How to connect Metricool's MCP with Claude.
Claude Code akzeptiert den MCP-add-Befehl nicht
Claude Code erfordert ein Pro- oder Max-Abonnement und die Installation über die Produktseite von Claude Code, bevor du Metricool hinzufügen kannst.
Bestätige, dass Claude Code installiert ist und du auf Pro oder Max bist.
Führe 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 Metricool MCP-Installationsablauf nicht an
Die Cursor-MCP-Einrichtung erfordert die Cursor Desktop-App. Browser-only-Cursor kann den dokumentierten Installationsweg nicht abschließen.
Klicke auf Connect, autorisiere Metricool im Browser und kehre dann zu Cursor zurück, um die Verbindung zu bestätigen.
Der MCP verbindet sich, aber Aktionen schlagen fehl oder die Daten wirken eingeschränkt
Das ist normalerweise ein plan-Limit und keine fehlgeschlagene Serververbindung. Der MCP funktioniert auf Free- und kostenpflichtigen tarife, aber die Metricool plan-Limits gelten weiterhin dafür, was der MCP abfragen oder planen kann.
Prüfe Beispiele für den Free-tarife, clientseitige Voraussetzungen und die MCP-vs.-API-Abgrenzung in MCP limits and plan requirements. Wenn du programmatischen HTTP-Zugriff außerhalb eines KI-Clients brauchst, ist das die Metricool API (Advanced oder Custom) und nicht MCP. Siehe MCP vs API access: what is the difference?.
Bestätige, dass die Verbindung erfolgreich war
Verwende die Erfolgsanzeige für deinen Client:
Claude Desktop: Metricool erscheint unter Connectors als verbunden.
Claude Code: Nach der Browser-Autorisierung zeigt /mcp Metricool als verbunden an.
Cursor: Nach der Browser-Autorisierung öffnet sich Cursor erneut mit verbundenem Metricool.
Gemini CLI: Nach /mcp auth metricool und der Browser-Autorisierung ist der MCP in der Terminal-Sitzung verbunden.
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 erneut verbinden
Um den Zugriff zu widerrufen, entferne oder trenne den Metricool-Connector in dem KI-Client oder der Plattform, auf der du ihn autorisiert hast (zum Beispiel Claude, ChatGPT, Cursor oder ein anderer MCP-Client). Du kannst diese Connector-Berechtigung nicht innerhalb von Metricool widerrufen.
Nachdem du den Zugriff auf der Plattform widerrufen hast, verbinde dich erneut, indem du die Verbindungsschritte dieses Clients wiederholst und erneut Zugriff gewährst, wenn du den MCP wieder brauchst.