Свой API и MCP-сервер

Сервис, которого нет в каталоге, можно подключить самому: на вкладке «Свой API» по адресу API и ключу или на вкладке «MCP-серверы», если сервис даёт MCP-сервер. Обе вкладки есть в разделе «Интеграции» у каждого. Общие правила подключений (статусы, «Только чтение», отключение) описаны в разделе «Подключение сервисов», как агент решает, какое изменение сделать сам, а какое прислать на подтверждение, в разделе «Как агент меняет данные».

Свой API

Любой сервис с HTTP API: ваша учётная система, CRM на своём сервере, сервис без готовой интеграции.

Что умеет агент

Вызывает адреса вашего API: читает данные запросами GET и меняет их остальными запросами. Какие адреса есть и для чего они, агент узнаёт из поля «Подсказка для агента», поэтому чем точнее подсказка, тем меньше лишних запросов.

Что нужно заранее

  • Адрес API из документации сервиса, обычно он начинается с https://api.
  • Ключ или токен из кабинета сервиса. Если сервис открыт без ключа, ключ не нужен.
  • Если сервер доступен только в офисной сети, приложение на компьютере в этой сети («Приложения»).

Шаги

1

Откройте вкладку «Свой API»

В разделе «Интеграции» откройте вкладку «Свой API» и нажмите «Добавить API».

2

Укажите название и адрес

«Название»: как агент и вы будете звать подключение. «Адрес API»: адрес из документации сервиса. Если адрес внутренний, под полем появится подсказка, что запросы пойдут через ваш компьютер.

3

Вставьте ключ

В поле «API-ключ» вставьте ключ или токен из кабинета сервиса. Если ключ нужно передавать особым образом, нажмите «Настроить передачу ключа»: там выбирается, куда подставлять ключ (заголовок или «Параметр запроса»), имя заголовка или параметра и «Схема авторизации». Если для этого адреса уже сохранён ключ, поле можно оставить пустым, и подставится он.

4

Опишите адреса для агента

В «Подсказка для агента» перечислите адреса по одному в строке с пояснением, например GET /customers?email= (поиск клиентов) или POST /orders (создать заказ).

5

Подключите

Нажмите «Подключить»: адрес и ключ проверятся запросом к сервису. Если сервис ответил, что ключ не принят или нужен, форма скажет об этом. Когда вы уверены, что всё верно, можно нажать «Подключить без проверки».

Ключ хранится в «Ключах подключений» на вкладке «Переменные» и подставляется в каждый запрос к этому API.

Какие права выдать

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

Ограничения

  • POST считается изменением. Запросы, кроме GET, агент делает как изменения, а адрес и метод своего API не говорят, что именно меняется. Если изменение пришло карточкой на подтверждение, разрешение не запоминается для следующих вызовов.
  • POST, который только читает (поиск, отчёт по фильтру), внесите в «POST-адреса, которые только читают»: по одному пути от адреса API в строке, начиная с /, без пробелов. Такие адреса агент вызывает без подтверждения, и помощнику только для чтения они доступны. Этот список задаёте только вы в форме, агент его менять не может.
  • Долгие ответы. Если сервис отвечает медленно, задайте «Ожидание ответа, секунд». Пустое поле: значение по умолчанию.

Как отозвать доступ

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

Неполадки

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

Найди в @my_api клиента по почте ivanov@example.ru и покажи его последние заказы. Ничего не меняй.

Открыть в чате

MCP-сервер

Сервер по протоколу MCP, который даёт агенту готовые инструменты: такой адрес публикуют многие сервисы, а ещё его можно поднять у себя.

Что умеет агент

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

Что нужно заранее

  • Адрес сервера: его даёт сам сервис, ищите «MCP» в его настройках или документации. Либо JSON-конфиг из Claude, Cursor, VS Code или Zed.
  • Данные для входа, если сервер их просит: токен, ключ или аккаунт в сервисе.
  • Для сервера на вашем компьютере: адрес вида http://localhost:порт и открытое приложение («Приложения»).

Шаги

1

Откройте вкладку «MCP-серверы»

