Подключения
Доступ агента к внешним системам — почте, GitHub, госреестрам, МойСклад и вашим сервисам — по протоколу MCP.
Подключение даёт агенту инструменты внешней системы: найти письмо, создать задачу, получить карточку компании по ИНН. Подключения работают по открытому протоколу MCP, поэтому подходят и готовые серверы из каталога, и ваши собственные.
Готовые подключения
Самый простой путь — плагин из магазина: он ставит подключение вместе с навыками. Сейчас в магазине есть, например:
| Плагин | Что умеет |
|---|---|
| Gmail | Поиск, чтение и черновики писем |
| Яндекс Почта, Почта Mail.ru | Поиск, чтение и отправка писем |
| GitHub | Задачи, pull request и репозитории |
| ЕГРЮЛ | Карточка компании или ИП по названию, ИНН или ОГРН |
| ФНС | Статус контрагента и налоговый режим |
| ЦБ РФ | Курсы валют, ключевая ставка, цены на металлы |
| Госзакупки | Поиск извещений на zakupki.gov.ru и справочник ОКПД2 |
| Росреестр | Кадастровая карточка по номеру или адресу |
| МойСклад | Товары, заказы и остатки |
| ВКонтакте, Instagram, TGStat | Сообщества, публикации и статистика |
| Управление задачами | Канбан-доска: проекты, доски и карточки |
Полный список — в «Персонализация» → «Плагины» → «Магазин».
Вход в сервис
При первом обращении к сервису агент попросит подключиться:
- Через страницу сервиса — откроется страница входа, вы разрешаете доступ один раз. Пароли и токены в чат не попадают.
- Токеном — для сервисов с ключами API (МойСклад, TGStat, сообщество ВКонтакте). Вставьте токен в карточку — он сохранится и не попадёт ни в чат, ни к модели. Ссылка «Где взять токен» подскажет, где его выпустить.
Токены подключений облачных агентов и сотрудников хранятся на платформе «Разума», а не на облачном компьютере: агент вызывает инструменты, не видя сам токен.
Все подключения
«Персонализация» → вкладка «Подключения» показывает всё, что видит агент, со статусом: «Подключено», «Нужна авторизация», «Выключен». В карточке подключения:
- источник — встроенное, ваше, проекта или из плагина;
- инструменты — каждый можно выключить; выключенный агент не видит. Инструменты, которые меняют данные, помечены «изменяет данные»;
- переключатель — выключенное подключение агенту не показывается.
Своё подключение
Добавьте MCP-сервер в файл конфигурации:
~/.razum/mcp.json— для вас во всех проектах («Новое подключение» → «Для меня»);.razum/mcp.json— только для этого проекта («В этом проекте»).
{
"mcpServers": {
"crm": {
"url": "https://crm.example.ru/mcp",
"headers": { "Authorization": "Bearer <токен CRM>" }
},
"docs-search": {
"command": "npx",
"args": ["-y", "@example/docs-mcp"],
"env": { "DOCS_ROOT": "/Users/me/docs" }
}
}
}url— удалённый сервер по HTTP;headers— заголовки, например токен.command,args,env— локальный сервер, который запускается на вашем компьютере.
Формат тот же, что у Cursor, — готовые конфигурации из документации MCP-серверов
подходят без правок. Токены держите в ~/.razum/mcp.json, а не в файле проекта, который
попадает в git.
Подключения из .razum/mcp.json запускают программы, поэтому «Разум» включит их только
после того, как вы нажмёте «Доверять» в «Персонализации». После изменения файла он
спросит снова.
Через компьютер
Некоторые подключения работают только через ваш компьютер: вход в сервис и запросы к нему идут с вашей машины, а не с серверов «Разума». Они помечены «Через компьютер».
Облачные агенты и сотрудники тоже могут ими пользоваться, пока приложение запущено. В карточке подключения — «Доступно в облаке»:
- Спрашивать — при первом вызове на компьютере появится карточка «Никогда / Один раз / Всегда» с именем чата, который просит;
- Всегда — облачные агенты и сотрудники вызывают его без вопроса;
- Никогда — облаку недоступно.
Запись данных из облака всё равно подтверждается отдельно.
Подтверждение записи
Чтение данных идёт без вопросов. Перед действием, которое что-то меняет — отправить письмо, создать задачу, опубликовать пост, — агент спрашивает. → Разрешения