MCP troubleshooting
Die meisten Ocoya MCP‑Probleme entstehen durch Client-Konfiguration, unvollständige OAuth-Freigabe, fehlenden Brand-Zugriff oder das Verwenden von IDs aus dem falschen Brand.
Quick checks
| Symptom | Was du prüfen solltest |
|---|---|
| Client does not list Ocoya tools | Überprüfe, ob die MCP-URL https://mcp.ocoya.com ist, starte den Client neu und stell sicher, dass der Client Remote-HTTP-MCP-Server unterstützt. |
| OAuth opens but access is denied | Melde dich im richtigen Ocoya-Konto an und erlaube mindestens einen Brand. |
401 response | Der Client hat OAuth nicht abgeschlossen, das Access Token ist abgelaufen oder der Client sendet einen API Key statt OAuth zu verwenden. |
| Brand not found | Der Brand wurde während der Freigabe nicht ausgewählt oder der Client verwendet eine Brand-ID aus einem anderen Ocoya-Konto. |
| Social profile rejected | Rufe ocoya_list_social_profiles für dieselbe brandId auf und verwende eine der zurückgegebenen IDs. |
| Invalid schedule | Verwende ein ISO-Datum mit Uhrzeit wie 2026-07-01T09:00:00Z. |
| Workflow cannot be enabled | Behebe zunächst die Workflow-Validierungsfehler in Ocoya, bevor du ihn umschaltest oder ausführst. |
OAuth and authorization
Ocoya MCP akzeptiert keine Ocoya API Keys. MCP-Clients sollten OAuth verwenden und ein Bearer Token senden, das von Ocoya ausgegeben wird, nachdem der User den Zugriff freigegeben hat.
Zur Diagnose sollte eine nicht authentifizierte Anfrage 401 zurückgeben, mit einem WWW-Authenticate‑Header, der auf die Ocoya OAuth-Metadaten verweist:
curl -i https://mcp.ocoya.com \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'Wenn ein Client wiederholt bei OAuth scheitert, entferne die Ocoya MCP-Verbindung in diesem Client, füge sie erneut hinzu und schließe den Freigabe-Flow in einem Browser ab, in dem du dich bei Ocoya anmelden kannst.
Brand access
Brand-spezifische Tools benötigen eine brandId, die von ocoya_list_brands zurückgegeben wird. Wenn ein Brand fehlt:
- Verbinde Ocoya MCP neu.
- Wähle den fehlenden Brand während des OAuth-Freigabe-Flows aus.
- Bitte den Client,
ocoya_list_brandserneut aufzurufen.
Verwende keine Brand-IDs aus einem anderen Konto, einer anderen Umgebung oder einem anderen OAuth-Grant erneut.
Posting and scheduling
Bevor du Posts erstellst oder planst, lass den Client aktuelle IDs ermitteln:
List my Ocoya brands and connected social profiles for the Acme brand.Verwende die zurückgegebene brandId und socialProfileIds in Post-Tools. Für die Planung übergib ISO-Datetime-Werte:
2026-07-01T09:00:00ZClient-specific notes
| Client | Prüfen |
|---|---|
| Claude Code | Setze URLs in Anführungszeichen, wenn deine Shell Sonderzeichen anders behandelt. Starte Claude Code neu, nachdem du einen neuen MCP-Server hinzugefügt hast. |
| Codex | Starte die App neu oder öffne einen neuen Thread, nachdem du ~/.codex/config.toml bearbeitet hast. Führe codex mcp login ocoya aus, wenn ein OAuth-Login erforderlich ist. |
| VS Code | Verwende eine aktuelle VS Code-Version mit MCP-Unterstützung und stelle Copilot Chat auf Agent Mode um. |
| Stdio-only clients | Verwende mcp-remote, um eine Bridge zu https://mcp.ocoya.com herzustellen. |
Safe recovery
Wenn die Verbindung veraltet wirkt oder das falsche Konto verbunden ist:
- Widerrufe oder entferne die Ocoya MCP-Verbindung im Client.
- Füge den MCP-Server erneut hinzu.
- Schließe OAuth mit dem gewünschten Ocoya-Konto ab.
- Wähle die Brands aus, auf die der Client zugreifen soll.
- Prüfe mit
ocoya_list_brands, bevor du Schreibaktionen ausführst.