S-WEBS24

Битрикс24

CRM, процессы и приложения для вашей компании

Разделы руководства
MCP-коннектор для агентов · руководство

Что делать, если Codex или Hermes не подключается

Найдите причину, если сервер не виден, вход не завершается или Битрикс24 не возвращает данные.

В этой инструкции Разделов: 4

Откройте приложение в Битрикс24 и обновите список Активные MCP-подключения. Если подключение появилось после входа, проверьте его на задаче, которую видите под той же учётной записью.

Codex не показывает сервер Битрикс24

Проверьте, что вся конфигурация из приложения находится в файле .codex/config.toml внутри открытой папки, а сама папка доверенная. Если файл был открыт в Блокноте, проверьте расширение. Откройте новый чат в этой папке или перезапустите Codex. Если установлен CLI, из папки проекта выполните codex mcp list.

Hermes не показывает Authorize или инструменты

Убедитесь, что сервер включён в нужном профиле. Сравните его имя и URL с вкладкой Hermes Dashboard в Битрикс24 и проверьте, что выбран OAuth. Если вы работаете в панели компании и браузер сообщает об ошибке адреса возврата, передайте администратору панели точный текст ошибки и имя MCP-сервера.

Вход открыл другой портал или не завершился

Откройте нужный портал в браузере под своей учётной записью. Возьмите свежий блок или адрес из приложения именно на этом портале и повторите вход из клиента. При ошибке занятого порта в Codex закончите другой незавершённый вход и запустите авторизацию снова.

Агент не нашёл сделку или задачу

  1. Откройте карточку на портале под той же учётной записью. Убедитесь, что номер или название совпадает.
  2. Проверьте, что клиент использует нужный сервер и раздел CRM или Задачи открыт как минимум для чтения.
  3. Если агент сообщает об ограничении персональных данных, попросите администратора проверить политику портала и разрешение этого подключения.

Если связь не восстанавливается, напишите на dev@s-webs.ru. Укажите клиент и его версию, шаг, на котором остановились, и текст ошибки. Скрывайте коды входа, токены и клиентские данные на снимках экрана.