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.proPrueba este MCPPatrocinado

¿Qué puedes hacer con Postiz MCP?

Con Postiz MCP, puedes pedirle a tu asistente de IA que gestione publicaciones en redes sociales y genere medios directamente.

Listar cuentas conectadas — Pide todas las cuentas de redes sociales conectadas mediante integrationList, opcionalmente filtradas por grupo.
Obtener reglas de plataforma — Usa integrationSchema para obtener las reglas y configuraciones de publicación para una plataforma como X.
Programar publicaciones — Usa schedulePostTool para programar, redactar o publicar publicaciones de inmediato.
Listar publicaciones programadas — Usa postsListTool para ver publicaciones programadas entre dos fechas.
Generar imágenes — Usa generateImageTool para crear imágenes de IA para publicaciones.
Generar videos — Usa generateVideoTool para producir videos, con opciones de generateVideoOptions.

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, listando integraciones, programando publicaciones, generando imágenes y videos, todo a través de una interfaz estandarizada de llamada a 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 11 herramientas a los agentes de IA. El agente descubre estas herramientas, comprende 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`	Obtén las reglas de publicación y el esquema de configuración específicos de la plataforma
`triggerTool`	Ejecuta asistentes específicos de la plataforma (p. ej., listar canales de Discord)
`schedulePostTool`	Programa, redacta o publica publicaciones de inmediato
`postsListTool`	Lista las publicaciones de la organización programadas entre dos fechas (con su configuración actual)
`postSettingsTool`	Actualiza la configuración del proveedor de una publicación programada o un borrador que aún no se ha publicado
`generateImageTool`	Genera imágenes con IA para publicaciones
`generateVideoOptions`	Lista las opciones disponibles de generación de videos
`videoFunctionTool`	Obtén la configuración del generador de videos (p. ej., voces disponibles)
`generateVideoTool`	Genera videos para publicaciones

Autenticación

Hay dos formas de autenticarse con el servidor MCP:

Clave API

Úsala directamente en la URL del endpoint MCP, o como token Bearer.

Token OAuth

Si estás creando 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 prefijo `pos_`).

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

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

Ejemplo Rápido

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

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

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

"Programa una publicación para X mañana a las 10 a. m.: ¡Emocionados 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 un 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 caduca o se rota?

Las claves API de Postiz no se rotan automáticamente, pero si regeneras una en Configuración → Desarrolladores → API pública, todos los clientes MCP que usen la clave anterior dejarán de funcionar hasta que actualices su configuración. Actualiza la URL o el encabezado Authorization en la configuración de tu cliente y vuelve a conectarte.

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 de streaming (Transfer-Encoding: chunked). Consulta Proxies Inversos.

¿Puede MCP leer o responder comentarios?

Hoy no. El conjunto de herramientas actual 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 Postiz.