Подключение ChatGPT или Claude к MCP-серверу 3CX

Введение

В этом документе описывается процесс настройки интеграции между вашим ИИ (в данном примере мы рассмотрим использование чат-агента) и вашей АТС.

Это позволяет чат-агенту запрашивать из АТС большую часть информации (например, список добавочных номеров или активных вызовов). Данная функция станет отличным дополнением к консоли администратора (Admin Console).

Предварительные требования

Перед началом работы администратор АТС должен подготовить следующее:

  • АТС 3CX должна быть доступна извне (публично) по порту 443.
  • Если ваша АТС не работает на порту 443, подключение к OpenAI (Web), Claude (Web) или Claude (Desktop) будет невозможно; вы будете ограничены использованием OpenAI (Desktop), OpenAI (Terminal) или Claude (Terminal).
  • Пользователь 3CX с правами на аутентификацию приложения и использование необходимых инструментов.
  • Выбранный вами ИИ-клиент/агент, например ChatGPT или Claude.

Настройка ChatGPT

  • Откройте сервис OpenAI ChatGPT и войдите в свой аккаунт.

  • На странице ChatGPT нажмите на свой профиль в нижней части боковой панели и выберите пункт Settings.

  • Включите режим Developer mode
  • Если эта опция скрыта или недоступна, возможно, вы используете корпоративное рабочее пространство. Обратитесь к администратору, чтобы включить разрешения на создание пользовательских коннекторов MCP.

  • Retrieve the MCP URL for your PBX from Admin > Integrations > MCP Clients > Add MCP Client within your 3CX Admin Console.
  • Получите URL-адрес MCP для вашей АТС в консоли администратора 3CX в разделе Admin > Integrations > MCP Clients > Add MCP Client.
  • Перейдите на страницу управления плагинами OpenAI ChatGPT.

  • Нажмите значок +.

  • Укажите следующие данные:
  • Icon (Иконка)
  • Name (Имя)
  • Description (Описание)
  • Connection URL (URL-адрес подключения)

  • Если вы используете десктопное приложение ChatGPT, URL-адрес следует указать на вкладке «Streamable HTTP».

  • Укажите корректные учетные данные и параметры авторизации.
  • Authentication (Тип аутентификации должен быть установлен на OAuth).
  • Установите флажок I understand and want to continue (Я понимаю и хочу продолжить).
  • Нажмите кнопку Create (Создать) для продолжения.

  • При запросе на авторизацию интеграции вам потребуется войти в систему через портал 3CX

  • Подтвердите дополнительные инструменты, а также параметры и опции среды выполнения, представленные клиентом ИИ.

  • Откройте новый чат и протестируйте работу функции, задав вопрос, например: «Сколько добавочных номеров на моей АТС?».

Настройка Claude

  • Откройте сервис Claude и войдите в свой аккаунт.

  • Перейдите в раздел Customize -> Connectors и выберите в меню пункт Add -> Add custom connector.

  • Получите URL-адрес MCP для вашей АТС в консоли администратора 3CX в разделе Admin > Integrations > MCP Clients > Add MCP Client.

  • Задайте имя коннектора и укажите URL-адрес конечной точки MCP-сервера 3CX; нажмите кнопку Add.

  • Подтвердите дополнительные настройки инструментов и параметры среды выполнения, предложенные ИИ-клиентом.

  • Откройте новый чат и протестируйте работу функции, задав вопрос, например: «Сколько добавочных номеров на моей АТС?».

Разрешения и ограничения

Операции ИИ, выполняемые через MCP, используют учетные данные вашей учетной записи 3CX, а значит, наследуют вашу текущую роль и права доступа. Он может выполнять лишь те действия и запрашивать только ту информацию, к которым у вас уже есть прямой доступ в самой системе 3CX.

Это означает, что попытка запросить и использовать функции, к которым у вас нет доступа, приведет к ошибкам, и это является ожидаемым поведением. Дополнительную информацию о разрешениях см. в статье Инструменты MCP 3CX и уровни прав доступа.

Добавление плагинов на уровне всей организации

Сделать ваш коннектор доступным для использования всей организацией можно тем же способом, что описан выше, через разделы, связанные с рабочим пространством (workspace) в интерфейсе вашего провайдера ИИ.

Для управления корпоративными развертываниями, правами на публикацию и ограничениями на уровне администратора обращайтесь к официальной документации от разработчиков платформ:

Дополнительная информация

Версия документа
Последнее обновление документа 3 августа 2026
https://www.3cx.ru/docs/connect-chatgpt-claude-mcp-server/