Postiz MCP

официальный

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

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

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

С помощью Postiz MCP вы можете попросить вашего ИИ-ассистента управлять постами в социальных сетях и создавать медиа напрямую.

Список подключенных аккаунтов — Запросите все подключенные аккаунты в социальных сетях через integrationList, при необходимости отфильтрованные по группе.
Получение правил платформы — Используйте integrationSchema, чтобы получить правила публикации и настройки для такой платформы, как X.
Планирование постов — Используйте schedulePostTool, чтобы запланировать, сохранить как черновик или опубликовать посты немедленно.
Список запланированных постов — Используйте postsListTool, чтобы просмотреть посты, запланированные между двумя датами.
Генерация изображений — Используйте generateImageTool, чтобы создавать изображения с помощью ИИ для постов.
Генерация видео — Используйте generateVideoTool, чтобы создавать видео, с опциями из generateVideoOptions.

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

Введение

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

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

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

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

Postiz предоставляет MCP-сервер с 11 инструментами для 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`	Генерация видео для постов

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

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

API-ключ

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

OAuth-токен

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

Подключение

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

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

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

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

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

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

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

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

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

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

FAQ

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

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

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

API-ключи Postiz не ротируются автоматически, но если вы перегенерируете ключ в Настройки → Разработчикам → 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.