# Коннекторы

> Подключите к чату внешние серверы с инструментами: модель сможет искать в документации,
> читать ваши данные в сервисах или выполнять в них действия — с вашего разрешения.

Коннекторы — это подключения веб-чата RouterAI к внешним серверам инструментов по открытому
протоколу Model Context Protocol (MCP, протокол контекста модели). Когда коннекторы включены,
модель видит список инструментов подключённых серверов и вызывает их по ходу ответа: например,
находит нужную страницу в документации библиотеки, а затем отвечает по ней. Вызовы показываются
в панели «Ход работы» над ответом, а вызовы, которые вы не разрешили заранее, ждут вашего
подтверждения.

> **Не путайте с MCP-сервером RouterAI.** Коннекторы дают модели в веб-чате доступ к внешним
> серверам. [MCP-сервер RouterAI](/docs/guides/mcp/overview) — обратная функция: он даёт вашему
> агенту (Claude Code, Cursor и другим) доступ к аккаунту RouterAI. Это разные настройки.

## Кому доступно

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

Инструменты умеют вызывать не все модели. Чтобы увидеть подходящие, в списке моделей нажмите
кнопку фильтра в строке поиска и отметьте «Коннекторы» в группе «Возможности». Если выбранная
модель инструменты не поддерживает, переключатель становится серым с подсказкой «Выбранная
модель не работает с инструментами.», и модель отвечает без них. Если в чате несколько моделей и часть из них без инструментов, чат об этом
предупредит: «Коннекторы используют не все выбранные модели. Без инструментов ответят: …».

## Как включить в чате

1. Нажмите переключатель «Коннекторы» рядом с переключателем веб-поиска. Если подключений
   ещё нет, нажмите «Управление подключениями» — откроется вкладка «Коннекторы» в «Настройках
   чата».
2. В разделе «В этом чате» отметьте подключения, которые модель может использовать в этом
   диалоге, — не больше трёх. В новом чате выбор применится с первым сообщением.
3. Задайте вопрос как обычно. Модель сама решит, какой инструмент вызвать.

Выключатель «Использовать коннекторы в этом чате» сохраняет выбор: отмеченные подключения
останутся на месте.

**Веб-поиск и коннекторы не работают вместе.** При включении коннекторов поиск в этом чате
приостанавливается («Веб-поиск выключен: вместе с коннекторами он не выполняется.»), а при
включении поиска выключаются коннекторы. Если часть моделей чата не работает с инструментами,
они ищут в сети как обычно.

## Подключение сервера

Вкладка «Коннекторы» → раздел «Подключения».

**Сервер из каталога.** Нажмите «Добавить из каталога» и выберите сервер; инструменты сервера
можно посмотреть заранее («Показать инструменты»). Серверы каталога подключены и проверены
RouterAI, для большинства из них свой ключ доступа не нужен. Обычно подключение из каталога сразу
готово к работе: список инструментов уже проверен RouterAI, а у серверов RouterAI и проверенных
партнёров (например, NotiSend) он одобряется сам, даже когда сервер обновит инструменты. У
остальных серверов каталога, где нужен ваш ключ или вход, список одобряете вы — так же, как у
своего сервера.

**Свой сервер.** Кнопка «Добавить свой сервер» есть в разделе, если подключение своих серверов
доступно; иначе можно подключать только серверы каталога. Заполните форму:

- «Название» — как подключение будет называться в списке.
- «Адрес сервера» — адрес, который даёт владелец сервера; он должен начинаться с `https://`.
  Не вставляйте в адрес ключи и пароли: адрес виден в настройках, для ключа есть отдельное поле.
- «Способ авторизации» — «Без авторизации», «Ключ доступа (заголовок Authorization)»,
  «Свой заголовок» с названием и значением или «Вход через сервис», если сервер просит войти в
  ваш аккаунт (см. ниже). Ключ доступа хранится зашифрованным и после сохранения не
  показывается; при смене адреса его нужно ввести заново.

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

После подключения RouterAI проверит сервер и получит список инструментов — обычно это занимает
до минуты. Подключение, которое ждёт одобрения, помечено «Требует одобрения»; в окне выбора
подключений у поля ввода эта пометка открывает подключение сразу.

Под строкой состояния подключения написано, сколько инструментов прислал сервер. Нажмите
«Посмотреть список», прочитайте инструменты и их описания (длинные раскрываются по «Показать
полностью») и нажмите «Одобрить» вверху или «Одобрить список инструментов» под списком — это одно
и то же. Описания попадут в запрос к модели, поэтому одобряйте, только если они соответствуют
назначению сервера.

### Серверы со входом через сервис

