SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Что это

MCP-сервер находится по адресу https://get-api.simplyboost.io/api/v1/mcp. Он использует транспорт Streamable HTTP и тот же API-токен, что и REST API (Authorization: Bearer sb_live_…), те же тарифы (Growth, Pro и Enterprise), те же разрешения и те же ограничения. Каждый инструмент выполняет то же действие, что и соответствующая конечная точка REST API, и требует того же разрешения; если ассистенту недоступен инструмент, он ясно сообщает об отказе, а не об ошибке.

Сервер не хранит состояние: каждый вызов — это один запрос и один ответ, сессия не нужна, поэтому подключиться можно с любого компьютера. Сервер никогда не запускает поток самостоятельно.

Подключение клиента

Есть два способа. Вход (OAuth): добавьте адрес сервера и, когда клиент попросит, подтвердите подключение во вкладке SimplyBoost, войдя как владелец команды и выбрав команду, разрешения и чат-ботов. Так подключаются коннекторы claude.ai и ChatGPT, Cursor, Codex и Claude Code — ничего вставлять не нужно. Токен: если вы вручную настраиваете клиент или используете собственный скрипт, создайте токен в Settings → API, предоставив только те разрешения, которые нужны ассистенту, и передавайте его в заголовке.

Claude Code (войдите, когда появится запрос)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code и другие клиенты с mcp.json (войдите, когда появится запрос)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

То же самое, но с токеном вместо входа

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Подключение через вход действует 90 дней, получает только разрешения, отмеченные владельцем (удаление отключено, если его не разрешили), и отображается в Settings → API → Connected apps. Владелец может отключить его в любой момент. Подтвердить подключение может только владелец команды — это то же правило, что и при создании токена. Название приложения на экране подтверждения указано самим приложением; SimplyBoost его не проверяет.

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

Для разработчиков клиентов: сервер соответствует спецификации авторизации MCP. На запрос без учётных данных он отвечает 401 с заголовком WWW-Authenticate, в котором указан адрес метаданных защищённого ресурса (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp), а в них — адрес сервера авторизации (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Клиенты регистрируются самостоятельно (Dynamic Client Registration), используют поток авторизации с кодом и PKCE (только S256), могут указать ресурс и получают обновляемые токены обновления. Токены доступа действуют один час и работают только с конечной точкой MCP; для конечных точек REST нужны API-токены.

Инструменты

Аргументы и результаты используют те же названия, что и REST API (chatbotId, threadId, поля в camelCase), поэтому описания конечных точек подходят для обоих вариантов. Чтобы узнать идентификатор чат-бота, начните с list_chatbots.

Инструмент	Требуется	Назначение
get_account	ничего	Данные учётной записи, тариф и собственные разрешения токена.
get_usage	account:read	Количество сообщений, использованных за текущий расчётный период.
list_chatbots, get_chatbot	chatbots:read	Чат-боты, доступные токену.
send_message	conversations:write	Задать вопрос чат-боту от имени посетителя; учитывается в лимите сообщений тарифа. Передайте threadId, чтобы продолжить.
list_conversations, get_conversation, list_messages	conversations:read	Диалоги во всех каналах и их сообщения.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Обрабатывать диалог как сотрудник: принять его, ответить, передать обратно, закрыть или открыть повторно.
list_leads, get_lead	leads:read	Лиды, собранные чат-ботом.
update_lead	leads:write	Изменить данные лида или отметить его как конвертированного.
delete_lead	leads:delete	Удалить лид.
list_knowledge_sources, get_knowledge_source	knowledge:read	Данные, известные чат-боту, со статусом и текстом каждого источника.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Обучить чат-бота на тексте или веб-сайте, изменить источник, повторно прочитать веб-сайт.
delete_knowledge_source	knowledge:delete	Удалить источник.

Загрузка файлов и вебхуки не доступны в виде инструментов; для них используйте конечные точки REST API. Инструменты удаления помечены как разрушающие, а инструкции сервера предписывают ассистенту сначала спросить вас.

Ошибки и ограничения

Отказ в вызове инструмента (из-за отсутствующего разрешения, недоступного токену чат-бота, недопустимого аргумента или ограничения тарифа) возвращается как результат инструмента с пометкой об ошибке и теми же code и сообщением, что и в REST API, чтобы ассистент мог подсказать, что нужно изменить. При отсутствии или недействительности токена возвращается 401, при тарифе без доступа к API или истёкшей подписке — 403, а при превышении лимита запросов для токена — 429, как и в REST API.

Сообщение, не соответствующее JSON-RPC 2.0, приводит к ошибке JSON-RPC. Запросы GET и DELETE к конечной точке возвращают 405, поскольку сессий и потоков сервера нет.