​
MCP troubleshooting

La maggior parte dei problemi con Ocoya MCP deriva dalla configurazione del client, da un’approvazione OAuth incompleta, dalla mancanza di accesso a un brand o dall’uso di ID di un brand sbagliato.

​
Quick checks

SymptomWhat to check
Client does not list Ocoya toolsVerifica che l’URL MCP sia https://mcp.ocoya.com, riavvia il client e assicurati che il client supporti server MCP HTTP remoti.
OAuth opens but access is deniedAccedi all’account Ocoya corretto e approva almeno un brand.
401 responseIl client non ha completato OAuth, il token di accesso è scaduto oppure il client sta inviando una API key invece di usare OAuth.
Brand not foundIl brand non è stato selezionato durante l’approvazione oppure il client sta usando un brand ID da un altro account Ocoya.
Social profile rejectedChiama ocoya_list_social_profiles per lo stesso brandId e usa uno degli ID restituiti.
Invalid scheduleUsa una data/ora ISO come 2026-07-01T09:00:00Z.
Workflow cannot be enabledRisolvi gli errori di validazione del workflow in Ocoya prima di abilitarlo o eseguirlo.

​
OAuth and authorization

Ocoya MCP non accetta le API key di Ocoya. I client MCP devono usare OAuth e inviare un bearer token emesso da Ocoya dopo che l’utente ha approvato l’accesso.

Per la diagnostica, una richiesta non autenticata dovrebbe restituire 401 con un header WWW-Authenticate che punta ai metadati OAuth di Ocoya:

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

Se un client continua a fallire OAuth, rimuovi la connessione Ocoya MCP da quel client, aggiungila di nuovo e completa il flusso di approvazione da un browser in cui puoi accedere a Ocoya.

​
Brand access

Gli strumenti con ambito brand richiedono un brandId restituito da ocoya_list_brands. Se manca un brand:

  1. Riconnetti Ocoya MCP.
  2. Seleziona il brand mancante durante il flusso di approvazione OAuth.
  3. Chiedi al client di chiamare di nuovo ocoya_list_brands.

Non riutilizzare brand ID da un altro account, ambiente o grant OAuth.

​
Posting and scheduling

Prima di creare o programmare post, chiedi al client di recuperare ID aggiornati:

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

Usa il brandId e i socialProfileIds restituiti negli strumenti per i post. Per la programmazione, passa date/ore in formato ISO:

2026-07-01T09:00:00Z

​
Client-specific notes

ClientCheck
Claude CodeMetti gli URL tra virgolette se la tua shell gestisce i caratteri speciali in modo diverso. Riavvia Claude Code dopo aver aggiunto un nuovo server MCP.
CodexRiavvia l’app oppure apri un nuovo thread dopo aver modificato ~/.codex/config.toml. Esegui codex mcp login ocoya quando è richiesto l’accesso OAuth.
VS CodeUsa una versione recente di VS Code con supporto MCP e imposta Copilot Chat in modalità Agent.
Stdio-only clientsUsa mcp-remote per fare da ponte con https://mcp.ocoya.com.

​
Safe recovery

Se la connessione sembra obsoleta o è collegato l’account sbagliato:

  1. Revoca o rimuovi la connessione Ocoya MCP nel client.
  2. Aggiungi di nuovo il server MCP.
  3. Completa OAuth con l’account Ocoya desiderato.
  4. Seleziona i brand a cui il client deve avere accesso.
  5. Verifica con ocoya_list_brands prima delle azioni di scrittura.