Postiz MCP

oficial

Optimiza tus redes sociales con Postiz. Programa publicaciones, analiza el rendimiento y gestiona todas las cuentas en un solo lugar.

Ver en postiz.pro

¿Qué puedes hacer con Postiz MCP?

Listar cuentas sociales conectadas — Pídele al agente que recupere todas tus plataformas vinculadas con integrationList, opcionalmente filtradas por grupo de clientes.
Verificar reglas de publicación de la plataforma — Usa integrationSchema para obtener límites de caracteres, tipos de medios compatibles y configuraciones de una plataforma específica antes de publicar.
Programar o publicar publicaciones — Crea, redacta o publica inmediatamente publicaciones en redes sociales mediante schedulePostTool con formato específico de la plataforma.
Generar imágenes con IA para publicaciones — Produce imágenes directamente a través de generateImageTool para adjuntarlas al contenido programado.
Generar videos para publicaciones — Explora las opciones de video disponibles con generateVideoOptions y videoFunctionTool, luego crea videos usando generateVideoTool.

Documentación

Introducción

Conecta agentes de IA a Postiz usando el Protocolo de Contexto de Modelo (MCP)

MCP (Protocolo de Contexto de Modelo) permite que los agentes de IA interactúen directamente con Postiz — listar integraciones, programar publicaciones, generar imágenes y videos — todo a través de una interfaz estandarizada de invocación de herramientas.

Esto significa que puedes conectar Claude, ChatGPT, Cursor o cualquier cliente compatible con MCP a tu cuenta de Postiz y gestionar tus redes sociales mediante lenguaje natural.

Cómo funciona

Postiz expone un servidor MCP que proporciona 9 herramientas a los agentes de IA. El agente descubre estas herramientas, entiende sus esquemas y las invoca en tu nombre.

sequenceDiagram
    participant Agent as AI Agent
    participant MCP as Postiz MCP Server
    participant Postiz as Postiz Backend

    Agent->>MCP: Connect with API key / OAuth token
    MCP-->>Agent: List available tools
    Agent->>MCP: Call tool (e.g., schedule post)
    MCP->>Postiz: Execute action
    Postiz-->>MCP: Return result
    MCP-->>Agent: Tool response

Herramientas disponibles

Herramienta	Descripción
`integrationList`	Lista todas las cuentas de redes sociales conectadas (opcionalmente filtradas por grupo)
`groupList`	Lista todos los grupos (clientes) de tu organización
`integrationSchema`	Obtiene las reglas de publicación específicas de la plataforma y el esquema de configuración
`triggerTool`	Ejecuta ayudantes específicos de la plataforma (ej., listar canales de Discord)
`schedulePostTool`	Programa, crea borrador o publica inmediatamente publicaciones
`generateImageTool`	Genera imágenes de IA para publicaciones
`generateVideoOptions`	Lista las opciones disponibles de generación de video
`videoFunctionTool`	Obtiene la configuración del generador de video (ej., voces disponibles)
`generateVideoTool`	Genera videos para publicaciones

Autenticación

Hay dos formas de autenticarse con el servidor MCP:

Clave API

Obtén tu clave API desde Configuración > Desarrolladores > API pública en Postiz. Úsala directamente en la URL del endpoint MCP o como token Bearer.

Token OAuth

Si estás construyendo una aplicación para otros usuarios de Postiz, usa OAuth2 para obtener tokens. Los tokens OAuth comienzan con pos_ y funcionan igual que las claves API.

Conexión

Usa el endpoint `/mcp` con tu clave API o token OAuth como token Bearer:

```
URL: https://api.postiz.com/mcp
Authorization: Bearer your-api-key
```

Este método admite tanto claves API como tokens OAuth (con el prefijo `pos_`).

Usa el endpoint `/mcp/:apiKey` con tu clave API incrustada en la URL:

```
URL: https://api.postiz.com/mcp/your-api-key
```

Para instancias autoalojadas, reemplaza `https://api.postiz.com` con tu `NEXT_PUBLIC_BACKEND_URL`.

Ejemplo rápido

Así es como se ve una interacción típica cuando un agente de IA usa Postiz MCP:

El agente llama a integrationList — obtiene tus cuentas conectadas (X, LinkedIn, etc.)
El agente llama a integrationSchema con platform: "x" — aprende los límites de caracteres, configuraciones y reglas de X
El agente llama a schedulePostTool — programa tu publicación con el formato correcto

Todo esto sucede automáticamente cuando le dices a tu agente de IA algo como:

"¡Programa una publicación en X para mañana a las 10 a. m.: Emocionado de anunciar nuestra nueva función!"

Preguntas frecuentes

¿Necesito una clave de OpenAI para usar Postiz MCP?

No. El servidor MCP solo expone las herramientas de Postiz — tu cliente de IA (Claude, ChatGPT, Cursor, etc.) proporciona el modelo. Postiz solo necesita una OPENAI_API_KEY si usas las funciones de IA propias de Postiz (generación de imágenes, copiloto), que son independientes de las herramientas MCP expuestas a tu cliente.

¿Qué sucede cuando mi clave API expira o se rota?

Las claves API de Postiz no se rotan automáticamente, pero si regeneras una en Configuración → Desarrolladores → API pública, cada cliente MCP que use la clave antigua dejará de funcionar hasta que actualices su configuración. Actualiza la URL o el encabezado Authorization en la configuración de tu cliente y reconéctate.

Autoalojado: ¿cómo expongo el endpoint MCP?

El servidor MCP se inicia como parte del backend de Postiz y es accesible en /mcp (autenticación Bearer), /mcp/:apiKey (clave en la URL) y /mcp-oauth (protegido por OAuth). Tu proxy inverso debe reenviar estas rutas al backend y admitir HTTP en streaming (Transfer-Encoding: chunked). Consulta Proxies inversos.

¿Puede MCP leer o responder comentarios?

No por el momento. El conjunto actual de herramientas es de solo lectura en integraciones y de solo escritura en publicaciones/medios — no hay getComments ni replyToComment expuestos a través de MCP. Las respuestas a comentarios deben activarse a través de la interfaz de usuario de Postiz.