Перейти к содержимому

ИИ-агенты (MCP)

PostClaw предоставляет удалённый сервер Model Context Protocol. Подключите к нему ИИ-ассистента и просто попросите: «напиши три поста на следующую неделю и запланируй их на моей странице Facebook». Ассистент проверит каналы, подготовит черновики и поставит их в календарь от вашего имени.

Доступно на всех тарифах, включая Free. Лимиты тарифа действуют так же, как в приложении.


Что понадобится

  • Аккаунт PostClaw хотя бы с одним подключённым каналом.
  • MCP-клиент, который умеет отправлять заголовок Authorization по Streamable HTTP: Claude Code, Cursor, VS Code и большинство других MCP-клиентов.
  • Токен из раздела Настройки → ИИ-агенты.

Claude.ai и ChatGPT в браузере пока не поддерживаются: им нужен вход через OAuth, он запланирован.


Подключение за две минуты

  1. Откройте Настройки → ИИ-агенты и нажмите Новый токен.
  2. Дайте токену понятное имя (например, «Cursor на ноутбуке») и выберите права.
  3. Скопируйте токен. Он показывается только один раз. Если вы его потеряли, отзовите его и создайте новый.
  4. Добавьте сервер в клиент. На странице настроек эти фрагменты показаны уже с вашим токеном.

URL сервера: https://app.postclaw.fun/mcp

Claude Code

claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "postclaw": {
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "postclaw": {
      "type": "http",
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Затем спросите ассистента что-нибудь вроде «Какие у меня каналы в PostClaw?», чтобы проверить подключение.


Права

У каждого токена свои права. Ассистент видит только те инструменты, которые разрешает его токен.

ПравоЧто может ассистент
Чтение (всегда включено)Просматривать каналы, посты, медиа и статистику, получать рекомендации по времени публикации
ЗаписьСоздавать и редактировать черновики, загружать медиа, писать посты с ИИ, создавать ИИ-изображения
Публикация (по умолчанию выключено)Планировать, публиковать, снимать с расписания и удалять посты в ваших реальных аккаунтах

Без права Публикация ассистент может только оставлять черновики, которые вы проверяете и одобряете в PostClaw. Включайте его только для ассистентов, которым доверяете публиковать от вашего имени.

Одновременно можно держать до 10 активных токенов. Отзыв токена срабатывает при следующем запросе ассистента.


Инструменты

ИнструментПравоЧто делает
list_channelsЧтениеПодключённые аккаунты и страницы, куда можно публиковать
list_posts, get_postЧтениеЧерновики, запланированные и опубликованные посты со ссылками и ошибками
get_analyticsЧтениеИтоги, разбивка по платформам, лучшее время, топ постов
suggest_posting_timesЧтениеУдачные слоты для каждой платформы
list_mediaЧтениеНедавно загруженные медиа
generate_postЗаписьТекст поста по брифу, при желании в голосе вашего бренда
adapt_postЗаписьОдин материал, переписанный под каждую платформу
create_imageЗаписьИИ-изображения для постов
upload_media, add_media_to_postЗаписьПрикрепить свои изображения и видео
create_post, update_postЗаписьСоздание и редактирование черновиков; указанное время ставит пост в расписание (нужно право Публикация)
publish_postПубликацияОпубликовать сейчас и вернуть ссылки на пост на каждой платформе
unschedule_postПубликацияВернуть запланированный пост в черновики
delete_postПубликацияУдалить пост из PostClaw

Медиа должно быть URL https:// или файлом, отправленным через upload_media.

create_post и publish_post принимают необязательный idempotency_key. Если ассистент повторит вызов с тем же ключом в течение 24 часов, PostClaw вернёт первый результат, а не создаст или опубликует пост дважды.


Лимиты и кредиты

Ассистент работает в рамках того же тарифа, что и вы в приложении:

  • Посты в месяц, ИИ-кредиты и квота изображений считаются одинаково — в PostClaw и через ассистента.
  • ИИ-инструменты используют ваш собственный ИИ-ключ, если он подключён в настройках.
  • Каждый токен может отправлять до 60 запросов в минуту.
  • Каждый вызов записывается в ваш аккаунт.

Решение проблем

Что вы видитеПричинаЧто делать
401 / “invalid token”Токен неверный или отозванСоздайте новый токен и обновите клиент
429Больше 60 запросов в минуту с одного токенаПодождите несколько секунд; в ответе указано, сколько
Нет нужного инструментаУ токена нет нужного праваСоздайте токен с этим правом
scope_missingПланирование или публикация без права ПубликацияВключите Публикация в новом токене или запланируйте в приложении
quota_exceeded, credit_cap_exceededМесячный лимит тарифа исчерпанДождитесь следующего периода или повысьте тариф
”your … configuration failed”Ваш собственный ИИ-ключ вернул ошибку (квота, оплата, истёкший вход)Исправьте или удалите ключ в разделе Настройки → Providers

Берегите токены

Токен действует от вашего имени. Обращайтесь с ним как с паролем:

  • Не коммитьте его в репозиторий и не вставляйте в общие чаты.
  • Используйте отдельный токен для каждого устройства или инструмента, чтобы отзывать один, не трогая остальные.
  • Отзывайте ненужные токены в разделе Настройки → ИИ-агенты.