Agentes de IA (MCP)
PostClaw ofrece un servidor remoto de Model Context Protocol. Conecta un asistente de IA y pídele, con tus palabras, “escribe tres publicaciones para la próxima semana y prográmalas en mi página de Facebook”. El asistente revisa tus canales, redacta las publicaciones y las coloca en tu calendario, en tu nombre.
Disponible en todos los planes, incluido Free. Los límites de tu plan se aplican igual que en la app.
Qué necesitas
- Una cuenta de PostClaw con al menos un canal conectado.
- Un cliente MCP que pueda enviar una cabecera
Authorizationpor Streamable HTTP: Claude Code, Cursor, VS Code y la mayoría de los demás clientes MCP. - Un token de Configuración → Agentes de IA.
Claude.ai y ChatGPT en el navegador aún no son compatibles. Necesitan un inicio de sesión OAuth, que está previsto.
Conéctalo en dos minutos
- Abre Configuración → Agentes de IA y haz clic en Nuevo token.
- Dale un nombre que reconozcas (por ejemplo, “Cursor en mi portátil”) y elige sus permisos.
- Copia el token. Solo se muestra una vez. Si lo pierdes, revócalo y crea uno nuevo.
- Añade el servidor a tu cliente. La página de configuración muestra estos fragmentos con tu token ya incluido.
URL del servidor: https://app.postclaw.fun/mcp
Claude Code
claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"postclaw": {
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"postclaw": {
"type": "http",
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Después pregunta a tu asistente algo como “¿Qué canales tengo en PostClaw?” para comprobar la conexión.
Permisos
Cada token tiene sus propios permisos. El asistente solo ve las herramientas que su token permite.
| Permiso | Qué puede hacer el asistente |
|---|---|
| Leer (siempre activo) | Ver canales, publicaciones, medios y estadísticas, y recibir sugerencias de horarios |
| Escribir | Crear y editar borradores, subir medios, escribir publicaciones con IA, crear imágenes con IA |
| Publicar (desactivado por defecto) | Programar, publicar, desprogramar y eliminar publicaciones en tus cuentas reales |
Sin Publicar, un asistente solo puede dejar borradores para que los revises y apruebes en PostClaw. Actívalo solo para asistentes en los que confíes para publicar en tu nombre.
Puedes tener hasta 10 tokens activos. Revocar un token surte efecto en la siguiente solicitud del asistente.
Herramientas
| Herramienta | Permiso | Qué hace |
|---|---|---|
list_channels | Leer | Cuentas y páginas conectadas en las que puedes publicar |
list_posts, get_post | Leer | Borradores, publicaciones programadas y publicadas, con enlaces y errores |
get_analytics | Leer | Totales, desglose por plataforma, mejores horarios, publicaciones destacadas |
suggest_posting_times | Leer | Buenas franjas horarias por plataforma |
list_media | Leer | Medios subidos recientemente |
generate_post | Escribir | Texto de la publicación a partir de un briefing, opcionalmente con tu voz de marca |
adapt_post | Escribir | Un contenido reescrito para cada plataforma |
create_image | Escribir | Imágenes con IA para tus publicaciones |
upload_media, add_media_to_post | Escribir | Adjuntar tus propias imágenes y vídeos |
create_post, update_post | Escribir | Crear y editar borradores; indicar una hora programa la publicación (requiere Publicar) |
publish_post | Publicar | Publicar ahora y devolver el enlace de cada plataforma |
unschedule_post | Publicar | Devolver una publicación programada a borrador |
delete_post | Publicar | Eliminar una publicación de PostClaw |
Los medios deben ser una URL https:// o un archivo enviado con upload_media.
create_post y publish_post aceptan un idempotency_key opcional. Si el asistente repite una llamada con la misma clave en 24 horas, PostClaw devuelve el primer resultado en lugar de crear o publicar dos veces.
Límites y créditos
Un asistente trabaja con el mismo plan que tú en la app:
- Las publicaciones al mes, los créditos de IA y la cuota de imágenes cuentan igual en PostClaw que a través de un asistente.
- Las herramientas de IA usan tu propia clave de IA si has conectado una en la configuración.
- Cada token puede hacer hasta 60 solicitudes por minuto.
- Cada llamada queda registrada en tu cuenta.
Solución de problemas
| Qué ves | Por qué | Qué hacer |
|---|---|---|
401 / “invalid token” | El token es incorrecto o fue revocado | Crea un token nuevo y actualiza tu cliente |
429 | Más de 60 solicitudes por minuto desde un token | Espera unos segundos; la respuesta indica cuánto |
| Falta una herramienta | El token no tiene el permiso necesario | Crea un token con ese permiso |
scope_missing | Programar o publicar sin el permiso Publicar | Activa Publicar en un token nuevo o programa desde la app |
quota_exceeded, credit_cap_exceeded | Se agotó el límite mensual de tu plan | Espera al siguiente periodo o mejora tu plan |
| ”your … configuration failed” | Tu propia clave de IA devolvió un error (cuota, facturación, sesión caducada) | Corrige o elimina la clave en Configuración → Providers |
Mantén tus tokens seguros
Un token actúa como tú. Trátalo como una contraseña:
- No lo subas a un repositorio ni lo pegues en chats compartidos.
- Usa un token por dispositivo o herramienta, para poder revocar uno sin afectar a los demás.
- Revoca los tokens que ya no uses en Configuración → Agentes de IA.