Solución de problemas
Lo que ves cuando falla conectar tu IA, iniciar sesión, conectar cuentas o publicar, y cómo solucionarlo.
¿Usas ChatGPT? Sigue la guía de configuraciónConectar tu IA
ChatGPT: pegué el prompt de configuración y no se conectó
El prompt de configuración es para agentes que pueden cambiar su propia configuración, como Claude Code, Codex o Cursor. ChatGPT no puede: solo se conecta desde sus propios ajustes. En chatgpt.com desde el navegador (no la app del móvil), abre Ajustes → Seguridad e inicio de sesión y activa el Modo Desarrollador; después abre Plugins, pulsa +, elige Create app y luego Create MCP App, y pega https://api.antwork.io/mcp en Connection. La guía de configuración de ChatGPT muestra cada paso en un vídeo corto.
Abrí la URL del MCP y acabé en esta documentación
https://api.antwork.io/mcp es una dirección para tu cliente de IA, no una página web, así que al abrirla en una pestaña del navegador te trae aquí. Pégala en tu cliente: en el campo Connection de la nueva app en ChatGPT, o en MCP server URL del diálogo Add custom connector de Claude.
Codex: "malformed response", o reintenta sin pedirte iniciar sesión
Algunas versiones de Codex no inician el inicio de sesión por sí solas, así que el servidor sigue sin autorizar. Ejecuta tú el login y apruébalo en el navegador; hasta entonces, codex mcp list muestra Antwork como Not logged in. Si aún no has añadido Antwork a Codex, el comando de añadir de abajo lo añade e inicia sesión de una vez.
codex mcp login antworkcodex mcp add antwork --url https://api.antwork.io/mcpGemini CLI: "added to project settings", o Antwork aparece como Disabled
Sin --scope user el servidor solo se guarda para la carpeta donde ejecutaste el comando, y desde tu carpeta personal no se guarda en absoluto. Además, Gemini desactiva los servidores MCP en carpetas no confiables. Ejecuta el comando de abajo, inicia gemini, confía en la carpeta cuando te lo pregunte y ejecuta /mcp auth antwork para aprobar el inicio de sesión.
gemini mcp add --scope user --transport http antwork https://api.antwork.io/mcp --skip-trust"Esta solicitud ha caducado."
Una solicitud de conexión es válida durante 10 minutos, y esta caducó antes de aprobarse. No se conectó nada y tu cuenta no ha cambiado. Vuelve a iniciar la conexión desde tu cliente de IA y apruébala enseguida.
Está conectado, pero la IA nunca usa Antwork
Conectar solo pone a disposición las herramientas de Antwork. Las herramientas de programación como Cursor, Codex, VS Code y Gemini CLI las cargan en silencio y no las usan hasta que se lo pides, así que pídelo directamente, por ejemplo: "Redacta una publicación sobre el proyecto en el que estoy trabajando ahora mismo". Claude configura las herramientas de Antwork para pedir permiso antes de cada uso, así que aprueba la primera llamada.
Claude: no puedo añadir un conector personalizado
El plan gratuito de Claude permite un conector personalizado, así que si ya tienes uno, quítalo primero o pasa a Pro, Max, Team o Enterprise. En claude.ai abre Customize, luego Connectors, luego Add y Add custom connector. En una cuenta Team o Enterprise, puede que un propietario tenga que permitir los conectores personalizados antes.
Iniciar sesión
"El inicio de sesión con Google no está disponible en este navegador"
Los enlaces que abres dentro de Instagram, Facebook, LinkedIn, X, TikTok y apps similares se cargan en el navegador interno de la app, donde el inicio de sesión con Google no funciona. Toca el botón para abrir la página en Safari o Chrome. Si no pasa nada, usa el menú ⋯ o de compartir de la app y elige Abrir en el navegador, o inicia sesión con un enlace por email.
"No podemos conectar con Antwork ahora mismo"
Has iniciado sesión, pero la app no pudo cargar tu cuenta. Suele ser un corte breve de conexión, a menudo una red, una VPN o una extensión del navegador que bloquea la conexión. Pulsa Reintentar; si se repite, prueba otra red o permite antwork.io en tu bloqueador.
Publicar
"Pinterest necesita un tablero"
Cada pin va a un tablero, así que la cuenta de Pinterest necesita al menos uno. Crea uno con Crear Tablero en la barra lateral de Compose, pidiéndoselo a tu IA, o en Pinterest, y elígelo antes de programar. Si no eliges ninguno, Antwork usa el primer tablero de la cuenta.
Instagram, Pinterest, TikTok o YouTube no publican sin contenido multimedia
Estas plataformas necesitan multimedia: una imagen o un vídeo en Instagram y Pinterest, y un vídeo en TikTok y YouTube. Si tu IA no puede subir un archivo que adjuntaste en el chat, abre el mediaUrl del post: abre el post en el editor de Antwork con el selector de multimedia abierto, donde subes el archivo desde tu dispositivo y queda adjunto.
Para desarrolladores
"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 de cada publicación. 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 publish_post con la publicación fallida para reintentarla.
"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/polynode-co/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 fija la media de un post a partir de URLs de Firebase Storage de tu workspace. Para una URL externa usa add_media con url: guarda el archivo en el storage del workspace y lo adjunta. El publisher rechaza URLs que no sean de storage.
Rate limits
Antwork no mide las llamadas a herramientas. Lo que limita la publicación es el máximo diario de cada cuenta y su cola de publicaciones programadas (se rechazan con daily_cap_reached y schedule_queue_full; get_post_context indica el dailyPostCap de la cuenta), la separación mínima y la comprobación de duplicados en X y Threads (posting_too_close, duplicate_post), y los límites de las propias plataformas, que rechazan la petición en vez de encolarla, así que la publicación queda en failed con el motivo de la plataforma. Las cifras están en la página de límites.
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.
Cuentas sociales
Instagram o Facebook conectó la cuenta equivocada
Instagram y Facebook conectan la cuenta que tengas abierta en ese navegador. Abre el menú de la cuenta en Conexiones y elige Usar otra cuenta; la plataforma te pedirá iniciar sesión. Si vuelves a conectar en los 15 minutos siguientes a desconectar, pasa lo mismo automáticamente. Threads no permite cambiar así: cambia de cuenta en threads.net y vuelve a conectar.
"No se encontraron páginas de Facebook"
Antwork publica en Páginas de Facebook, no en perfiles personales, y tienes que ser administrador de la Página, no editor ni moderador. Revisa tu rol en la configuración de la Página. Si la Página pertenece a un portfolio de Meta Business, elige Reintentar con acceso empresarial para que Antwork pueda verla.
LinkedIn añadió mi perfil y la página de mi empresa
Un solo inicio de sesión en LinkedIn puede traer tu perfil personal y las páginas que gestionas, y cada una que conectes cuenta como una cuenta. Tus primeras 2 cuentas son gratis y el selector solo marca las que caben, así que desmarca lo que no quieras antes de confirmar. Puedes desconectar una cuenta desde Conexiones cuando quieras.
"YouTube no aceptó ese inicio de sesión" (u otra plataforma)
El inicio de sesión que devuelve la plataforma solo se puede usar una vez, así que se rechaza si caducó o ya se usó, por ejemplo al volver atrás o recargar. Vuelve a conectar desde Conexiones y completa las pantallas de la plataforma de una vez.