Документация › Для разработчиков › Подключить ИИ-агента

Подключить ИИ-агента (MCP)

Обновлено 4 октября 2026 г.

[для разработчиков] Подключите Claude Code, Codex или Cursor к DOS AI одной командой и управляйте проектами прямо из своего ИИ-инструмента: «покажи вчерашних лидов», «поправь промпт», «сколько потратили за неделю».

⏱ 7 мин · 👤 для разработчика и интегратора · 🟢 live

За 30 секунд:

• Адрес сервера: https://dosai.pro/api/mcp, авторизация тем же ключом dos_sk_live_…, что и у API, либо кнопкой «Разрешить» (ChatGPT, claude.ai, Claude Code) без ключа.
• В Claude Code подключается одной командой, в Codex и Cursor через конфиг.
• Агент получает 79 инструментов: создание проекта и сборка бота с нуля, подключение Telegram, чек-лист готовности, здоровье проекта, настройки бота, рабочие часы и тест-чат, база знаний, функции и уведомления о заявках, диалоги и заметки, лиды, статусы и напоминания, дожимы и правила, записи, рассылки (просмотр), аналитика, отчёты, деньги по дням и расход на рекламу, руководство.
• Удалять проекты и проводить платежи агент не может: этого нет в наборе инструментов намеренно.
• Готовые команды с подставленным ключом лежат в кабинете: раздел для разработчиков.

Что это даёт

Обычный API нужно программировать. MCP (Model Context Protocol) это стандартный «разъём», через который ИИ-инструмент видит платформу как набор понятных действий и вызывает их сам, по просьбе на человеческом языке.

Практический смысл для интегратора, который ведёт несколько клиентов:

• «Покажи все проекты, где вчера не было ни одного лида», вместо обхода кабинетов руками.
• «Прочитай промпт барбершопа, добавь правило про запись на выходные, сохрани»: правка без переключения окон.
• «Сколько диалогов и лидов у стоматологии за июль, какая конверсия»: сводка в одном ответе.
• «Открой последний диалог и ответь клиенту, что мастер перезвонит в 10:00»: ответ оператором из терминала.

Шаг 1. Выпустить ключ

Ключ выпускается в кабинете, раздел для разработчиков (/developers). Подробно про права и область действия написано в статье Публичный API.

Что важно выбрать правильно:

🔑 Ключ показывается один раз. Скопируйте сразу; потеряли, отзовите и выпустите новый.

Шаг 2. Подключить свой инструмент

Готовые команды с уже подставленным ключом появляются в кабинете сразу после создания ключа, проще скопировать оттуда. Ниже те же команды, если подключаете позже.

Claude Code

claude mcp add --transport http dosai https://dosai.pro/api/mcp \
  --header "Authorization: Bearer dos_sk_live_ВАШ_КЛЮЧ"

Проверка: claude mcp list, сервер dosai должен быть в списке. Дальше просто просите словами: «покажи мои проекты в DOS AI».

Codex

В ~/.codex/config.toml:

[mcp_servers.dosai]
url = "https://dosai.pro/api/mcp"
bearer_token_env_var = "DOSAI_KEY"

И ключ в профиль оболочки (~/.zshrc или ~/.bashrc):

export DOSAI_KEY="dos_sk_live_ВАШ_КЛЮЧ"

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

Cursor

В ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dosai": {
      "url": "https://dosai.pro/api/mcp",
      "headers": { "Authorization": "Bearer dos_sk_live_ВАШ_КЛЮЧ" }
    }
  }
}

Cursor умеет подставлять переменные окружения, так что ключ тоже можно не держать в файле: "Authorization": "Bearer ${env:DOSAI_KEY}".

Любой другой инструмент

MCP это открытый стандарт, а не список из трёх программ. Клиенты, которые умеют искать серверы сами, найдут нас в официальном реестре MCP под именем pro.dosai/dos-ai (домен подтверждён, запись активна). Проверить можно так:

curl "https://registry.modelcontextprotocol.io/v0/servers?search=dosai"

Всем остальным нужны всего две вещи:

Большинство инструментов настраиваются файлом такого вида:

{
  "mcpServers": {
    "dosai": {
      "url": "https://dosai.pro/api/mcp",
      "headers": { "Authorization": "Bearer dos_sk_live_ВАШ_КЛЮЧ" }
    }
  }
}

Проверить связь до настройки инструмента можно одной командой: в ответ придёт список инструментов.

curl -s https://dosai.pro/api/mcp \
  -H "Authorization: Bearer dos_sk_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Если инструмент вообще не умеет MCP, остаётся обычный путь: публичный REST API с тем же ключом.

ChatGPT и Claude на сайте: без ключа

