Postiz MCP

официальный

Оптимизируйте управление социальными сетями с Postiz. Планируйте публикации, анализируйте эффективность и управляйте всеми аккаунтами в одном месте

Смотреть на postiz.proПопробовать этот MCPСпонсировано

Что можно делать с Postiz MCP?

List connected accounts — Попросите ассистента показать все связанные профили в социальных сетях с помощью integrationList, при необходимости отфильтрованные по группе.
Schedule or publish posts — Поручите ассистенту создавать черновики, планировать или немедленно публиковать контент через schedulePostTool.
Generate AI images — Запросите изображения, созданные ИИ, для ваших постов напрямую через generateImageTool.
Create video clips — Превратите длинное видео с YouTube в вертикальные шортсы с субтитрами и создайте черновики постов с помощью clippingTool.
Check platform rules — Уточните лимиты публикаций и настройки для конкретной платформы через integrationSchema перед планированием.

Документация

Введение

Подключайте AI-агентов к Postiz с помощью Model Context Protocol (MCP)

MCP (Model Context Protocol) позволяет AI-агентам взаимодействовать с Postiz напрямую: просматривать интеграции, планировать публикации, генерировать изображения и видео, нарезать длинные видео на короткие — всё через стандартизированный интерфейс вызова инструментов.

Это значит, что вы можете подключить Claude, ChatGPT, Cursor или любого MCP-совместимого клиента к своему аккаунту Postiz и управлять своими соцсетями через естественный язык.

Как это работает

Postiz предоставляет MCP-сервер с 13 инструментами для AI-агентов. Агент обнаруживает эти инструменты, понимает их схемы и вызывает их от вашего имени.

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

Доступные инструменты

Инструмент	Описание
`integrationList`	Список всех подключённых аккаунтов соцсетей (опционально с фильтром по группе)
`groupList`	Список всех групп (клиентов) вашей организации
`integrationSchema`	Получение правил публикации и схемы настроек для конкретной платформы
`triggerTool`	Выполнение вспомогательных функций платформы (например, список каналов Discord)
`schedulePostTool`	Планирование, сохранение черновика или мгновенная публикация постов
`postsListTool`	Список постов организации, запланированных между двумя датами (с их текущими настройками)
`postSettingsTool`	Обновление настроек провайдера для запланированного поста или черновика, который ещё не опубликован
`generateImageTool`	Генерация AI-изображений для постов
`generateVideoOptions`	Список доступных опций генерации видео
`videoFunctionTool`	Получение настроек генератора видео (например, доступные голоса)
`generateVideoTool`	Генерация видео для постов
`clippingTool`	Превращение длинного YouTube-видео в вертикальные клипы с субтитрами и создание черновиков постов
`clippingStatusTool`	Проверка нарезки и получение готовых клипов

Аутентификация

Есть два способа аутентификации на MCP-сервере:

API-ключ

Используйте его напрямую в URL конечной точки MCP или как Bearer-токен.

OAuth-токен

Если вы создаёте приложение для других пользователей Postiz, используйте OAuth2 для получения токенов. OAuth-токены начинаются с pos_ и работают так же, как API-ключи.

Подключение

Используйте конечную точку `/mcp` с вашим API-ключом или OAuth-токеном в качестве Bearer-токена:

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

Этот метод поддерживает как API-ключи, так и OAuth-токены (с префиксом `pos_`).

Используйте конечную точку `/mcp/:apiKey` с вашим API-ключом, встроенным в URL:

```text theme={null}
URL: https://mcp.postiz.com/mcp/your-api-key
```

Быстрый пример

Вот как выглядит типичное взаимодействие, когда AI-агент использует Postiz MCP:

Агент вызывает integrationList и получает ваши подключённые аккаунты (X, LinkedIn и т. д.)
Агент вызывает integrationSchema с platform: "x" и узнаёт лимиты символов, настройки и правила X
Агент вызывает schedulePostTool и планирует ваш пост в правильном формате

Всё это происходит автоматически, когда вы говорите своему AI-агенту что-то вроде:

«Запланируй пост в X на завтра на 10 утра: Рады объявить о нашей новой функции!»

FAQ

Нужен ли мне ключ OpenAI для использования Postiz MCP?

Нет. MCP-сервер просто предоставляет инструменты Postiz. Модель обеспечивает ваш AI-клиент (Claude, ChatGPT, Cursor и т. д.). Postiz требует OPENAI_API_KEY только если вы используете собственные AI-функции Postiz (генерация изображений, копilot), которые отделены от MCP-инструментов, доступных вашему клиенту.

Что произойдёт, если мой API-ключ истечёт или будет перевыпущен?

API-ключи Postiz не ротируются автоматически, но если вы перегенерируете ключ в Настройки → Разработчикам → Public API, все MCP-клиенты, использующие старый ключ, перестанут работать, пока вы не обновите их конфигурацию. Обновите URL или заголовок Authorization в конфигурации клиента и переподключитесь.

Self-hosted: как открыть конечную точку MCP?

MCP-сервер запускается как часть бэкенда Postiz и доступен по адресам /mcp (Bearer-аутентификация), /mcp/:apiKey (ключ в URL) и /mcp-oauth (защищено OAuth). Ваш обратный прокси должен перенаправлять эти пути на бэкенд и поддерживать потоковый HTTP (Transfer-Encoding: chunked). См. Обратные прокси.

Может ли MCP читать или отвечать на комментарии?

Пока нет. Текущий набор инструментов доступен только для чтения интеграций и только для записи постов/медиа. Через MCP не предоставляются getComments или replyToComment. Ответы на комментарии должны запускаться через интерфейс Postiz.

Эта документация создана и размещена на Mintlify, платформе документации для разработчиков.