"Bearer token required" / 401 en cada llamada
El cliente MCP no ha completado OAuth o su refresh token ha sido revocado. En claude.ai: Settings → Connectors → Antwork → Disconnect, y vuelve a conectar. En Claude Code: /mcp → elige antwork → Re-authenticate.
La publicación falla en una plataforma pero funciona en las demás
publish_post devuelve el estado por plataforma. La causa más común es una cuenta social cuyo token expiró o se revocó desde la plataforma. Ejecuta list_social_accounts para encontrar cuentas con problemas y reconéctalas vía la URL de consentimiento que devuelve get_connection_urls, luego llama a retry_failed_post.
"El post se queda como DRAFT después de pedir programarlo"
create_post solo crea un borrador. Tu asistente debe encadenar con schedule_post(post_id, scheduled_for) o publish_post(post_id). El Antwork Poster Skill (github.com/iker-gonzalez/antwork-skills) codifica este two-step para que Claude no lo salte.
El post fue a la cuenta equivocada (múltiples cuentas por plataforma)
Una publicación está ligada a una cuenta: create_post recibe un account_id, y pasarlo es la forma de elegir entre dos páginas de LinkedIn. Si lo omites, Antwork resuelve la primera cuenta sana de esa plataforma. list_social_accounts devuelve los ids, y el resultado de cualquier herramienta de espacio de trabajo ya los trae en workspaceAccounts.
La subida de media se descarta silenciosamente
attach_media requiere una URL de Firebase Storage — pasa primero las URLs externas por upload_media para que se almacenen en el storage del workspace. El publisher rechaza URLs que no sean de storage.
Rate limits
Antwork no limita la frecuencia de las llamadas a herramientas. Los límites que puedes alcanzar son los de las plataformas: LinkedIn permite unas 150 publicaciones al día y X unas 300 cada 3 horas, y ambas rechazan la petición en vez de encolarla, así que la publicación queda en failed con el motivo de la plataforma.
Origin bloqueado / error CORS en clientes basados en navegador
El servidor valida la cabecera Origin en Streamable HTTP según la spec MCP. Los orígenes permitidos son los hosts first-party de Antwork, claude.ai, claude.com, console.anthropic.com y localhost. Si alojas un cliente propio en otro origen, contáctanos para añadirlo a la lista.
Contacto
¿Preguntas, ayuda con la integración o bugs? Escríbenos.