​
MCP troubleshooting

A maioria dos problemas com o MCP do Ocoya vem da configuração do cliente, de aprovação OAuth incompleta, de falta de acesso a marcas ou de utilização de IDs da marca errada.

​
Quick checks

SymptomWhat to check
Client does not list Ocoya toolsConfirme que o URL do MCP é https://mcp.ocoya.com, reinicie o cliente e verifique se o cliente suporta servidores MCP HTTP remotos.
OAuth opens but access is deniedInicie sessão na conta Ocoya correta e aprove pelo menos uma marca.
401 responseO cliente não concluiu o OAuth, o token de acesso expirou ou o cliente está a enviar uma API key em vez de usar OAuth.
Brand not foundA marca não foi selecionada durante a aprovação ou o cliente está a usar um ID de marca de outra conta Ocoya.
Social profile rejectedChame ocoya_list_social_profiles para o mesmo brandId e use um dos IDs devolvidos.
Invalid scheduleUse um datetime ISO como 2026-07-01T09:00:00Z.
Workflow cannot be enabledResolva os erros de validação do workflow no Ocoya antes de o ativar ou executar.

​
OAuth and authorization

O MCP do Ocoya não aceita Ocoya API keys. Os clientes MCP devem usar OAuth e enviar um bearer token emitido pelo Ocoya depois de você aprovar o acesso.

Para diagnóstico, um pedido não autenticado deve devolver 401 com um cabeçalho WWW-Authenticate que aponta para os metadados OAuth do Ocoya:

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

Se um cliente continuar a falhar no OAuth, remova a ligação MCP do Ocoya desse cliente, volte a adicioná-la e conclua o fluxo de aprovação num browser onde você possa iniciar sessão no Ocoya.

​
Brand access

As ferramentas com âmbito de marca exigem um brandId devolvido por ocoya_list_brands. Se faltar uma marca:

  1. Volte a ligar o MCP do Ocoya.
  2. Selecione a marca em falta durante o fluxo de aprovação OAuth.
  3. Peça ao cliente para chamar ocoya_list_brands novamente.

Não reutilize IDs de marca de outra conta, ambiente ou autorização OAuth.

​
Posting and scheduling

Antes de criar ou agendar publicações, peça ao cliente para obter novamente IDs atualizados:

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

Use o brandId e os socialProfileIds devolvidos nas ferramentas de publicações. Para agendamento, envie datetimes ISO:

2026-07-01T09:00:00Z

​
Client-specific notes

ClientCheck
Claude CodeColoque URLs entre aspas se o seu shell tratar caracteres especiais de forma diferente. Reinicie o Claude Code depois de adicionar um novo servidor MCP.
CodexReinicie a aplicação ou abra uma nova thread depois de editar ~/.codex/config.toml. Execute codex mcp login ocoya quando for necessário o login OAuth.
VS CodeUse uma versão recente do VS Code com suporte MCP e mude o Copilot Chat para o modo Agent.
Stdio-only clientsUse mcp-remote para fazer a ponte com https://mcp.ocoya.com.

​
Safe recovery

Se a ligação parecer desatualizada ou se a conta errada estiver ligada:

  1. Revogue ou remova a ligação MCP do Ocoya no cliente.
  2. Adicione novamente o servidor MCP.
  3. Conclua o OAuth com a conta Ocoya pretendida.
  4. Selecione as marcas a que o cliente deve aceder.
  5. Verifique com ocoya_list_brands antes de ações de escrita.