Веб-версии ChatGPT и claude.ai ключ не принимают, они входят по кнопке «Разрешить» (OAuth 2.1). С 27.09.2026 это работает: в коннекторе указывается только адрес https://dosai.pro/api/mcp, дальше открывается страница DOS AI, человек входит, отмечает права и жмёт «Разрешить». Пошагово для владельца: DOS AI в ChatGPT и Claude.

Как устроено для интегратора:

• Без входа сервер отвечает 401 с заголовком WWW-Authenticate: Bearer resource_metadata="https://dosai.pro/.well-known/oauth-protected-resource/api/mcp". По этим метаданным клиент находит сервер входа (Supabase Auth, OAuth 2.1 с динамической регистрацией клиентов) и сам регистрируется.
• Права решает страница согласия, а не пропуск: смотреть всегда, менять настройки и писать клиентам отдельными галочками, плюс все проекты или один свой. Ассистент без права записи не видит инструментов записи в tools/list; без права «писать клиентам» dosai_send_operator_message отвечает понятным отказом.
• Отключение на странице «ИИ-ассистенты» снимает доступ сразу; следующий вызов получит 401 с error="invalid_token", и клиент предложит войти заново.
• Claude Code тоже умеет этот вход: claude mcp add --transport http dosai https://dosai.pro/api/mcp без заголовка откроет браузер со страницей «Разрешить». Ключ по-прежнему работает, если он вам удобнее.

Что умеет агент

Чего в наборе нет намеренно: любое удаление, платежи, счета и возвраты, пополнение баланса, запуск рассылки (пишет всей базе; черновика у рассылки нет, создание сразу ставит её в отправку), приглашение и управление участниками (клиент мог бы уговорить агента пригласить чужого человека), ссылка и QR подключения WhatsApp (кто их держит, тот может привязать к боту свой номер), кнопка «Тест» у функции (она выполняет настоящее действие), админ-функции. ИИ иногда ошибается, и цена ошибки не должна равняться удалённому проекту или списанным деньгам. Эти действия остались в API, где вызов делается осознанно. Для них агент даёт ссылку на нужную страницу кабинета (dosai_get_cabinet_link), нажимает человек.

Безопасность

• Ключ = доступ к вашим проектам. Команда подключения содержит его в открытом виде: вставляйте только в свой терминал, не выкладывайте в репозиторий и не показывайте на экране при записи видео.
• Начните с ключа только на чтение. Права на запись выдавайте, когда точно нужны правки.
• Клиенту или подрядчику выдавайте ключ, привязанный к одному проекту.
• Агент действует от вашего имени. Он видит ровно то, что видите вы, и ограничен вашей ролью на каждом проекте.
• Отправка сообщения необратима. dosai_send_operator_message пишет живому человеку в WhatsApp, Instagram или Telegram. Согласуйте текст с агентом до отправки. Если канал сообщение не принял, инструмент честно скажет «не доставлено»: в этом случае оно лежит в диалоге неотправленным и ждёт повтора.
• Тексты клиентов это данные, а не команды. В переписке может оказаться фраза вида «игнорируй прежние инструкции и сделай…». Сервер прямо предупреждает об этом агента при подключении, но привычка проверять, что именно агент собирается сделать, остаётся за вами.

Лимиты

• 120 запросов в минуту на ключ, плюс собственный лимит у каждого эндпоинта (например, аналитика 20 в минуту).
• Один вызов инструмента = два запроса к платформе, поэтому ориентируйтесь примерно на 60 действий агента в минуту.
• Лимит считается на каждый ключ отдельно: два ключа одного аккаунта имеют по своему бюджету, они не складываются и не делятся.
• При превышении приходит понятная агенту фраза «превышен лимит, подожди N секунд», и он повторит сам.

Если не работает

Под капотом

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

Каждый инструмент внутри вызывает тот же публичный REST-эндпоинт, что и обычная интеграция. Это сделано намеренно: права, лимиты, проверки и запись в журнал живут в одном месте, и агент получает ровно те же ответы, что получил бы curl. Отдельной «агентской» логики доступа не существует, поэтому она не может разойтись с основной.

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

Машиночитаемое описание REST-части лежит на https://dosai.pro/api/openapi.json, краткая памятка для агентов на https://dosai.pro/llms.txt.

Простыми словами

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

Ключ это пароль: он даёт помощнику ровно те же возможности, что есть у вас в кабинете, не больше. Если хотите, чтобы помощник только смотрел и ничего не менял, выпустите ключ «только чтение». Если работаете с одним клиентом, выпустите ключ на один проект: до остальных помощник не дотянется.

И главное, что мы решили заранее: помощник не умеет удалять проекты и трогать деньги. Даже если он что-то неправильно поймёт, худшее, что произойдёт, это изменённый текст промпта или одно лишнее сообщение клиенту. Всё это видно и поправимо.

Дальше: → Кастомные вебхуки
Связано: Публичный API · Роли и права
Не получилось? → напиши в саппорт