Подключение Claude, ChatGPT и других клиентов
Пошаговое подключение MCP-сервера платформы к Claude, ChatGPT и любому клиенту с поддержкой удалённых MCP-серверов.
Для подключения нужен клиент, который поддерживает удалённые (remote) MCP-серверы с авторизацией OAuth. Во всех случаях указывается один и тот же адрес:
https://agents.virtuman.com/api/mcp/mcp
Интерфейсы клиентов регулярно меняются, поэтому ниже описаны общие шаги. Если название пункта меню у вас отличается, ищите раздел с коннекторами, интеграциями или MCP-серверами в настройках клиента.
Перед началом
- У вас должен быть аккаунт на платформе и доступ хотя бы к одной команде.
- Проверьте, что нужные разделы (отчёты, голосовые агенты) включены для команды — см. Модули. Инструменты выключенных разделов ассистенту не показываются.
- Во время подключения откроется окно браузера. Если в браузере вы уже вошли в платформу, повторный вход не понадобится.
Claude (claude.ai и приложения Claude)
- Откройте настройки Claude и перейдите в раздел коннекторов.
- Выберите добавление собственного (custom) коннектора.
- Укажите название, например «CallSense», и адрес сервера
https://agents.virtuman.com/api/mcp/mcp. Поля для Client ID и секрета оставьте пустыми — клиент зарегистрируется автоматически. - Нажмите подключение. Откроется страница входа платформы — войдите в аккаунт.
- На экране подтверждения проверьте разрешения и нажмите Allow access.
- Вернитесь в Claude. В новом чате включите коннектор в меню инструментов и попробуйте запрос, например: «Покажи мои рабочие пространства CallSense».
Коннекторы, добавленные в аккаунте claude.ai, обычно доступны и в настольном приложении Claude. В тарифах для организаций добавлять собственные коннекторы может быть разрешено только администратору — в этом случае попросите его добавить сервер для всех.
ChatGPT
- Откройте настройки ChatGPT и перейдите в раздел коннекторов (приложений).
- Если добавление собственных MCP-серверов скрыто, включите режим разработчика в дополнительных настройках — без него ChatGPT может не позволить добавить свой сервер.
- Создайте новый коннектор: укажите название и адрес
https://agents.virtuman.com/api/mcp/mcp, способ аутентификации — OAuth. - Пройдите вход на платформе и подтвердите доступ кнопкой Allow access.
- В новом чате выберите добавленный коннектор и задайте вопрос.
Доступность собственных коннекторов в ChatGPT зависит от вашего тарифа и настроек рабочего пространства ChatGPT.
Другие MCP-клиенты
Подойдёт любой клиент, поддерживающий удалённые MCP-серверы по Streamable HTTP с OAuth, — например, редакторы кода и агентные среды с поддержкой MCP. Общий порядок:
- Добавьте сервер типа HTTP (иногда он называется «remote» или «streamable-http») с адресом
https://agents.virtuman.com/api/mcp/mcp. - Не указывайте токен вручную: клиент сам найдёт параметры авторизации, зарегистрируется и откроет браузер для входа.
- Подтвердите доступ на экране разрешений.
Если клиент умеет подключаться только к локальным серверам, используйте его штатный адаптер для удалённых MCP-серверов — при условии, что он поддерживает OAuth.
Что увидит ассистент
Сразу после подключения сервер сообщает ассистенту, какие разделы доступны вашему аккаунту и как ими пользоваться. Ассистент сам начинает с поиска ваших рабочих пространств, поэтому идентификаторы запоминать не нужно — достаточно назвать пространство или выбрать его, когда ассистент спросит.
Если что-то не работает
| Проблема | Что проверить |
|---|---|
| Окно входа не открылось | Разрешите всплывающие окна для клиента и повторите подключение |
| После входа ошибка | Убедитесь, что адрес заканчивается на /api/mcp/mcp, и подключитесь заново |
| Ассистент не видит инструменты | Проверьте, включён ли коннектор в текущем чате и включён ли нужный модуль для команды |
| Нет инструментов изменения | Подключение получило только разрешение на чтение — переподключитесь и подтвердите reports.write |
| Ответ «модуль выключен» | Модуль отключён для конкретной команды — включите его в настройках модулей |
| Ассистент «забыл» подключение | Отключите и снова подключите коннектор — вход потребуется ещё раз |