Onlypult API и MCP: как подключить публикацию в соцсети к своему коду и к AI-агенту

У Onlypult теперь два способа управлять публикацией программно: публичный REST API — для вашего кода и автоматизаций, и MCP-сервер — для AI-агентов вроде Claude, которые вызывают Onlypult сами, без строчки кода. API нужен, когда постами управляет ваш сервис или сценарий в n8n; MCP — когда постами управляет агент в чате. Оба работают с одними и теми же сущностями: аккаунты, медиа, посты, черновики, расписание. Оба публикуют в 15+ каналов из одного места, включая VK, Telegram и Одноклассники, которых нет у западных планировщиков. Ниже — чем API отличается от MCP, как агент собирает пост, как отдать ему картинку без выхода из чата, как не дать ему опубликовать лишнее и с чего начать за пять минут.

Чем Onlypult API отличается от MCP-сервера

API и MCP решают разные задачи, и выбор зависит от того, кто управляет публикацией — ваш код или агент. Onlypult API — это обычный REST-интерфейс: вы отправляете HTTP-запросы с ключом Authorization: Bearer, получаете JSON, встраиваете это в свой продукт, бэкенд или сценарий Zapier/Make/n8n. Onlypult MCP — это тот же функционал, обёрнутый в Model Context Protocol, открытый стандарт Anthropic, по которому AI-агент подключается к сервису и вызывает его функции сам. Разница практическая: API вызывает написанный вами код по заданной логике, а MCP вызывает агент по смыслу задачи — вы пишете «собери из этой статьи посты под VK и Telegram и положи в черновики», а он сам решает, какие инструменты вызвать.

Правило выбора простое: программируемый, предсказуемый сценарий — берите API; диалоговый, где решение принимает агент — берите MCP. Планируете постить по расписанию из своей CRM или крон-джобы — это API. Хотите, чтобы Claude в Cowork собирал контент-неделю в разговоре — это MCP. Внутри они ходят к одним и тем же данным, поэтому можно комбинировать: агент готовит черновики через MCP, а ваш бэкенд следит за статусами через вебхуки API.

Что API и MCP умеют делать

И API, и MCP покрывают весь путь поста — от подключения аккаунта до починки упавшей публикации. Onlypult сознательно отдаёт наружу не только «создать пост», а полный жизненный цикл: подключение профилей, загрузку и проверку медиа, черновики, расписание, публикацию, апрувы и отслеживание сбоев. Это отличает полноценный publishing-слой от узкого «create-only» API, где агент умеет только создать пост и слепнет на всём остальном.

Две последние строки — то, чего обычно нет у конкурентов. Агент, подключённый к Onlypult, умеет не только опубликовать, но и разобраться, что не ушло, и переотправить это одним вызовом — сценарий «покажи, что упало ночью, и почини» закрывается одной фразой.

Как AI-агент публикует пост через Onlypult MCP

Агент собирает пост в четыре шага, и первый из них — не «создать пост», а «понять контекст». Правильная последовательность выглядит так: сначала агент вызывает account_get, чтобы узнать таймзону и горизонт тарифа (иначе пост уедет на чужой часовой пояс), затем profiles_list, чтобы увидеть реальные аккаунты и не угадывать их. Только после этого он готовит текст под каждую площадку и вызывает posts_create. Порядок важен: агент, который пропускает шаг контекста, ставит посты на неверное время и ссылается на несуществующие профили.

Ключевой принцип, который стоит задавать агенту, — черновик по умолчанию. Onlypult MCP умеет и мгновенную публикацию, и расписание, но в агентном сценарии безопаснее просить is_draft — тогда агент собирает посты, а вы смотрите глазами перед выходом. Публикация становится отдельным осознанным действием, а не побочным эффектом разговора. Это тот случай, где ограничение — не слабость, а страховка: между «агент написал пост» и «пост в ленте у клиента» всегда стоит человек.

Как отдать агенту картинку, не выходя из чата

Самое частое место, где ломается связка «AI-генератор → публикация», — передача картинки, и у Onlypult для этого есть путь, не требующий смены инструмента. Когда агент работает в облаке (Claude на claude.ai или в Cowork), MCP-сервер подключён через серверы Anthropic и не видит диск вашего компьютера — поэтому «просто прикрепи файл» не срабатывает, и многие уходят из чата в Claude Code ради одной картинки. Onlypult решает это иначе: posts_create принимает до 10 публичных URL в поле media_urls, а любой AI-генератор изображений (Higgsfield, Nano Banana и другие) отдаёт результат ровно как публичную ссылку.

