Postiz → Claude CLI: гайд подключения

walkthrough · три пути · май 2026 · domain social-posting

Как подключить Postiz к Claude Code (CLI claude), чтобы агент постил твой контент в соцсети. Есть три пути — все без написания прикладного кода. Факты сверены по официальной docs.postiz.com.

# Путь A — официальный skill (рекомендуется)
npm i -g postiz && postiz auth:login && npx skills add gitroomhq/postiz-agent

# Путь B — MCP-сервер
claude mcp add postiz --transport http https://api.postiz.com/mcp/ТВОЙ_API_KEY

1. Предпосылки

• Claude Code установлен — проверь claude --version.
• Аккаунт Postiz — Cloud (managed, ничего не разворачивать; принимает крипто-оплату → доступен из РФ) либо self-host (Docker, свой IP). Для агента два режима отличаются только URL.
• API-ключ — Settings → Developers → Public API. Там же лежит готовый MCP-URL.
• Каналы подключены — VK/Telegram привязываются один раз в UI Postiz (Add Channel); токены хранятся в Postiz, агент с ними не работает напрямую.

2. Какой путь выбрать

3. Путь A — Claude Code skill (рекомендуется)

Официальный способ Postiz «подружить агента с собой»: skill — это SKILL.md из репо gitroomhq/postiz-agent, который учит Claude паттернам работы через Postiz CLI.

1. Поставить Postiz CLI

   npm install -g postiz
   postiz --help          # проверка

2. Авторизоваться (OAuth2 device flow — код в терминале + браузер)

   postiz auth:login      # креды → ~/.postiz/credentials.json
   postiz auth:status     # проверить, что токен жив

   Альтернатива: export POSTIZ_API_KEY=… в ~/.zshrc. OAuth приоритетнее ключа, если заданы оба.

3. Установить skill в Claude Code

   npx skills add gitroomhq/postiz-agent

4. Проверить — в сессии claude скажи: «покажи мои подключённые каналы». Агент вызовет integrations:list и вернёт список.

После этого агент умеет: список каналов, правила площадки, постинг с медиа, управление постами (draft/schedule/delete) и аналитика (analytics:platform, analytics:post). Все команды CLI отдают JSON — удобно агенту.

4. Путь B — MCP-сервер

1. Добавить сервер (ключ в URL = авторизация)

   claude mcp add postiz --transport http https://api.postiz.com/mcp/ТВОЙ_API_KEY

   Self-host: замени api.postiz.com на свой NEXT_PUBLIC_BACKEND_URL.

2. Или — ключ в заголовке (не светится в конфиге так явно; эндпоинт /mcp без ключа)

   claude mcp add postiz --transport http https://api.postiz.com/mcp \
     --header "Authorization: Bearer ТВОЙ_API_KEY"

3. Выбрать scope (по умолчанию local — этот проект, только ты). Для постинга удобнее глобально:

   claude mcp add postiz --scope user --transport http https://api.postiz.com/mcp/ТВОЙ_API_KEY

   --scope project пишет в .mcp.json в корне репо (попадёт в git — ключ утечёт, не используй для секрета).

4. Проверить

   claude mcp list           # postiz в списке
   claude mcp get postiz     # детали (URL, transport)

   В сессии claude — команда /mcp: статус подключения, число tools, OAuth-кнопка если нужна. Тест-фраза: «List my connected social media accounts» → вызовет integrationList.

Транспорт: --transport http = Streamable HTTP (это и нужно Postiz). --transport sse устарел — не использовать.

5. Путь C — Postiz CLI напрямую

Это Путь A без skill-обёртки: ставишь CLI, авторизуешься, а Claude вызывает команды через Bash. Рабочий вариант для точечных операций, но без SKILL.md агент не знает паттернов.

npm i -g postiz && postiz auth:login

# дальше Claude (или ты) шеллит:
postiz integrations:list
postiz posts:create -c "<p>Привет из Postiz CLI</p>" -s "2026-05-29T10:00:00Z" -i "ID_КАНАЛА"
postiz posts:list
postiz analytics:post --id "ID_ПОСТА"

Команды: auth:*, integrations:list/settings/trigger, posts:create/list/delete/missing/connect, analytics:platform/post, upload. Вывод — JSON.

6. Восемь MCP-tools и рабочий цикл

MCP отдаёт агенту ровно 8 tools. Типичный цикл постинга: integrationList → integrationSchema(platform) → schedulePostTool.

7. Формат контента

Поле content — HTML со строгим белым списком тегов. Каждая строка обёрнута в <p>.

Параметры schedulePostTool (на пост): integrationId, isPremium, date (UTC), shortLink, type (draft/schedule/now), postsAndComments, settings. На thread-площадках (X/Threads/Bluesky) каждый элемент postsAndComments — пост в треде; на comment-площадках (LinkedIn/Facebook) первый — пост, остальные — комментарии.

{
  "socialPost": [{
    "integrationId": "<id из integrationList>",
    "isPremium": false,
    "date": "2026-05-29T10:00:00.000Z",
    "shortLink": false,
    "type": "schedule",
    "postsAndComments": [
      { "content": "<p>Текст поста</p>", "attachments": [] }
    ],
    "settings": []
  }]
}

Это видно «под капотом» — сам ты JSON не пишешь, агент формирует его из твоей фразы на русском.

8. Подводные камни