Некоторым серверам нужен не ключ, а вход в ваш аккаунт на стороне сервиса — например, серверу
рассылок NotiSend из каталога. У таких серверов в каталоге пометка «вход через сервис», а в форме
своего сервера — способ авторизации «Вход через сервис».

1. Подключите сервер. RouterAI узнаёт у сервера, где выполняется вход («Подготовка входа», обычно
   несколько секунд), и показывает состояние «Нужен вход».
2. Откройте подключение — в окне выбора подключений у поля ввода пометка «Нужен вход» тоже
   открывает его. Под кнопкой «Войти через …» написано, на каком сайте будет выполнен вход
   («Вход будет выполнен на …»). **Проверьте этот адрес до перехода**: вводите логин и пароль,
   только если это сайт того сервиса, к которому вы подключаетесь.
3. Нажмите кнопку — страница входа откроется в новой вкладке. Войдите и разрешите доступ RouterAI.
   Если браузер заблокировал вкладку, под кнопкой появится ссылка «Открыть страницу входа».
4. Вкладка покажет «Вход выполнен» — её можно закрыть. В чате подключение само проверится и
   получит список инструментов; если нужно, одобрите его, как у своего сервера.

Пароль от сервиса RouterAI не видит: сервис выдаёт RouterAI разрешение на доступ, оно хранится
в зашифрованном виде и продлевается автоматически. Если сервис перестал его принимать (вы
отозвали доступ, сменили пароль, разрешение истекло), подключение покажет «Нужен вход заново» и
кнопку «Войти заново через …» — войдите ещё раз, одобрять список инструментов повторно не нужно.

Если вход не завершился («Не удалось завершить вход»), вернитесь в чат и нажмите кнопку снова;
«Начать заново» сбрасывает незавершённую попытку. Входите из того же браузера, в котором открыт
чат.

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

### Если сервер изменил инструменты

Если сервер изменит список инструментов, подключение отключится с сообщением «Сервер изменил
список инструментов. Подключение отключено, пока вы не одобрите изменения». Под строкой состояния
подключения написано, сколько инструментов добавлено, изменено и удалено. Нажмите «Посмотреть
список», у изменённых — «Показать изменения», сравните «Было» и «Стало» и одобрите заново — или
удалите подключение, если изменения неожиданные. У серверов каталога, доступ к которым даёт
RouterAI, изменения проверяет RouterAI, и подключение заработает после проверки; у серверов
RouterAI и проверенных партнёров новый список одобряется сам.

## Подтверждение вызовов

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

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

Новое подключение своего сервера начинает с «Спрашивать», подключение из каталога — с режима,
который RouterAI задал для этого сервера. Инструменты, запрещённые в каталоге, недоступны в
любом режиме.

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

- «Разрешить» — вызов выполнится, ответ продолжится.
- «Отклонить» — вызов не выполнится; модель узнает об отказе и ответит без него.
- «Разрешать всегда для этого инструмента» → «Да, разрешать всегда» — этот инструмент этого
  подключения впредь вызывается без вопроса с любыми аргументами. Кнопка есть только в режиме
  «Вручную».

На решение отводится 15 минут: карточка показывает оставшееся время, затем вызов отклоняется
автоматически («Отклонён: истекло время подтверждения»), и модель завершает ответ без него.
Пока ответ ждёт решения, остановить его можно кнопкой остановки, как обычный ответ.