В разделе «Интеграции» откройте вкладку «MCP-серверы» и нажмите «Добавить MCP-сервер».

2

Вставьте адрес или конфиг

В поле «Адрес сервера или конфиг» вставьте адрес вида https://example.com/mcp либо JSON-конфиг. Конфиг можно загрузить файлом кнопкой «Загрузить .json»: из одного конфига подключаются сразу несколько серверов.

3

Выберите вход

Сервер проверится, и в строке «Вход» будет видно, что он требует: «не требуется», «Bearer-токен», «API-ключ в заголовке», «Basic-авторизация» или «через аккаунт сервиса». Для токена и ключа заполните «Токен авторизации», для входа через аккаунт нажмите «Авторизовать» и разрешите доступ на странице сервиса. Свои заголовки добавляются в «HTTP-заголовки».

4

Проверьте инструменты

Убедитесь, что в окне есть «Найдено инструментов», и подключите сервер.

Какие права выдать

Агент получает ровно те инструменты, что объявляет сервер, с правами токена или аккаунта, которым вы вошли. Если сервис позволяет выпустить токен только на чтение, для отчётов берите его.

Ограничения

  • Только серверы с адресом. Сервер, который запускается командой на компьютере и адреса не имеет, подключить нельзя. Подойдёт адрес http(s)://, в том числе http://localhost:порт на компьютере с приложением.
  • Локальный сервер живёт с приложением. Пока приложение на этом компьютере закрыто, агент до сервера не достучится.
  • Групповые чаты. В групповом чате с другими людьми и в группе мессенджера инструменты MCP-серверов агенту недоступны, подробнее в разделе «Групповые чаты».

Как отозвать доступ

Откройте сервер на вкладке «MCP-серверы» и нажмите «Отключить». Токен или разрешение, выданное в самом сервисе, отзывается там.

Неполадки

  • «По этому адресу нет MCP-сервера»: проверьте адрес, обычно он заканчивается на /mcp.
  • «Сервер не отвечает»: проверьте адрес и попробуйте ещё раз.
  • «Облако не подключается к этому адресу»: сервер доступен только в вашей сети, укажите адрес вида http://localhost:порт или IP в этой сети и откройте приложение.
  • «Сервер работает на вашем компьютере»: откройте на нём приложение и попробуйте ещё раз.
  • «Это локальный сервер»: в конфиге сервер без адреса, его нужно запустить с адресом http(s)://.
  • «Не удалось распознать конфиг»: проверьте формат JSON.

Нужного сервиса нет

Если у сервиса нет ни API, ни MCP-сервера, попросите интеграцию у команды прямо из чата: как это сделать, сказано на странице «Подключение сервисов».

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

Нужного сервиса нет в каталоге. Как его подключить?

Если у сервиса есть API, подключите его на вкладке «Свой API» в разделе «Интеграции»: укажите название, адрес API и ключ. Если сервис даёт MCP-сервер, подключите его на вкладке «MCP-серверы». Попросить готовую интеграцию можно из чата: агент подготовит карточку «Обращение команде».

Агент спрашивает разрешение на POST-запрос, который ничего не меняет. Как это убрать?

Все POST-запросы своего API считаются изменениями. Если адрес только читает, внесите его в поле «POST-адреса, которые только читают» в настройках подключения: по одному пути в строке, начиная с /. Такие адреса агент вызывает без подтверждения.

MCP-сервер работает на моём компьютере. Можно его подключить?

Да, если у него есть адрес вида http://localhost:порт или адрес в вашей сети. Запросы пойдут через приложение на этом компьютере, поэтому оно должно быть открыто. Сервер, который запускается только командой, без адреса, подключить нельзя.

Можно вставить конфиг MCP из Claude или Cursor?

Да. В поле «Адрес сервера или конфиг» подойдёт JSON-конфиг из Claude, Cursor, VS Code или Zed, его можно и загрузить файлом кнопкой «Загрузить .json». Серверы из конфига с адресом подключатся, локальные серверы без адреса будут пропущены.

Смотрите также

Была ли страница полезна?

Не нашли ответ? Как связаться