ИИ-агенты (MCP)
PostClaw предоставляет удалённый сервер Model Context Protocol. Подключите к нему ИИ-ассистента и просто попросите: «напиши три поста на следующую неделю и запланируй их на моей странице Facebook». Ассистент проверит каналы, подготовит черновики и поставит их в календарь от вашего имени.
Доступно на всех тарифах, включая Free. Лимиты тарифа действуют так же, как в приложении.
Что понадобится
- Аккаунт PostClaw хотя бы с одним подключённым каналом.
- MCP-клиент, который умеет отправлять заголовок
Authorizationпо Streamable HTTP: Claude Code, Cursor, VS Code и большинство других MCP-клиентов. - Токен из раздела Настройки → ИИ-агенты.
Claude.ai и ChatGPT в браузере пока не поддерживаются: им нужен вход через OAuth, он запланирован.
Подключение за две минуты
- Откройте Настройки → ИИ-агенты и нажмите Новый токен.
- Дайте токену понятное имя (например, «Cursor на ноутбуке») и выберите права.
- Скопируйте токен. Он показывается только один раз. Если вы его потеряли, отзовите его и создайте новый.
- Добавьте сервер в клиент. На странице настроек эти фрагменты показаны уже с вашим токеном.
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 |
Берегите токены
Токен действует от вашего имени. Обращайтесь с ним как с паролем:
- Не коммитьте его в репозиторий и не вставляйте в общие чаты.
- Используйте отдельный токен для каждого устройства или инструмента, чтобы отзывать один, не трогая остальные.
- Отзывайте ненужные токены в разделе Настройки → ИИ-агенты.