Postiz MCP

oficial

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

¿Qué puedes hacer con Postiz MCP?

  • Listar cuentas conectadas — Pide al agente que enumere tus cuentas de redes sociales conectadas, con la opción de filtrar por grupo.
  • Consultar las reglas de las plataformas — Obtén las reglas de publicación y el esquema de configuración específicos de cada plataforma antes de redactar una publicación.
  • Programar o publicar publicaciones — Programa una publicación, guárdala como borrador o publícala de inmediato en una cuenta conectada.
  • Revisar publicaciones programadas — Enumera las publicaciones de tu organización programadas entre dos fechas, junto con su configuración actual.
  • Generar contenido multimedia — Genera imágenes o videos con IA para las publicaciones y enumera las opciones disponibles de generación de video.
  • Recortar videos largos — Convierte un video largo de YouTube en clips verticales con subtítulos y borradores de publicaciones; luego, consulta el estado del recorte.

Documentación

Introducción

Conecta agentes de IA a Postiz mediante el Model Context Protocol (MCP)

MCP (Model Context Protocol) permite que los agentes de IA interactúen directamente con Postiz: pueden listar integraciones, programar publicaciones, generar imágenes y vídeos, y recortar vídeos largos para crear clips cortos, todo mediante una interfaz estandarizada de llamadas 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

HerramientaDescripción
integrationListLista todas las cuentas de redes sociales conectadas (opcionalmente, filtradas por grupo)
groupListLista todos los grupos (clientes) de tu organización
integrationConnectToolObtiene un enlace para conectar una nueva cuenta de redes sociales
integrationSchemaObtiene las reglas de publicación específicas de la plataforma y el esquema de configuración
triggerToolEjecuta funciones auxiliares específicas de la plataforma (p. ej., listar canales de Discord)
schedulePostToolPrograma, guarda como borrador o publica publicaciones de inmediato
postsListToolLista las publicaciones de la organización programadas entre dos fechas (con su configuración actual)
postSettingsToolActualiza la configuración del proveedor de una publicación programada o un borrador que aún no se haya publicado
generateImageToolGenera imágenes con IA para publicaciones
generateVideoOptionsLista las opciones disponibles para generar vídeos
videoFunctionToolObtiene la configuración del generador de vídeos (p. ej., las voces disponibles)
generateVideoToolGenera vídeos para publicaciones
clippingToolConvierte un vídeo largo de YouTube en clips verticales con subtítulos y crea borradores de publicaciones
clippingStatusToolComprueba el proceso de recorte y obtiene los clips terminados

Autenticación

Hay dos formas de autenticarse con el servidor MCP:

Clave de 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 empiezan por pos_ y funcionan igual que las claves de API.

Conexión

[tab] Token Bearer

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

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

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

[tab] Clave de API en la URL

Usa el endpoint /mcp/:apiKey con tu clave de API incluida en la URL:

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

Ejemplo rápido

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

  1. El agente llama a integrationList y obtiene tus cuentas conectadas (X, LinkedIn, etc.)
  2. El agente llama a integrationSchema con platform: "x" y descubre los límites de caracteres, la configuración y las reglas de X
  3. 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 en X para mañana a las 10:00: ¡Nos entusiasma 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 sus propias funciones de IA (generación de imágenes, copiloto), que son independientes de las herramientas MCP que se muestran en tu cliente.

¿Qué ocurre cuando mi clave de API caduca o se cambia?

Las claves de API de Postiz no se rotan automáticamente, pero si generas una nueva en Settings → Developers → Public API, 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.

Alojamiento propio: ¿cómo expongo el endpoint MCP?

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

¿MCP puede leer comentarios o responder a ellos?

Por ahora, no. El conjunto actual de herramientas solo permite leer integraciones y solo permite escribir publicaciones y contenido multimedia. MCP no expone ningún getComments ni replyToComment. Las respuestas a comentarios deben publicarse desde la interfaz de Postiz.

Esta documentación se crea y aloja en Mintlify, una plataforma de documentación para desarrolladores.