MCP

Подключение Voxagent к Claude, ChatGPT, Cursor и другим ИИ-ассистентам

MCP (Model Context Protocol) позволяет ИИ-ассистенту работать в Voxagent от вашего имени: читать звонки, менять агента, собирать отчёт по аналитике. Подключаете один раз — и дальше просите ассистента словами вместо того, чтобы кликать по интерфейсу.

До чего дотянется ассистент

Область	Примеры
Агенты	Прочитать настройки, поменять промпт, сменить модель или голос
Звонки и сессии	Найти звонок, прочитать транскрипт, посмотреть причину завершения
Аналитика	Запустить разбор, прочитать оценки, собрать отчёт
Инструменты	Посмотреть инструменты агента, создать новый, проверить его тестовым звонком
Тесты	Запустить прогон, прочитать результаты
Справочники	Модели, языки, сотрудники и клиенты

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

Что понадобится

Адрес сервера: https://api.voxagent.ru/mcp
Учётная запись в Voxagent

Больше копировать нечего. Ни API-ключа, ни client ID, ни секрета — адрес и есть вся настройка.

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

Вы вставляете адрес, остальное происходит само:

Клиент спрашивает у сервера, кто пускает внутрь, и получает адрес Voxagent.
Открывается окно браузера с обычной страницей входа.
Вы входите и подтверждаете доступ.
Клиент получает токен и начинает работать.

Токен принадлежит лично вам. Коллега, подключивший тот же адрес, войдёт под собой и увидит свои данные.

Подключение

Claude (веб и десктоп)

Откройте Settings → Connectors
Нажмите Add custom connector
Вставьте https://api.voxagent.ru/mcp как адрес сервера
Подтвердите — откроется окно входа
Войдите под своей учётной записью Voxagent

Коннектор появится в списке и останется доступен в каждом новом чате.

Claude Code

claude mcp add --transport http speaknode https://api.voxagent.ru/mcp

Затем выполните /mcp внутри Claude Code и выберите Authenticate. Откроется браузер, вы входите — и инструменты становятся доступны в сессии.

Cursor

Добавьте сервер в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "speaknode": {
      "url": "https://api.voxagent.ru/mcp"
    }
  }
}

Перезапустите Cursor, откройте Settings → MCP и нажмите предложение войти рядом с сервером.

ChatGPT

Откройте Settings → Connectors
Нажмите Add и выберите пользовательский коннектор
Вставьте адрес сервера и подтвердите
Войдите под своей учётной записью Voxagent

Пользовательские коннекторы доступны только на платных тарифах ChatGPT. На бесплатном раздел не появится.

Codex

Добавьте сервер в ~/.codex/config.toml:

[mcp_servers.speaknode]
url = "https://api.voxagent.ru/mcp"

Перезапустите Codex и подтвердите вход, когда он его запросит.

Доступ и безопасность

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

Он умеет не только читать, но и менять. Создание агента, правка промпта, запуск тестового прогона стоят денег так же, как из интерфейса. Читайте, что ассистент предлагает, прежде чем подтверждать.

Чтобы отозвать доступ — удалите коннектор в самом клиенте. Выход из Voxagent в браузере его не отключит: у клиента свой токен.

Если что-то пошло не так

Что видно	Что это значит	Что делать
Окно входа не открывается	Клиент не достучался до сервера	Проверьте, что адрес заканчивается на `/mcp` и открывается в браузере
`Invalid parameter: redirect_uri`	Адрес возврата этого клиента ещё не разрешён	Пришлите полный текст ошибки в поддержку — нужно добавить одну строку на нашей стороне
Вошли, но инструментов нет	Клиент подключился до того, как закончилась авторизация	Переподключите сервер в клиенте
Инструменты есть, вызовы падают	У учётной записи нет доступа к этому пространству	Проверьте в интерфейсе, что видите те же данные

MCP

Содержание