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:
- Агент вызывает
integrationListи получает список подключённых аккаунтов (X, LinkedIn и т. д.) - Агент вызывает
integrationSchemaсplatform: "x"и узнаёт ограничения на количество символов, настройки и правила для X - Агент вызывает
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, платформе для документации разработчиков.