​
MCP troubleshooting

Większość problemów z Ocoya MCP wynika z konfiguracji klienta, niepełnego zatwierdzenia OAuth, braku dostępu do marki albo używania ID z niewłaściwej marki.

​
Quick checks

SymptomWhat to check
Client does not list Ocoya toolsSprawdź, czy MCP URL to https://mcp.ocoya.com, zrestartuj klienta i upewnij się, że klient obsługuje zdalne HTTP MCP serwery.
OAuth opens but access is deniedZaloguj się na właściwe konto Ocoya i zatwierdź co najmniej jedną markę.
401 responseKlient nie ukończył OAuth, token dostępu wygasł albo klient wysyła klucz API zamiast używać OAuth.
Brand not foundMarka nie została wybrana podczas zatwierdzania OAuth albo klient używa ID marki z innego konta Ocoya.
Social profile rejectedWywołaj ocoya_list_social_profiles dla tego samego brandId i użyj jednego ze zwróconych ID.
Invalid scheduleUżyj daty i godziny w formacie ISO, na przykład 2026-07-01T09:00:00Z.
Workflow cannot be enabledUsuń błędy walidacji workflow w Ocoya, zanim go przełączysz lub uruchomisz.

​
OAuth and authorization

Ocoya MCP nie akceptuje kluczy API Ocoya. Klienci MCP powinni używać OAuth i wysyłać bearer token wydany przez Ocoya po zatwierdzeniu dostępu przez użytkownika.

Do diagnostyki niezautoryzowane żądanie powinno zwrócić 401 z nagłówkiem WWW-Authenticate, który wskazuje metadane OAuth Ocoya:

curl -i https://mcp.ocoya.com \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Jeśli klient wciąż ma problem z OAuth, usuń połączenie Ocoya MCP w tym kliencie, dodaj je ponownie i dokończ proces zatwierdzania w przeglądarce, w której możesz zalogować się do Ocoya.

​
Brand access

Narzędzia działające w kontekście marki wymagają brandId zwróconego przez ocoya_list_brands. Jeśli brakuje marki:

  1. Połącz ponownie Ocoya MCP.
  2. Wybierz brakującą markę podczas przepływu zatwierdzania OAuth.
  3. Poproś klienta o ponowne wywołanie ocoya_list_brands.

Nie używaj ponownie ID marek z innego konta, środowiska ani zgody OAuth.

​
Posting and scheduling

Zanim utworzysz lub zaplanujesz posty, poproś klienta o pobranie świeżych ID:

List my Ocoya brands and connected social profiles for the Acme brand.

Użyj zwróconych brandId i socialProfileIds w narzędziach do postów. Do planowania wysyłaj daty w formacie ISO:

2026-07-01T09:00:00Z

​
Client-specific notes

ClientCheck
Claude CodeObejmij URL-e cudzysłowami, jeśli twoja powłoka inaczej traktuje znaki specjalne. Zrestartuj Claude Code po dodaniu nowego MCP serwera.
CodexZrestartuj aplikację lub otwórz nowy wątek po edycji ~/.codex/config.toml. Uruchom codex mcp login ocoya, gdy wymagane jest logowanie OAuth.
VS CodeUżywaj aktualnej wersji VS Code z obsługą MCP i przełącz Copilot Chat w tryb Agent.
Stdio-only clientsUżyj mcp-remote, aby zmostkować https://mcp.ocoya.com.

​
Safe recovery

Jeśli połączenie wydaje się nieaktualne albo podłączone jest niewłaściwe konto:

  1. Cofnij lub usuń połączenie Ocoya MCP w kliencie.
  2. Dodaj MCP serwer ponownie.
  3. Ukończ OAuth z docelowym kontem Ocoya.
  4. Wybierz marki, do których klient ma mieć dostęp.
  5. Zweryfikuj wszystko za pomocą ocoya_list_brands przed działaniami zapisu.