Даже разрешённый заранее вызов переспрашивается, если на модель мог повлиять другой сервер, —
карточка отметит: «Подтверждение запрошено повторно: на ответ могли повлиять данные другого
подключения». А при одобрении нового списка инструментов разрешение «всегда» на добавленные и
изменённые инструменты снимается. Подробнее — в разделе
[Как RouterAI это ограничивает](/docs/guides/chat/security#как-routerai-это-ограничивает).

## Панель «Ход работы»

Над ответом с инструментами — панель «Ход работы» с числом вызовов и временем. Пока ответ
пишется, в ней видно текущее действие: «Вызывает …», «Ждёт вашего подтверждения», «Пишет
ответ». Раскройте панель, чтобы увидеть каждый вызов: аргументы, результат и статус —
например, «Выполнен», «Инструмент вернул ошибку», «Отклонён вами» или «Прерван: действие могло
выполниться».

Если защита картинок выключена, в заголовке панели горит отметка «CSP выключена». Она
напоминает, что внешние картинки в этом ответе загружаются без защиты; нажатие открывает
настройку. Что это значит — в разделе
[Защита картинок (CSP)](/docs/guides/chat/security#защита-картинок-csp).

**Картинки от инструментов** (например, снимок шаблона письма) показываются в раскрытом вызове
и открываются по нажатию. Их видите только вы: модель получает лишь пометку, что картинка
показана пользователю.

## Удаление и отзыв доступа

- Чтобы модель перестала видеть подключение в чате, снимите его отметку в разделе «В этом чате».
- «Удалить» в карточке подключения выключает его во всех чатах и стирает ключ доступа или
  разрешение от входа через сервис; вызовы, ожидающие подтверждения, отклоняются.
- Удаление не отзывает разрешение на стороне сервиса. Чтобы закрыть доступ полностью,
  отзовите его и в настройках сервиса — в разделе приложений или доступа сторонних приложений
  вашего аккаунта.

## Работа с инструментами

В конце вкладки «Коннекторы» — раздел «Работа с инструментами» с двумя настройками для всего
аккаунта:

- **«Защита картинок в ответах (CSP)»** — не даёт внешним картинкам загружаться самим, чтобы
  данные из диалога не утекли через адрес картинки. По умолчанию выключена. Подробно —
  [Защита картинок (CSP)](/docs/guides/chat/security#защита-картинок-csp).
- **«Предел ответа на один шаг»** — сколько токенов модель может написать за один шаг работы с
  инструментами: по умолчанию 32 000. Подробно —
  [Предел ответа на один шаг](/docs/guides/chat/security#предел-ответа-на-один-шаг).

## Ограничения и стоимость

| Что | Сколько |
|---|---|
| Подключений в одном чате | до 3 |
| Подключений у аккаунта | до 20 |
| Инструментов, которые модель видит в одном ответе | до 64 на все подключения чата и до 30 000 токенов их описаний; если не помещаются, карточка подключения подскажет, сколько не попадёт, — лишние запретите в режиме «Вручную» |
| Шагов модели в одном ответе | до 8 |
| Вызовов инструментов | до 20 в одном ответе, до 5 за один шаг |
| Время ответа сервера на один вызов | до 30 секунд |
| Время работы над одним ответом | до 10 минут, ожидание вашего решения не считается |
| Ожидание вашего решения по вызову | 15 минут |
| Стоимость одного ответа с инструментами | 50 ₽: когда расход достигает предела, ответ останавливается; последний шаг может немного его превысить |
| Предел ответа модели на один шаг | 32 000 токенов, меняется в настройках (от 1 000 до 128 000) |
| Картинки в результате одного вызова | до 4, до 2 МБ каждая |
| Хранение аргументов и результатов вызовов | 30 дней, затем в вызове будет «Аргументы удалены по сроку хранения»; сам ответ модели остаётся. Подробнее — [Что хранит RouterAI](/docs/guides/chat/security#что-хранит-routerai) |

Каждый шаг модели — обычный запрос к ней по тарифу выбранной модели: описания инструментов и
результаты вызовов входят в запрос и оплачиваются как его часть. За сами вызовы серверов
RouterAI отдельно не берёт плату.

Что не поддерживается: результаты в виде звука и файлов — модель получит только текст и пометку о
пропуске; инструменты, которые по ходу работы запрашивают у вас дополнительный ввод;
серверы, для входа в которые нужно самостоятельно ввести идентификатор приложения, — подключить такой
сервер можно, только если RouterAI добавит его в каталог.

## Частые вопросы

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

**Переключатель есть, но серый.** Выбранная модель не умеет вызывать инструменты. Выберите
другую: в списке моделей включите фильтр «Коннекторы» (кнопка фильтра в строке поиска,
группа «Возможности»).

**Подключение отключилось само.** Возможные причины:

- сервер изменил список инструментов — одобрите изменения или удалите подключение;
- сервер каталога временно отключён: мы можем отключить сервер, если он перестанет работать или
  отвечать требованиям безопасности, — подключение заработает, когда сервер вернётся;
- вы сменили адрес сервера, и ключ доступа стёрт — введите его заново.

**Своё подключение не используется в чате.** Подключение своих серверов временно недоступно.
Подключение не удалено: его можно удалить или дождаться, когда функция вернётся.

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

**Вызов отклонён по сроку.** Решение не было принято за 15 минут. Задайте вопрос ещё раз и
ответьте на карточку; действие на сервере при отклонении не выполнялось.

**Вызов «Прерван: действие могло выполниться».** Сервер не ответил вовремя, но запрос до него
дошёл. Проверьте на стороне сервера, выполнилось ли действие, прежде чем повторять.

**Модель не вызывает инструменты, хотя подключения включены.** Проверьте, что подключение
отмечено в разделе «В этом чате», список инструментов одобрен, а нужный инструмент не запрещён.
Модель решает сама, нужен ли ей инструмент: попросите её прямо — «найди в документации…».

## Что дальше

- [Безопасность в чате](/docs/guides/chat/security) — риски, защита картинок, предел ответа на
  шаг, что RouterAI хранит о вызовах.
- [Обзор чата](/docs/guides/chat/overview) — остальные возможности веб-чата.
