Инструкция

Подключение агента

Подключение агента ​

Подключение агента указывает клиенту один адрес MCP и секрет ключа. MCP здесь - Model Context Protocol. Транспорт - Streamable HTTP. Отдельного входа через стандартный ввод нет.

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

  • Есть ключ в статусе ACTIVE и секрет, скопированный при выпуске.
  • Клиент умеет Streamable HTTP и заголовок Authorization.

Секрет в клиенте

Секрет - учётные данные. Не кладите его в репозиторий, в снимок экрана и в общий чат. В интерфейсе ComplexQA после выпуска видны только четыре последних символа.

Порядок ​

  1. В клиенте агента добавьте сервер транспорта Streamable HTTP.
  2. Укажите адрес https://mcp.complexqa.com/mcp.
  3. На каждый запрос, включая список вызовов, поставьте заголовок Authorization со значением Bearer и секретом целиком, вместе с префиксом cqa_mcp_.
  4. Поставьте заголовок mcp-protocol-version в значение 2025-11-25 или 2026-07-28. Оба протокола обслуживает один процесс.
  5. В Accept передайте application/json и text/event-stream.
  6. Сохраните подключение и запросите список вызовов.

Не передавайте X-Team-Slug и не подставляйте в аргументы чужой project_id. Проект ключа сервер подставляет сам.

Результат ​

Рукопожатие возвращает имя сервера CQA_MCP и версию 0.1.0. Клиент получает один и тот же список вызовов на любом ключе. Список по разрешениям не режется. Вызов без нужной пары в Разрешениях возвращает отказ с текстом вида This key cannot UPDATE bug. и подсказкой выдать это действие.

Пустой или отозванный секрет даёт HTTP 401. Слишком частые запросы и месячный потолок успешных вызовов команды дают HTTP 429 и подсказку, есть ли смысл повторять. Очереди «подожди и повтори» на сервере нет. Временная недоступность даёт HTTP 503.

Числовые потолки задаёт стенд. В этой документации их нет: лимиты продукта живут на странице тарифов приложения.

Версия 1.0.0 · Последнее изменение 2026-09-30

Страница не помогла?