Postiz MCP

официальный

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

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

  • Список подключённых аккаунтов — Попросите агента перечислить подключённые аккаунты в социальных сетях, при необходимости отфильтровав их по группе.
  • Проверка правил платформы — Получите правила публикации и схему настроек для конкретной платформы перед подготовкой публикации.
  • Планирование или публикация постов — Запланируйте публикацию, сохраните её как черновик или сразу опубликуйте в подключённом аккаунте.
  • Проверка запланированных публикаций — Просмотрите публикации вашей организации, запланированные на период между двумя датами, и их текущие настройки.
  • Создание медиа — Создавайте изображения или видео с помощью ИИ для публикаций и просматривайте доступные варианты генерации видео.
  • Нарезка длинных видео — Превратите длинное видео на YouTube в вертикальные клипы с субтитрами и черновики публикаций, а затем проверьте статус нарезки.

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

Введение

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

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

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

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

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

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Список всех групп (клиентов) вашей организации
integrationConnectToolПолучить ссылку для подключения нового аккаунта социальной сети
integrationSchemaПолучить правила публикации и схему настроек для конкретной платформы
triggerToolВыполнить вспомогательные действия для конкретной платформы (например, получить список каналов Discord)
schedulePostToolЗапланировать публикацию, сохранить её как черновик или опубликовать немедленно
postsListToolСписок публикаций организации, запланированных на период между двумя датами (с их текущими настройками)
postSettingsToolИзменить настройки провайдера запланированной публикации или черновика, который ещё не был опубликован
generateImageToolСоздать изображения с помощью ИИ для публикаций
generateVideoOptionsСписок доступных вариантов генерации видео
videoFunctionToolПолучить настройки генератора видео (например, список доступных голосов)
generateVideoToolСоздать видео для публикаций
clippingToolПревратить длинное видео с YouTube в вертикальные ролики с субтитрами и черновики публикаций
clippingStatusToolПроверить процесс нарезки и получить готовые ролики

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

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

Ключ API

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

Токен OAuth

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

Подключение

[tab] Bearer-токен

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

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

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

[tab] Ключ API в URL

Используйте конечную точку /mcp/:apiKey, указав ключ API в URL:

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

Краткий пример

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

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

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

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

Часто задаваемые вопросы

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

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

Что произойдёт, если срок действия моего ключа API истечёт или я заменю его?

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

Самостоятельный хостинг: как открыть доступ к конечной точке MCP?

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

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

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

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