На практике это значит, что ассет проходит путь «генератор → публичная ссылка → Onlypult скачивает сам», не касаясь вашего диска. Мы проверили это в живом прогоне: картинка, сгенерированная в Higgsfield, ушла в три профиля на двух платформах одним вызовом posts_create — Onlypult принял её по URL и перезалил в свой CDN, публикации при этом не было. Вывод для тех, кто строит конвейер: если ассет доступен по HTTP(S)-ссылке, уходить в другой инструмент не нужно — весь цикл живёт в одном чате.

Как постить в VK, Telegram и Одноклассники из кода и из агента

Для VK, Telegram и Одноклассников Onlypult API и MCP — по сути единственный программный путь, потому что западные планировщики этих сетей не поддерживают в принципе. Крупные API-first сервисы вроде Buffer или нишевых MCP-планировщиков покрывают набор западных площадок — Facebook, Instagram, X, LinkedIn, TikTok — но не рунет. Onlypult отдаёт агенту и коду те же 15+ каналов из одной панели, включая VK, Telegram, Одноклассники, а также блоги (WordPress, Medium) и Google Business Profile.

Для агентства и для интегратора в RU/СНГ это решает конкретную задачу: один интеграционный слой на все каналы клиента, а не два стека — «западный планировщик плюс костыль под рунет». Agent или ваш сервис создаёт пост-группу на смешанный набор профилей (условно Telegram + VK + Instagram) одним вызовом, а Onlypult раскладывает его по площадкам с учётом их особенностей. По данным независимого индекса xpay на май 2026, Onlypult оценён как agent-ready — все тарифы self-serve с публичными ценами; при этом на тот момент публичной документации API снаружи ещё не было видно, что и делало этот слой недооценённым.

Как не дать агенту или скрипту опубликовать лишнее

Безопасность здесь строится на четырёх уровнях, и первый из них — песочница, а не продакшен. Onlypult API предоставляет отдельное sandbox-окружение с тестовыми ключами (opk_test_…), где можно прогнать весь сценарий, ничего не опубликовав в реальные аккаунты. Это правильный первый шаг для любой интеграции: сначала конвейер отрабатывает в песочнице, потом переключается на боевые ключи.

Второй уровень — гранулярные права на инструменты. В Claude права коннектора настраиваются не «всё или ничего», а по каждому инструменту: чтение профилей и создание черновиков можно поставить на «Always allow», а публикацию и удаление — на «Needs approval». Так агент получает руки, но не получает кнопку «опубликовать» без вашего подтверждения — а это ровно то, чего не проговаривают гайды, советующие «разрешить агенту всё». Третий уровень — сам апрув: Onlypult API объявляет очередь согласования (/approvals), где пост уходит на подтверждение человеку перед выходом. Четвёртый — идемпотентность: мутации постов принимают Idempotency-Key, поэтому повторный вызов при сбое сети не создаёт дубль. Вместе это значит, что агентную публикацию можно включать постепенно и под контролем, а не как «доверься и надейся».

С чего начать за пять минут

Начать проще всего с того способа, который соответствует вашей задаче, и с песочницы. Если вы разработчик или строите автоматизацию — возьмите API-ключ в настройках, направьте запросы на sandbox-окружение и прогоните createPost в режиме черновика; переключение на прод — это смена ключа с opk_test_ на opk_live_. Если вы работаете через AI-агента — добавьте Onlypult как коннектор в Claude (Customize → Connectors → кастомный коннектор → URL MCP-сервера), авторизуйтесь и поставьте инструментам чтения и черновиков «Always allow», а публикации — «Needs approval».

Первая типовая ошибка новичка — не выставить права и получить запрос подтверждения на каждый вызов, из-за чего конвейер встаёт на первом шаге. Вторая — сразу работать на боевых аккаунтах вместо песочницы. Обе снимаются за минуту в настройках. После этого проверка одна: попросите агента «покажи мои подключённые аккаунты» или вызовите listProfiles — если вернулся список профилей, всё подключено верно.

Сравнение: API, MCP и когда что брать