Saltar al contenido

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 Authorization por 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

  1. Abre Configuración → Agentes de IA y haz clic en Nuevo token.
  2. Dale un nombre que reconozcas (por ejemplo, “Cursor en mi portátil”) y elige sus permisos.
  3. Copia el token. Solo se muestra una vez. Si lo pierdes, revócalo y crea uno nuevo.
  4. 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.

PermisoQué puede hacer el asistente
Leer (siempre activo)Ver canales, publicaciones, medios y estadísticas, y recibir sugerencias de horarios
EscribirCrear 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

HerramientaPermisoQué hace
list_channelsLeerCuentas y páginas conectadas en las que puedes publicar
list_posts, get_postLeerBorradores, publicaciones programadas y publicadas, con enlaces y errores
get_analyticsLeerTotales, desglose por plataforma, mejores horarios, publicaciones destacadas
suggest_posting_timesLeerBuenas franjas horarias por plataforma
list_mediaLeerMedios subidos recientemente
generate_postEscribirTexto de la publicación a partir de un briefing, opcionalmente con tu voz de marca
adapt_postEscribirUn contenido reescrito para cada plataforma
create_imageEscribirImágenes con IA para tus publicaciones
upload_media, add_media_to_postEscribirAdjuntar tus propias imágenes y vídeos
create_post, update_postEscribirCrear y editar borradores; indicar una hora programa la publicación (requiere Publicar)
publish_postPublicarPublicar ahora y devolver el enlace de cada plataforma
unschedule_postPublicarDevolver una publicación programada a borrador
delete_postPublicarEliminar 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é vesPor quéQué hacer
401 / “invalid token”El token es incorrecto o fue revocadoCrea un token nuevo y actualiza tu cliente
429Más de 60 solicitudes por minuto desde un tokenEspera unos segundos; la respuesta indica cuánto
Falta una herramientaEl token no tiene el permiso necesarioCrea un token con ese permiso
scope_missingProgramar o publicar sin el permiso PublicarActiva Publicar en un token nuevo o programa desde la app
quota_exceeded, credit_cap_exceededSe agotó el límite mensual de tu planEspera 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.