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

Источник: https://svedum.ru/docs/customize/connections

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

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

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

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

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

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

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

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

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

Токены облачных подключений хранятся на платформе «Сведума», а не на облачном компьютере:
агент вызывает инструменты, не видя сам токен. Подключения [через компьютер](#через-компьютер) —
почта, ВКонтакте, TGStat — работают с вашей машины.

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

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

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

В карточке подключения:

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

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

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

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

```json title="~/.svedum/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-серверов
подходят без правок. Токены держите в `~/.svedum/mcp.json`, а не в файле проекта, который
попадает в git.

Подключения из `.svedum/mcp.json` запускают программы, поэтому «Сведум» включит их только
после того, как вы нажмёте «Доверять» в «Персонализации». После изменения файла он
спросит снова.

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

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

Добавить такой плагин можно и в приложении, и в браузере — ставится он всё равно в
приложение на компьютере, и список плагинов везде один. Пока компьютер его не поставил,
в браузере подключение показано как «Ставится на компьютере»; войти в сервис нужно в
приложении.

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

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

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

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

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