What is MCP?
MCP, oder Model Context Protocol, ist eine standardisierte Möglichkeit für AI-Clients, sich mit externen Produkten zu verbinden. Anstatt eine Assistenz raten zu lassen, wie Ocoya funktioniert, verbindest du die Assistenz mit Ocoya MCP und sie kann typisierte Tools für unterstützte Aktionen entdecken.
Ocoya MCP stellt nach Freigabe des OAuth-Zugriffs durch den User Tools für Brand, Publishing, Brand, Studio und Workflows bereit.
AI client connects
Claude, ChatGPT, Codex, VS Code oder ein anderer MCP-kompatibler Client verbindet sich über Streamable HTTP MCP mit https://mcp.ocoya.com.
User approves access
Ocoya öffnet einen OAuth-Freigabe-Flow, in dem sich der User anmeldet, Berechtigungen prüft und die Brands auswählt, auf die der Client zugreifen darf.
Ocoya tools become available
Der genehmigte Client kann in den ausgewählten Brands Posts erstellen und verwalten, Inhalte einplanen, Brand-Kontext anwenden und Workflows ausführen.
Why use MCP for Ocoya?
MCP ist hilfreich, wenn du möchtest, dass eine AI-Assistenz Produktaktionen direkt und sicher ausführt:
- Die Assistenz kann Ocoya-Tools entdecken, statt API-Calls zu erfinden.
- User geben Zugriff per OAuth frei, statt API-Keys zu kopieren.
- Brand-Zugriff ist auf die während der Freigabe ausgewählten Brands beschränkt.
- Tool-Aufrufe liefern strukturierte Daten zurück, die Clients für nachfolgende Aktionen nutzen können.
What Ocoya exposes
Ocoya MCP stellt genehmigten Clients Tools für Folgendes bereit:
| Area | What the assistant can do |
|---|---|
| Account and brand | Den autorisierten User identifizieren und genehmigte Brands auflisten. |
| Social profiles | Verknüpfte Kanäle auflisten und neue Social-Verbindungsflows starten. |
| Posts | Post-Gruppen erstellen, prüfen, aktualisieren, einplanen, veröffentlichen und löschen. |
| AI drafts | Bearbeitbare Entwürfe aus Prompts und optionalem visuellen Kontext generieren. |
| Creative context | Hashtag-Bibliotheken und Studio-Templates auflisten. |
| Workflows | Workflows auflisten, prüfen, aktivieren, deaktivieren und ausführen. |
Authentication model
Ocoya MCP verwendet OAuth. Ein Client kann Ocoya MCP nicht mit einem Ocoya API-Key verwenden.
Wenn der Client zum ersten Mal ein Ocoya-Tool benötigt, öffnet er Ocoya im Browser. Der User meldet sich an, prüft die angeforderten Berechtigungen, wählt erlaubte Brands aus und genehmigt den Client.
Der Client erhält ein kurzlebiges Access-Token und kann den Zugriff gemäß dem OAuth-Flow erneuern. Wurde eine Brand während der Freigabe nicht ausgewählt, können Tools nicht auf diese Brand zugreifen.
MCP vs REST API
Verwende MCP, wenn ein AI-Client im Namen des Users über natürliche Sprache und Tool-Aufrufe handeln soll.
Verwende die REST API, wenn du eine Backend-Integration, einen geplanten Job oder eine Anwendung baust, die Ocoya-Endpunkte direkt aufruft.