posty-mcp — Posty.fun desde Claude

Servidor MCP que conecta Posty.fun con Claude (Desktop, Code, o cualquier cliente MCP). Te deja crear flujos, generar contenido, listar y aprobar publicaciones, y ver métricas — todo por chat.

Conexión rápida

1. Genera un token en Posty: Ajustes → Conexión con Claude (MCP) → Generar token. Se muestra una sola vez; cópialo.

2. Agrega el server a la configuración MCP de tu cliente:

   Claude Desktop → Settings → Developer → Edit Config Claude Code → ~/.claude.json (o .mcp.json del proyecto)

   {
     "mcpServers": {
       "posty": {
         "command": "npx",
         "args": ["-y", "posty-mcp"],
         "env": {
           "POSTY_URL": "https://posty.fun",
           "POSTY_TOKEN": "posty_tu_token_acá"
         }
       }
     }
   }

3. Reinicia el cliente. Luego pídele a Claude: "lista mis proyectos en Posty".

El transporte es stdio: el proceso se ejecuta en la máquina del usuario y llama a la API HTTPS de Posty. Este paquete no expone un endpoint MCP remoto ni implementa un servidor OAuth.

Variables de entorno

| Variable | Obligatoria | Default | Qué es | |---|---|---|---| | POSTY_TOKEN | sí | — | Token posty_... generado en Ajustes | | POSTY_URL | no | https://posty.fun | Útil para apuntar a una instancia propia |

La fuente local de este proyecto es [email protected]. Publicar una versión nueva en npm requiere una sesión npm autorizada; hasta entonces, npx puede resolver la versión pública anterior.

Tools

| Tool | Qué hace | |---|---| | list_brands | Proyectos de la cuenta (id, nombre, redes conectadas) | | list_workflows | Workflows con su proyecto, programación y configuración visual | | list_posts | Publicaciones, filtrables por estado y proyecto | | get_metrics | Métricas de la página conectada de un proyecto | | run_workflow | Corre un workflow ahora (genera la cantidad configurada; sin redes → queda borrador) | | generate_posts | Genera N piezas con tipo de contenido, densidad y dirección visual opcionales | | create_ai_workflow | Crea un workflow de IA completa con la configuración visual elegida | | update_workflow_visual | Actualiza solamente formato, densidad, tipo y dirección visual de un workflow | | upload_workflow_visual_asset | Sube una captura real o un producto sin fondo como capa bloqueada | | configure_workflow_person_reference | Vincula 1-3 fotos autorizadas de una persona y elige realista o ilustrado | | clear_workflow_person_reference | Elimina las fotos de identidad de un workflow para futuras piezas | | generate_carousel | Genera un carrusel real de 3-8 slides con brand kit y fondo generativo sin costo de IA de imagen | | create_carousel_workflow | Crea un workflow periódico de carruseles y, opcionalmente, lo ejecuta en el momento | | approve_post | Aprobar · programar en la cola · publicar ya · rechazar un borrador |

Seguridad

• El token autoriza como tu usuario y solo accede a TUS datos (aislamiento por cuenta).
• Se guarda hasheado en el server; revocalo cuando quieras desde Ajustes.
• No genera tokens nuevos vía MCP; eso solo se hace desde la app web.

Requiere Node 18+.

Contenido visual con IA

• contentType permite elegir una estructura: minimal_statement, formatos educativos, producto, o meme_reaccion, meme_situacion, humor_absurdo y humor_observacional.
• contentTypes acepta un pool de hasta 8 estructuras y el workflow las rota entre publicaciones.
• sourceMode separa la fuente visual: conceptual, service, real_capture o physical_product.
• En real_capture y physical_product, primero crea el workflow y usa upload_workflow_visual_asset. Posty compone el archivo original como capa bloqueada: nunca se envía a la IA para redibujarlo.
• textDensity: "minimal" usa titular + bajada breve y rota seis layouts seguros. Si contentDirection pide explícitamente una sola frase o sin bajada, el render usa un único bloque de texto.
• contentDirection coordina el ritmo sin volverlo obligatorio: por ejemplo, “alterna texto arriba y abajo; algunas piezas con una sola frase”. artDirection controla escena, luz y estética.

Persona de referencia

Un agente puede configurar la identidad visual de un influencer sin usar el editor: llama a configure_workflow_person_reference con el workflow, entre una y tres rutas locales de fotos claras de la misma persona, el estilo (realistic o illustrated) y confirmAuthorization: true. Las fotos se guardan en el workflow y se adjuntan a los generadores compatibles como identidad a conservar; no se usan como una referencia estética. Después, el agente puede escribir la escena en artDirection y ejecutar el workflow normalmente. Para eliminar la identidad de futuras piezas usa clear_workflow_person_reference.