# Свой API и MCP-сервер Сервис, которого нет в каталоге, можно подключить самому: на вкладке **«Свой API»** по адресу API и ключу или на вкладке **«MCP-серверы»**, если сервис даёт MCP-сервер. Обе вкладки есть в разделе **«Интеграции»** у каждого. Общие правила подключений (статусы, «Только чтение», отключение) описаны в разделе [«Подключение сервисов»](/help/integrations), как агент решает, какое изменение сделать сам, а какое прислать на подтверждение, в разделе [«Как агент меняет данные»](/help/trust). ## Свой API Любой сервис с HTTP API: ваша учётная система, CRM на своём сервере, сервис без готовой интеграции. ### Что умеет агент Вызывает адреса вашего API: читает данные запросами GET и меняет их остальными запросами. Какие адреса есть и для чего они, агент узнаёт из поля **«Подсказка для агента»**, поэтому чем точнее подсказка, тем меньше лишних запросов. ### Что нужно заранее - Адрес API из документации сервиса, обычно он начинается с https://api. - Ключ или токен из кабинета сервиса. Если сервис открыт без ключа, ключ не нужен. - Если сервер доступен только в офисной сети, приложение на компьютере в этой сети ([«Приложения»](/help/apps)). ### Шаги ### Откройте вкладку «Свой API» В разделе **«Интеграции»** откройте вкладку **«Свой API»** и нажмите **«Добавить API»**. ### Укажите название и адрес **«Название»**: как агент и вы будете звать подключение. **«Адрес API»**: адрес из документации сервиса. Если адрес внутренний, под полем появится подсказка, что запросы пойдут через ваш компьютер. ### Вставьте ключ В поле **«API-ключ»** вставьте ключ или токен из кабинета сервиса. Если ключ нужно передавать особым образом, нажмите **«Настроить передачу ключа»**: там выбирается, куда подставлять ключ (заголовок или **«Параметр запроса»**), имя заголовка или параметра и **«Схема авторизации»**. Если для этого адреса уже сохранён ключ, поле можно оставить пустым, и подставится он. ### Опишите адреса для агента В **«Подсказка для агента»** перечислите адреса по одному в строке с пояснением, например `GET /customers?email=` (поиск клиентов) или `POST /orders` (создать заказ). ### Подключите Нажмите **«Подключить»**: адрес и ключ проверятся запросом к сервису. Если сервис ответил, что ключ не принят или нужен, форма скажет об этом. Когда вы уверены, что всё верно, можно нажать **«Подключить без проверки»**. Ключ хранится в **«Ключах подключений»** на вкладке **«Переменные»** и подставляется в каждый запрос к этому API. ### Какие права выдать Агент работает с правами ключа, который вы вставили. Для отчётов выпустите в сервисе ключ только на чтение: тогда изменить данные не получится, даже если попросить. ### Ограничения - **POST считается изменением.** Запросы, кроме GET, агент делает как изменения, а адрес и метод своего API не говорят, что именно меняется. Если изменение пришло карточкой на подтверждение, разрешение не запоминается для следующих вызовов. - **POST, который только читает** (поиск, отчёт по фильтру), внесите в **«POST-адреса, которые только читают»**: по одному пути от адреса API в строке, начиная с /, без пробелов. Такие адреса агент вызывает без подтверждения, и помощнику только для чтения они доступны. Этот список задаёте только вы в форме, агент его менять не может. - **Долгие ответы.** Если сервис отвечает медленно, задайте **«Ожидание ответа, секунд»**. Пустое поле: значение по умолчанию. ### Как отозвать доступ Откройте подключение на вкладке **«Свой API»** и нажмите **«Отключить»**. Сам ключ остаётся действующим в сервисе: чтобы закрыть доступ полностью, удалите или перевыпустите его в кабинете сервиса. ### Неполадки - **«Сервис не принял ключ»**: проверьте ключ или настройте, как его передавать, в **«Настроить передачу ключа»**. - **«Сервис ответил, что нужен ключ»**: вставьте ключ из кабинета сервиса. - **Агент вызывает не те адреса**: допишите **«Подсказку для агента»**, назовите адрес и что он возвращает. - **Внутренний адрес не отвечает**: откройте приложение на компьютере в той же сети. ## MCP-сервер Сервер по протоколу MCP, который даёт агенту готовые инструменты: такой адрес публикуют многие сервисы, а ещё его можно поднять у себя. ### Что умеет агент Вызывает инструменты, которые объявляет сервер. При добавлении сервер проверяется, и в окне видно **«Найдено инструментов»**: столько инструментов получит агент. ### Что нужно заранее - Адрес сервера: его даёт сам сервис, ищите «MCP» в его настройках или документации. Либо JSON-конфиг из Claude, Cursor, VS Code или Zed. - Данные для входа, если сервер их просит: токен, ключ или аккаунт в сервисе. - Для сервера на вашем компьютере: адрес вида http://localhost:порт и открытое приложение ([«Приложения»](/help/apps)). ### Шаги ### Откройте вкладку «MCP-серверы» В разделе **«Интеграции»** откройте вкладку **«MCP-серверы»** и нажмите **«Добавить MCP-сервер»**. ### Вставьте адрес или конфиг В поле **«Адрес сервера или конфиг»** вставьте адрес вида https://example.com/mcp либо JSON-конфиг. Конфиг можно загрузить файлом кнопкой **«Загрузить .json»**: из одного конфига подключаются сразу несколько серверов. ### Выберите вход Сервер проверится, и в строке **«Вход»** будет видно, что он требует: **«не требуется»**, **«Bearer-токен»**, **«API-ключ в заголовке»**, **«Basic-авторизация»** или **«через аккаунт сервиса»**. Для токена и ключа заполните **«Токен авторизации»**, для входа через аккаунт нажмите **«Авторизовать»** и разрешите доступ на странице сервиса. Свои заголовки добавляются в **«HTTP-заголовки»**. ### Проверьте инструменты Убедитесь, что в окне есть **«Найдено инструментов»**, и подключите сервер. ### Какие права выдать Агент получает ровно те инструменты, что объявляет сервер, с правами токена или аккаунта, которым вы вошли. Если сервис позволяет выпустить токен только на чтение, для отчётов берите его. ### Ограничения - **Только серверы с адресом.** Сервер, который запускается командой на компьютере и адреса не имеет, подключить нельзя. Подойдёт адрес http(s)://, в том числе http://localhost:порт на компьютере с приложением. - **Локальный сервер живёт с приложением.** Пока приложение на этом компьютере закрыто, агент до сервера не достучится. - **Групповые чаты.** В групповом чате с другими людьми и в группе мессенджера инструменты MCP-серверов агенту недоступны, подробнее в разделе [«Групповые чаты»](/help/group-chats). ### Как отозвать доступ Откройте сервер на вкладке **«MCP-серверы»** и нажмите **«Отключить»**. Токен или разрешение, выданное в самом сервисе, отзывается там. ### Неполадки - **«По этому адресу нет MCP-сервера»**: проверьте адрес, обычно он заканчивается на /mcp. - **«Сервер не отвечает»**: проверьте адрес и попробуйте ещё раз. - **«Облако не подключается к этому адресу»**: сервер доступен только в вашей сети, укажите адрес вида http://localhost:порт или IP в этой сети и откройте приложение. - **«Сервер работает на вашем компьютере»**: откройте на нём приложение и попробуйте ещё раз. - **«Это локальный сервер»**: в конфиге сервер без адреса, его нужно запустить с адресом http(s)://. - **«Не удалось распознать конфиг»**: проверьте формат JSON. ## Нужного сервиса нет Если у сервиса нет ни API, ни MCP-сервера, попросите интеграцию у команды прямо из чата: как это сделать, сказано на странице [«Подключение сервисов»](/help/integrations#нужного-сервиса-нет).