# Подключения

Источник: https://razum.sh/docs/customize/connections

> Доступ агента к внешним системам — почте, GitHub, госреестрам, МойСклад и вашим сервисам — по протоколу MCP.

Подключение даёт агенту инструменты внешней системы: найти письмо, создать задачу, получить
карточку компании по ИНН. Подключения работают по открытому протоколу MCP, поэтому
подходят и готовые серверы из каталога, и ваши собственные.

## Готовые подключения

Самый простой путь — [плагин из магазина](https://razum.sh/docs/customize/plugins): он ставит подключение вместе
с навыками. Сейчас в магазине есть, например:

| Плагин                       | Что умеет                                            |
| ---------------------------- | ---------------------------------------------------- |
| Gmail                        | Поиск, чтение и черновики писем                      |
| Яндекс Почта, Почта Mail.ru  | Поиск, чтение и отправка писем                       |
| GitHub                       | Задачи, pull request и репозитории                   |
| ЕГРЮЛ                        | Карточка компании или ИП по названию, ИНН или ОГРН   |
| ФНС                          | Статус контрагента и налоговый режим                 |
| ЦБ РФ                        | Курсы валют, ключевая ставка, цены на металлы        |
| Госзакупки                   | Поиск извещений на zakupki.gov.ru и справочник ОКПД2 |
| Росреестр                    | Кадастровая карточка по номеру или адресу            |
| МойСклад                     | Товары, заказы и остатки                             |
| ВКонтакте, Instagram, TGStat | Сообщества, публикации и статистика                  |
| Управление задачами          | Канбан-доска: проекты, доски и карточки              |

Полный список — в «Персонализация» → «Плагины» → «Магазин».

## Вход в сервис

При первом обращении к сервису агент попросит подключиться:

* **Через страницу сервиса** — откроется страница входа, вы разрешаете доступ один раз.
  Пароли и токены в чат не попадают.
* **Токеном** — для сервисов с ключами API (МойСклад, TGStat, сообщество ВКонтакте).
  Вставьте токен в карточку — он сохранится и не попадёт ни в чат, ни к модели. Ссылка
  «Где взять токен» подскажет, где его выпустить.

Токены подключений облачных агентов и сотрудников хранятся на платформе «Разума», а не на
облачном компьютере: агент вызывает инструменты, не видя сам токен.

## Все подключения

«Персонализация» → вкладка «Подключения» показывает всё, что видит агент, со статусом:
«Подключено», «Нужна авторизация», «Выключен». В карточке подключения:

* **источник** — встроенное, ваше, проекта или из плагина;
* **инструменты** — каждый можно выключить; выключенный агент не видит. Инструменты,
  которые меняют данные, помечены «изменяет данные»;
* **переключатель** — выключенное подключение агенту не показывается.

## Своё подключение

Добавьте MCP-сервер в файл конфигурации:

* `~/.razum/mcp.json` — для вас во всех проектах («Новое подключение» → «Для меня»);
* `.razum/mcp.json` — только для этого проекта («В этом проекте»).

```json title="~/.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` запускают программы, поэтому «Разум» включит их только
после того, как вы нажмёте «Доверять» в «Персонализации». После изменения файла он
спросит снова.

## Через компьютер

Некоторые подключения работают только через ваш компьютер: вход в сервис и запросы к нему
идут с вашей машины, а не с серверов «Разума». Они помечены «Через компьютер».

Облачные агенты и сотрудники тоже могут ими пользоваться, пока приложение запущено. В
карточке подключения — «Доступно в облаке»:

* **Спрашивать** — при первом вызове на компьютере появится карточка «Никогда / Один раз /
  Всегда» с именем чата, который просит;
* **Всегда** — облачные агенты и сотрудники вызывают его без вопроса;
* **Никогда** — облаку недоступно.

Запись данных из облака всё равно подтверждается отдельно.

## Подтверждение записи

Чтение данных идёт без вопросов. Перед действием, которое что-то меняет — отправить
письмо, создать задачу, опубликовать пост, — агент спрашивает. → [Разрешения](https://razum.sh/docs/agents/permissions#действия-во-внешних-сервисах)