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?

List connected accounts — Pídele a tu asistente que muestre todos los perfiles de redes sociales vinculados usando integrationList, opcionalmente filtrados por grupo.
Schedule or publish posts — Indica a tu asistente que cree borradores, programe o publique contenido de inmediato mediante schedulePostTool.
Generate AI images — Solicita imágenes generadas por IA para tus publicaciones directamente a través de generateImageTool.
Create video clips — Convierte un video largo de YouTube en clips verticales cortos con subtítulos y redacta publicaciones usando clippingTool.
Check platform rules — Consulta los límites de publicación y la configuración de una plataforma específica mediante integrationSchema antes de programar.

Documentación

Introducción

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

MCP (Protocolo de Contexto de Modelos) permite que los agentes de IA interactúen directamente con Postiz, listando integraciones, programando publicaciones, generando imágenes y videos, recortando videos largos en cortos, 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 13 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 reglas de publicación específicas de la plataforma y el esquema de configuración
`triggerTool`	Ejecuta asistentes específicos de la plataforma (por ejemplo, listar canales de Discord)
`schedulePostTool`	Programa, guarda como borrador o publica inmediatamente publicaciones
`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 borrador que aún no se haya 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 (por ejemplo, voces disponibles)
`generateVideoTool`	Genera videos para publicaciones
`clippingTool`	Convierte un video largo de YouTube en clips verticales con subtítulos y crea borradores de publicaciones
`clippingStatusTool`	Verifica un recorte y obtén los clips finalizados

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:

```text theme={null}
URL: https://mcp.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:

```text theme={null}
URL: https://mcp.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 obtiene tus cuentas conectadas (X, LinkedIn, etc.)
El agente llama a integrationSchema con platform: "x" y aprende los límites de caracteres, configuraciones y 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 10am: ¡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 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, 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 transmisión (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.

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.