Интеграция с AI-агентами · MCP

Chikaboom для AI-агентов

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

Что даёт интеграция

Когда вы подключаете внешнего AI-агента к Chikaboom, ваш AI-ассистент получает возможность:

  • показывать ваши бренды и доступные шаблоны
  • рендерить посты для соцсетей в фирменном стиле (одиночные, пакетом или многослайдовой каруселью)
  • планировать готовые посты в контент-календаре для автоматической публикации
  • читать запланированные посты, чтобы не занять один слот дважды

Агент работает с теми же фирменными шаблонами, которые для вас сделал дизайнер, поэтому результат всегда соответствует бренду. Агент не может рисовать фигуры или менять айдентику; он только заполняет текстовые поля, которые открыл ваш дизайнер.

Быстрый старт: Claude Desktop

  1. Создайте API-ключ. Войдите в Chikaboom, откройте «Настройки» → «API и MCP», нажмите Создать ключ. Скопируйте токен (bs_live_…). Он показывается только один раз.
  2. Отредактируйте конфигурацию Claude Desktop. В macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    {
  "mcpServers": {
    "chikaboom": {
      "url": "https://<your-chikaboom-domain>/api/mcp",
      "headers": {
        "Authorization": "Bearer bs_live_YOUR_TOKEN"
      }
    }
  }
}
  3. Перезапустите Claude Desktop. Инструменты Chikaboom появятся в списке инструментов Claude.
  4. Пишите обычным языком. Попробуйте: «Отрендерь пост для LinkedIn о запуске нашего нового продукта и запланируй его на пятницу, 9:00». Агент вызовет инструменты Chikaboom и вернёт кликабельные ссылки на превью.

Справочник инструментов

Chikaboom предоставляет через MCP следующие инструменты:

list_brands

Узнать, к каким брендам у авторизованного пользователя есть доступ.

Вход(без параметров)
ВыходArray of { brand_id, brand_name, role, templates_count }
list_templates

Список шаблонов бренда со схемой полей каждого шаблона (чтобы агент знал, какие ключи можно заполнить).

Вход{ brand_id: string }
ВыходArray of { template_id, name, category, width, height, fields[] }
render_post

Рендер одного поста в PNG. Возвращает публичный URL.

Вход{ brand_id, template_id, content: Record<string,string>, format_id? }
Выход{ url, template_id, template_name, width, height, duration_ms }
render_batch

Рендер множества постов за один вызов. Возвращает URL ZIP-архива.

Вход{ brand_id, template_id, rows: Array<Record<string,string>> }
Выход{ zip_url, total, succeeded, failed, failures[] }
render_carousel

Рендер многослайдовой карусели в PDF для документ-постов LinkedIn. Возвращает URL PDF и PNG обложки для превью.

Вход{ brand_id, slides: Array<{template_id, content}>, title? }
Выход{ pdf_url, cover_url, slides_count }
schedule_post

Создать запланированный пост в контент-календаре пользователя. Можно заранее отрендерить изображение или запланировать как черновик.

Вход{ brand_id, template_id, content, scheduled_for (ISO 8601), caption?, platforms?, asset_url? }
Выход{ post_id, status, scheduled_for, calendar_url }
list_scheduled_posts

Прочитать календарь пользователя за диапазон дат. Полезно перед планированием, чтобы не опубликовать дважды.

Вход{ brand_id, from?, to? }
Выход{ posts[], count }
ask_user

Клиентский инструмент: показывает пользователю варианты для выбора. Агент использует его, когда ответ входит в небольшой набор (какой бренд, какой шаблон, какое время и т. п.).

Вход{ question, options: string[2..6], allow_other? }
Выход(выбранный пользователем текст приходит следующим сообщением пользователя)

Детали протокола

Chikaboom реализует MCP версии 2024-11-05 поверх JSON-RPC 2.0 по адресу POST /api/mcp.

Поддерживаемые методы:

  • initialize: рукопожатие, возвращает версию протокола и сведения о сервере
  • tools/list: список доступных определений инструментов
  • tools/call: вызов инструмента с аргументами
  • notifications/initialized: пустое подтверждение (возвращает 204)

Ошибки используют стандартные коды JSON-RPC 2.0. Ошибки аутентификации возвращают -32000 с понятным сообщением; несуществующие методы возвращают -32601.

Частые вопросы

Какой протокол использует AI-интеграция Chikaboom?

MCP (Model Context Protocol). Chikaboom реализует сервер JSON-RPC 2.0 по адресу POST /api/mcp, который поддерживает стандартные методы MCP: initialize, tools/list, tools/call.

Какие AI-клиенты можно подключить к Chikaboom?

Любой MCP-совместимый клиент. Проверено: Claude Desktop. Также должны работать Cursor, собственные агенты на Anthropic SDK и другие MCP-клиенты по мере внедрения стандарта.

Как работает аутентификация AI-агентов?

По API-ключам. Каждый пользователь создаёт один или несколько ключей на странице «Настройки». Ключ даёт доступ только к брендам этого пользователя. Передавайте его как Authorization: Bearer <key>. Ключ можно отозвать в любой момент, время последнего использования записывается.

Может ли AI-агент публиковать в LinkedIn/Twitter напрямую через Chikaboom?

Косвенно. Агент вызывает schedule_post, чтобы поставить пост в календарь. Затем cron-воркер Chikaboom публикует его в подключённые платформы в запланированное время. Сам агент никогда не обращается к API платформ.

Есть ли ограничения частоты запросов к MCP-эндпоинту?

Каждый рендер занимает примерно 200-400 мс в зависимости от сложности шаблона. Жёсткого лимита сейчас нет; при злоупотреблении ключ автоматически блокируется. Пакетный инструмент снижает накладные расходы при массовых операциях.

Готовы подключиться?

Войдите, создайте API-ключ в «Настройках», и ваш AI-клиент получит рендеринг в фирменном стиле как встроенную возможность.

Войти и создать ключ