Подключение Claude, ChatGPT и других клиентов

Пошаговое подключение MCP-сервера платформы к Claude, ChatGPT и любому клиенту с поддержкой удалённых MCP-серверов.

Для подключения нужен клиент, который поддерживает удалённые (remote) MCP-серверы с авторизацией OAuth. Во всех случаях указывается один и тот же адрес:

https://agents.virtuman.com/api/mcp/mcp

Интерфейсы клиентов регулярно меняются, поэтому ниже описаны общие шаги. Если название пункта меню у вас отличается, ищите раздел с коннекторами, интеграциями или MCP-серверами в настройках клиента.

Перед началом

  • У вас должен быть аккаунт на платформе и доступ хотя бы к одной команде.
  • Проверьте, что нужные разделы (отчёты, голосовые агенты) включены для команды — см. Модули. Инструменты выключенных разделов ассистенту не показываются.
  • Во время подключения откроется окно браузера. Если в браузере вы уже вошли в платформу, повторный вход не понадобится.

Claude (claude.ai и приложения Claude)

  1. Откройте настройки Claude и перейдите в раздел коннекторов.
  2. Выберите добавление собственного (custom) коннектора.
  3. Укажите название, например «CallSense», и адрес сервера https://agents.virtuman.com/api/mcp/mcp. Поля для Client ID и секрета оставьте пустыми — клиент зарегистрируется автоматически.
  4. Нажмите подключение. Откроется страница входа платформы — войдите в аккаунт.
  5. На экране подтверждения проверьте разрешения и нажмите Allow access.
  6. Вернитесь в Claude. В новом чате включите коннектор в меню инструментов и попробуйте запрос, например: «Покажи мои рабочие пространства CallSense».

Коннекторы, добавленные в аккаунте claude.ai, обычно доступны и в настольном приложении Claude. В тарифах для организаций добавлять собственные коннекторы может быть разрешено только администратору — в этом случае попросите его добавить сервер для всех.

ChatGPT

  1. Откройте настройки ChatGPT и перейдите в раздел коннекторов (приложений).
  2. Если добавление собственных MCP-серверов скрыто, включите режим разработчика в дополнительных настройках — без него ChatGPT может не позволить добавить свой сервер.
  3. Создайте новый коннектор: укажите название и адрес https://agents.virtuman.com/api/mcp/mcp, способ аутентификации — OAuth.
  4. Пройдите вход на платформе и подтвердите доступ кнопкой Allow access.
  5. В новом чате выберите добавленный коннектор и задайте вопрос.

Доступность собственных коннекторов в ChatGPT зависит от вашего тарифа и настроек рабочего пространства ChatGPT.

Другие MCP-клиенты

Подойдёт любой клиент, поддерживающий удалённые MCP-серверы по Streamable HTTP с OAuth, — например, редакторы кода и агентные среды с поддержкой MCP. Общий порядок:

  1. Добавьте сервер типа HTTP (иногда он называется «remote» или «streamable-http») с адресом https://agents.virtuman.com/api/mcp/mcp.
  2. Не указывайте токен вручную: клиент сам найдёт параметры авторизации, зарегистрируется и откроет браузер для входа.
  3. Подтвердите доступ на экране разрешений.

Если клиент умеет подключаться только к локальным серверам, используйте его штатный адаптер для удалённых MCP-серверов — при условии, что он поддерживает OAuth.

Что увидит ассистент

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

Если что-то не работает

ПроблемаЧто проверить
Окно входа не открылосьРазрешите всплывающие окна для клиента и повторите подключение
После входа ошибкаУбедитесь, что адрес заканчивается на /api/mcp/mcp, и подключитесь заново
Ассистент не видит инструментыПроверьте, включён ли коннектор в текущем чате и включён ли нужный модуль для команды
Нет инструментов измененияПодключение получило только разрешение на чтение — переподключитесь и подтвердите reports.write
Ответ «модуль выключен»Модуль отключён для конкретной команды — включите его в настройках модулей
Ассистент «забыл» подключениеОтключите и снова подключите коннектор — вход потребуется ещё раз

Что дальше