​
MCP tools

Ocoya udostępnia 22 narzędzia MCP. Klienci MCP wywołują te narzędzia przez standardową metodę JSON-RPC tools/call, ale większość klientów robi to automatycznie, gdy poprosisz po prostu o akcję Ocoya w języku naturalnym.

Najpierw używaj narzędzi listujących, żeby ustalić ID brandu, profilu, posta, brandu, szablonu i workflow. Potem przekaż te ID do narzędzi zapisujących.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ocoya_list_brands",
    "arguments": {}
  }
}

​
Tool categories

CategoryToolsTypical use
Account and brandocoya_get_me, ocoya_list_brands, ocoya_get_brandZidentyfikuj autoryzowanego użytkownika i ustal ID brandów.
Social profilesocoya_list_social_profiles, ocoya_generate_social_connection_url, ocoya_get_social_profileWybierz kanały publikacji i rozpocznij proces podłączania profili społecznościowych.
Posts and calendarocoya_list_posts, ocoya_list_calendar_posts, ocoya_get_post, ocoya_update_post, ocoya_create_post, ocoya_create_ai_post, ocoya_create_ai_campaign, ocoya_schedule_post, ocoya_delete_postTwórz szkice, generuj, kolejkuj kampanie AI, sprawdzaj, aktualizuj, planuj, publikuj i usuwaj treści.
Creative contextocoya_list_hashtag_libraries, ocoya_list_studio_templatesZnajduj biblioteki hashtagów i szablony Studio do generowanych postów.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowPrzeglądaj, włączaj, wyłączaj i uruchamiaj automatyzacje.
1

Resolve the brand

Wywołaj ocoya_list_brands, opcjonalnie z query, i zachowaj zwrócone id jako brandId.

2

Resolve target channels

Dla zadań publikacji wywołaj ocoya_list_social_profiles z brandId i zapisz docelowe socialProfileIds.

3

Resolve optional context

Użyj ocoya_list_hashtag_libraries lub ocoya_list_studio_templates, gdy post ma korzystać z zapisanych hashtagów lub referencji wizualnych.

4

Call the write tool

Twórz, aktualizuj, planuj, publikuj, usuwaj, przełączaj lub uruchamiaj dopiero wtedy, gdy ID i intencja użytkownika są jasne.

Używaj dat w formacie ISO do planowania:

2026-07-01T09:00:00Z

​
Account and brand

ocoya_get_me

Zwraca autoryzowanego użytkownika Ocoya dla bieżącej zgody MCP OAuth.

ocoya_list_brands

Wypisuje lub wyszukuje brandy zatwierdzone dla bieżącego połączenia MCP.

ocoya_get_brand

Pobiera szczegóły brandu po ustaleniu jego ID.

​
Social profiles

ocoya_list_social_profiles

Wypisuje podłączone kanały dla zatwierdzonego brandu.

Generate social connection URL

Generuje adres URL w przeglądarce, który rozpoczyna nowy proces podłączania profilu społecznościowego.

ocoya_get_social_profile

Pobiera szczegóły jednego podłączonego profilu społecznościowego.

​
Posts and calendar

ocoya_list_posts

Wyszukuje grupy postów po statusie, opisie (caption) i paginacji.

ocoya_list_calendar_posts

Wypisuje zaplanowane posty w zadanym przedziale dat.

ocoya_get_post

Pobiera pełne szczegóły jednej grupy postów.

ocoya_create_post

Tworzy szkic, planuje post lub publikuje od razu.

ocoya_create_ai_post

Generuje gotowy do edycji szkic AI z opcjonalnymi referencjami hashtagów, profili i Studio.

ocoya_create_ai_campaign

Kolejkuje generowanie wielopostowej kampanii AI i od razu zwraca odpowiedź ze statusem GENERATING.

ocoya_update_post

Aktualizuje caption, harmonogram, stan publikacji, media lub podłączone profile społecznościowe.

ocoya_schedule_post

Planuje lub zmienia termin istniejącej grupy postów.

ocoya_delete_post

Usuwa grupę postów i anuluje powiązane harmonogramy.

​
Creative context

ocoya_list_hashtag_libraries

Znajduje wielokrotnego użytku biblioteki hashtagów do generowanych szkiców.

ocoya_list_studio_templates

Znajduje ID szablonów Studio do użycia jako referencje wizualne.

​
Workflows

ocoya_list_workflows

Wypisuje ID workflow i informację, czy są włączone, dla danego brandu.

ocoya_get_workflow

Pobiera metadane workflow i dostępne opcje kroków.

ocoya_toggle_workflow

Włącza lub wyłącza workflow.

ocoya_run_workflow

Kolejkuje natychmiastowe uruchomienie workflow z opcjonalnymi danymi wejściowymi.

​
Write actions

Poniższe narzędzia mogą zmieniać stan brandu:

  • ocoya_create_post
  • ocoya_create_ai_post
  • ocoya_update_post
  • ocoya_schedule_post
  • ocoya_delete_post
  • Generate social connection URL
  • ocoya_toggle_workflow
  • ocoya_run_workflow

Zawsze upewnij się co do intencji użytkownika przed natychmiastową publikacją, usunięciem, zmianami workflow lub akcjami związanymi z podłączaniem profili społecznościowych.