Servidor MCP de Antwork
Documentación de referencia del servidor Model Context Protocol de Antwork — instalación, scopes OAuth, catálogo completo de tools, enlaces a la web y solución de problemas.
https://api.antwork.io/mcpResumen
El servidor MCP de Antwork permite que tu asistente de IA cree borradores, programe, publique y analice posts en redes sociales en tu nombre. Habla el estándar abierto Model Context Protocol, así que cualquier cliente compatible con MCP (claude.ai, Claude Code, Cursor, ChatGPT, Windsurf, agentes propios) puede conectarse con la misma URL única.
Qué puedes hacer una vez conectado
- Crear borradores on-brand con la voz que se deduce del historial de cada cuenta.
- Programar o publicar en LinkedIn, X, Threads, Facebook, Instagram, YouTube, TikTok, Pinterest, Bluesky y Telegram.
- Leer las métricas acumuladas de cualquier post publicado y su historial de engagement día a día.
- Gestionar borradores, posts programados y la biblioteca de medios.
- Conectar cuentas sociales y revisar su estado (desconectar se hace en la web).
https://api.antwork.io/mcpUna sola URL sirve a todos los usuarios — no hay subdominios por tenant. La autenticación se hace vía OAuth en la primera llamada a una tool (ver Autenticación).
Inicio rápido
Cada cliente MCP soportado sigue el mismo patrón: registra la URL del servidor y aprueba OAuth en tu navegador cuando se te pida. La forma exacta de instalar varía según el cliente.
Elige tu cliente para ver la configuración paso a paso:
- Claude
- ChatGPT
- Claude Code
- Codex
- OpenClaw
- Hermes Agent
- Grok
- Meta Muse
- Claude Duet
- Grok Bot
- OpenAI dots
- n8n
- Make
- Cursor
- VS Code
- Gemini CLI
- Antigravity
- Perplexity
- Mistral Vibe
- Gemini
ChatGPT no necesita URL del servidor: abre Antwork en el directorio de plugins de ChatGPT y pulsa Connect.
¿Usas un agente de código que no aparece? Deja que se configure solo.
Para agentes que pueden editar su propia configuración, como Claude Code, Codex o Cursor: copia este prompt en el agente. Instala https://api.antwork.io/mcp, te guía en el inicio de sesión y comprueba la conexión antes de confirmarla. ChatGPT y Claude no pueden configurarse así. Elígelos arriba.
Conectar desde scripts, CI y el Agent SDK
El inicio de sesión normal abre un navegador para la pantalla de consentimiento. Los clientes que funcionan sin interfaz (Claude Code ejecutado desde el Agent SDK, un trabajo de CI, codex exec) no tienen navegador, así que se autentican con una clave de API de Antwork, enviada como token bearer. Las mismas herramientas y los mismos permisos.
Crea una clave con los permisos que necesites y expórtala como ANTWORK_API_KEY. Solo se muestra una vez. Crear una clave de API
Claude Code
claude mcp add --transport http antwork https://api.antwork.io/mcp \
--header "Authorization: Bearer $ANTWORK_API_KEY"Codex
Codex lee el token de la variable de entorno indicada en bearer_token_env_var, así que la clave nunca queda en el archivo.
[mcp_servers.antwork]
url = "https://api.antwork.io/mcp"
bearer_token_env_var = "ANTWORK_API_KEY"Claude Agent SDK
mcpServers: {
antwork: {
type: "http",
url: "https://api.antwork.io/mcp",
headers: { Authorization: `Bearer ${process.env.ANTWORK_API_KEY}` },
},
},
allowedTools: ["mcp__antwork__*"],mcp_servers={
"antwork": {
"type": "http",
"url": "https://api.antwork.io/mcp",
"headers": {"Authorization": f"Bearer {os.environ['ANTWORK_API_KEY']}"},
}
},
allowed_tools=["mcp__antwork__*"],read, write, publish, media), y cada herramienta los comprueba igual que con un token OAuth. Si revocas la clave o se desactiva la cuenta, el acceso se corta en menos de un minuto. Guárdala en un gestor de secretos, nunca en un repositorio.Enlaces a Antwork
Antwork no dibuja nada dentro del chat. Las tools responden en texto, y cada post que devuelven lleva tres enlaces al editor web de Antwork, así que cualquier cliente puede abrirlo:
editUrlabre el post en el editor.mediaUrllo abre con el selector de multimedia abierto, para subir un archivo desde tu dispositivo o elegir uno de tu biblioteca.settingsUrllo abre con los ajustes de la plataforma abiertos, como la audiencia de TikTok o el tablero de Pinterest.
list_media devuelve libraryUrl, la página Medios, y list_posts con group_by_day devuelve calendarUrl, la página Calendario. Sin sesión iniciada, el enlace te pide entrar primero y luego abre la página a la que apunta.
Adjuntar imágenes y vídeos
Cómo llega un archivo a Antwork depende de dónde chateas. Todas las vías acaban en la biblioteca de medios de tu espacio, y una sola llamada a add_media puede adjuntar el archivo a todos los posts que indiques.
- En el editor: abre el
mediaUrldel post, que tu IA recibe con cada post. Abre el post en el editor de Antwork con el selector de multimedia abierto, para subir un archivo desde tu dispositivo o elegirlo de tu biblioteca. Funciona en cualquier cliente, también en Claude web, escritorio y móvil. - Claude con ejecución de código: adjunta el archivo al chat y pide a Claude que lo añada a tus posts. Claude lo sube desde su entorno aislado en una sola petición, que necesita acceso de red a
api.antwork.io. En claude.ai, añade ese dominio en Settings → Capabilities. - ChatGPT: adjunta el archivo al chat y pide que lo añada. ChatGPT entrega el archivo a Antwork directamente.
- Claude Code, Codex y otros clientes de terminal: indica el archivo en disco. El cliente lo sube directamente en una sola petición, hasta 1 GB para vídeo y PDF.
- Desde cualquier sitio: súbelo en la página Medios de antwork.io y pide a tu IA que lo adjunte desde tu biblioteca.
api.antwork.io es la API de Antwork, así que permitirlo no abre nada más al entorno. Cada dirección de subida sirve una vez, para un archivo, durante 10 minutos, y su respuesta dice a qué posts se adjuntó el archivo. Si prefieres no permitirlo, el mediaUrl del post abre el editor, donde añades el archivo tú.Límites y cuotas
Los techos propios de Antwork (la cuota de cuentas conectadas, los límites diarios y de cola por cuenta, los tamaños de subida y qué significa cada estado) están en la página de límites. Lo que acepta cada red está en las especificaciones por plataforma.
El único límite propio de esta superficie: un token de acceso dura 5 minutos y uno de refresco 30 días, se renueva al usarlo y se puede revocar en cualquier momento con /oauth/revoke.
¿Algo no cuadra? Dinos cuál.