Битрикс24 Коворк/Код можно подключить к внешним сервисам и источникам данных через MCP-сервер. Так AI-агент сможет получить нужную информацию и выполнить доступные действия в подключенном сервисе.

Например, можно подключить сервис, где команда хранит документы, и попросить Коворк найти в нем нужный файл. Доступные данные и действия зависят от возможностей MCP-сервера и прав подключенного аккаунта.

Что нужно для подключения

Перед подключением подготовьте данные для выбранного MCP-сервера:

• если сервер работает в интернете — его URL;
• если сервер нужно запустить на компьютере — команду запуска;
• аккаунт внешнего сервиса, если для подключения нужна авторизация;
• инструкцию по подключению от разработчика MCP-сервера.

Используйте только проверенные URL и команды. Команда запуска может установить программу или запустить ее на компьютере. Перед выполнением убедитесь, что понимаете назначение команды.

Как выбрать тип подключения

Тип подключения зависит от того, где находится MCP-сервер.

Удаленный сервер — подключение по URL. Выберите этот вариант, если MCP-сервер работает в интернете. Для подключения понадобится его адрес, например https://example.com/mcp. Если сервис попросит войти в аккаунт, включите OAuth-авторизацию.

Локальный сервер — запуск командой. Выберите этот вариант, если MCP-сервер нужно запустить на компьютере. Для этого в настройках укажите команду запуска, которую предоставил разработчик сервера. Для работы сервера могут потребоваться дополнительные программы.

Как подключить MCP-сервер

1. В приложении Битрикс24 Коворк/Код нажмите на аватар профиля в левом нижнем углу и выберите Настройки.
2. Откройте раздел Расширения.
3. Нажмите (+) MCP.
4. Выберите тип подключения — Удаленный (URL) или Локальный (команда).
5. Введите название и URL сервера или команду запуска. Для удаленного сервера при необходимости включите Сервер с OAuth-авторизацией.
6. Нажмите Подключить.

MCP-сервер можно добавить и прямо из сеанса.

1. Нажмите значок гаечного ключа под полем ввода.
2. Откройте вкладку MCP и нажмите Добавить MCP.
3. Выберите тип подключения и укажите данные сервера.

Как пройти OAuth-авторизацию

Некоторым удаленным MCP-серверам нужен доступ к аккаунту внешнего сервиса. В этом случае при подключении включите Сервер с OAuth-авторизацией.

После подключения откроется страница авторизации в браузере.

1. Проверьте адрес сайта и убедитесь, что открыта страница нужного сервиса.
2. Войдите в аккаунт.
3. Проверьте, какие разрешения запрашивает MCP-сервер.
4. Если можно выбрать права, оставьте только те, которые нужны для работы.
5. Подтвердите доступ и вернитесь в Битрикс24 Коворк/Код.

Не передавайте пароль, API-ключ, токен или cookie в запросе агенту. OAuth включайте только в том случае, если такой способ подключения указан в инструкции MCP-сервера.

Как проверить подключение

После настройки проверьте, что MCP-сервер доступен агенту и возвращает нужные данные.

• Убедитесь, что сервер появился в списке расширений.
• В сеансе нажмите значок гаечного ключа и откройте вкладку MCP.
• Проверьте, что подключенный сервер доступен.
• Отправьте запрос, который только получает данные и ничего не изменяет.

Пример запроса:

Найди через подключенный MCP-сервер три документа, которые недавно изменяли по проекту «Запуск сайта». Только покажи их названия и даты изменения. Ничего в документах не меняй.

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

В запросе на изменение укажите конкретный объект и нужное действие. Так проще проверить результат и не затронуть другие данные.
Например, если MCP-сервер позволяет работать с документами, можно попросить:

Найди документ «План запуска сайта» и добавь в него пункт «Согласовать дату публикации». Другие данные не изменяй.

После выполнения запроса откройте документ во внешнем сервисе и проверьте изменение.

Что делать, если MCP-сервер не работает

Сервер не подключается. Проверьте URL или команду запуска. Для удаленного сервера также проверьте доступ к интернету, VPN или прокси, если они используются.

Не завершается авторизация. Проверьте, что вы вошли в аккаунт в браузере и подтвердили запрошенные разрешения.

Агент не видит нужные данные. Проверьте права подключенного аккаунта и разрешения, которые выдали MCP-серверу.

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

Локальный сервер не запускается. Проверьте команду запуска и требования разработчика MCP-сервера. Для работы могут потребоваться дополнительные программы или пакеты.