Postiz MCP

официальный

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

Смотреть на postiz.pro

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

List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using generateVideoTool.

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

Введение

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

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

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

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

Postiz предоставляет MCP-сервер с 9 инструментами для 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`	Планирование, создание черновика или немедленная публикация постов
`generateImageTool`	Генерация AI-изображений для постов
`generateVideoOptions`	Список доступных опций генерации видео
`videoFunctionTool`	Получение настроек генератора видео (например, доступные голоса)
`generateVideoTool`	Генерация видео для постов

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

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

API-ключ

Получите API-ключ в разделе Настройки > Разработчики > Публичное API в Postiz. Используйте его непосредственно в 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
```

Для самостоятельно развернутых экземпляров замените `https://api.postiz.com` на ваш `NEXT_PUBLIC_BACKEND_URL`.

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

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

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

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

"Запланируй публикацию в X на завтра на 10 утра: Рады анонсировать нашу новую функцию!"

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

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

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

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

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

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

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

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

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