Подключения

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

Готовые подключенияСкопировать ссылку

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

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

Вход в сервисСкопировать ссылку

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

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

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

Все подключенияСкопировать ссылку

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

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

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

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

Своё подключениеСкопировать ссылку

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

• ~/.svedum/mcp.json — для вас во всех проектах («Новое подключение» → «Для меня»);
• .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 запускают программы, поэтому «Сведум» включит их только после того, как вы нажмёте «Доверять» в «Персонализации». После изменения файла он спросит снова.

Через компьютерСкопировать ссылку

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

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

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

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

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

Подтверждение записиСкопировать ссылку

Чтение данных идёт без вопросов. Перед действием, которое что-то меняет — отправить письмо, создать задачу, опубликовать пост, — агент спрашивает, а в режиме разрешений «Проверять» такое действие сначала оценивает проверка: то, о чём вы просили, она пропускает, письма незнакомым адресатам и отправку без вашей просьбы останавливает. → Разрешения