​
MCP troubleshooting

La mayoría de problemas con Ocoya MCP vienen de la configuración del cliente, una aprobación OAuth incompleta, falta de acceso a la marca o uso de IDs de una marca incorrecta.

​
Quick checks

SymptomWhat to check
Client does not list Ocoya toolsConfirma que la URL MCP es https://mcp.ocoya.com, reinicia el cliente y asegúrate de que el cliente admite servidores MCP HTTP remotos.
OAuth opens but access is deniedInicia sesión en la cuenta correcta de Ocoya y aprueba al menos una marca.
401 responseEl cliente no ha completado OAuth, el token de acceso ha caducado o el cliente está enviando una API key en lugar de usar OAuth.
Brand not foundLa marca no se seleccionó durante la aprobación o el cliente está usando un ID de marca de otra cuenta de Ocoya.
Social profile rejectedLlama a ocoya_list_social_profiles para el mismo brandId y usa uno de los IDs devueltos.
Invalid scheduleUsa una fecha y hora ISO como 2026-07-01T09:00:00Z.
Workflow cannot be enabledResuelve los errores de validación del workflow en Ocoya antes de activarlo o ejecutarlo.

​
OAuth and authorization

Ocoya MCP no acepta API keys de Ocoya. Los clientes MCP deben usar OAuth y enviar un bearer token emitido por Ocoya después de que el usuario apruebe el acceso.

Para diagnóstico, una petición no autenticada debería devolver 401 con una cabecera WWW-Authenticate que apunte a los metadatos OAuth de Ocoya:

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

Si un cliente sigue fallando en OAuth, elimina la conexión Ocoya MCP de ese cliente, añádela de nuevo y completa el flujo de aprobación desde un navegador donde puedas iniciar sesión en Ocoya.

​
Brand access

Las herramientas con ámbito de marca requieren un brandId devuelto por ocoya_list_brands. Si falta una marca:

  1. Vuelve a conectar Ocoya MCP.
  2. Selecciona la marca que falta durante el flujo de aprobación OAuth.
  3. Pide al cliente que llame de nuevo a ocoya_list_brands.

No reutilices IDs de marca de otra cuenta, entorno o concesión OAuth.

​
Posting and scheduling

Antes de crear o programar publicaciones, pide al cliente que resuelva IDs recientes:

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

Usa el brandId y los socialProfileIds devueltos en las herramientas de publicación. Para programar, pasa fechas y horas en formato ISO:

2026-07-01T09:00:00Z

​
Client-specific notes

ClientCheck
Claude CodePon las URLs entre comillas si tu shell trata los caracteres especiales de forma diferente. Reinicia Claude Code después de añadir un nuevo servidor MCP.
CodexReinicia la app o abre un hilo nuevo después de editar ~/.codex/config.toml. Ejecuta codex mcp login ocoya cuando se requiera inicio de sesión OAuth.
VS CodeUsa una versión reciente de VS Code con soporte MCP y cambia Copilot Chat a Agent mode.
Stdio-only clientsUsa mcp-remote para hacer de puente con https://mcp.ocoya.com.

​
Safe recovery

Si la conexión parece desactualizada o está conectada la cuenta equivocada:

  1. Revoca o elimina la conexión Ocoya MCP en el cliente.
  2. Añade de nuevo el servidor MCP.
  3. Completa OAuth con la cuenta de Ocoya que quieras usar.
  4. Selecciona las marcas a las que el cliente debe acceder.
  5. Verifica con ocoya_list_brands antes de hacer acciones de escritura.