What is MCP?
MCP, czyli Model Context Protocol, to standardowy sposób, w jaki klienci AI łączą się z zewnętrznymi produktami. Zamiast kazać asystentowi zgadywać, jak działa Ocoya, łączysz asystenta z Ocoya MCP, a on może odkrywać typowane narzędzia dla obsługiwanych akcji.
Ocoya MCP udostępnia narzędzia do zarządzania marką, publikowaniem, Studio i workflow po tym, jak użytkownik zatwierdzi dostęp OAuth.
Połączenie klienta AI
Claude, ChatGPT, Codex, VS Code lub inny klient zgodny z MCP łączy się z https://mcp.ocoya.com przez Streamable HTTP MCP.
Użytkownik zatwierdza dostęp
Ocoya otwiera przepływ autoryzacji OAuth, w którym użytkownik się loguje, przegląda uprawnienia i wybiera marki, do których klient może mieć dostęp.
Narzędzia Ocoya stają się dostępne
Zatwierdzony klient może tworzyć i zarządzać postami, planować treści, stosować kontekst marki i uruchamiać workflow w wybranych markach.
Why use MCP for Ocoya?
MCP przydaje się, gdy chcesz, aby asystent AI wykonywał akcje w produkcie bezpośrednio i bezpiecznie:
- Asystent może odkrywać narzędzia Ocoya zamiast wymyślać wywołania API.
- Użytkownicy zatwierdzają dostęp przez OAuth zamiast kopiować klucze API.
- Dostęp do marki jest ograniczony do marek wybranych podczas zatwierdzania.
- Wywołania narzędzi zwracają ustrukturyzowane dane, które klienci mogą wykorzystać w kolejnych akcjach.
What Ocoya exposes
Ocoya MCP daje zatwierdzonym klientom narzędzia do:
| Area | What the assistant can do |
|---|---|
| Account and brand | Identyfikacja autoryzowanego użytkownika i lista zatwierdzonych marek. |
| Social profiles | Lista podłączonych kanałów i uruchamianie nowych przepływów łączenia profili społecznościowych. |
| Posts | Tworzenie, przeglądanie, aktualizowanie, planowanie, publikowanie i usuwanie grup postów. |
| AI drafts | Generowanie edytowalnych szkiców postów na podstawie promptów i opcjonalnego kontekstu wizualnego. |
| Creative context | Lista bibliotek hashtagów i szablonów Studio. |
| Workflows | Lista, podgląd, włączanie, wyłączanie i uruchamianie workflow. |
Authentication model
Ocoya MCP używa OAuth. Klient nie może korzystać z Ocoya MCP przy użyciu Ocoya API key.
Gdy klient po raz pierwszy potrzebuje narzędzia Ocoya, otwiera Ocoya w przeglądarce. Użytkownik loguje się, przegląda wymagane uprawnienia, wybiera dozwolone marki i zatwierdza klienta.
Klient otrzymuje krótkotrwały token dostępu i może odświeżać dostęp zgodnie z przepływem OAuth. Jeśli marka nie została wybrana podczas zatwierdzania, narzędzia nie mogą uzyskać do niej dostępu.
MCP vs REST API
Użyj MCP, gdy klient AI ma działać w imieniu użytkownika, korzystając z języka naturalnego i wywołań narzędzi.
Użyj REST API, gdy tworzysz integrację backendową, zaplanowane zadanie lub aplikację, która wywołuje endpointy Ocoya bezpośrednio.