ComplexQA MCP

Агент работает в одном проекте ComplexQA.

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


01

Ключ на себя

Человек выпускает ключ в ComplexQA: на себя, одну команду и один проект. Секрет показывается один раз.

02

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

Клиент агента ходит на путь /mcp этого сайта и передаёт ключ с каждым запросом, включая список действий.

03

Просьба обычным языком

Задачу пишут текстом. Агент выбирает действия только в пределах прав ключа и прав этого человека.

Подключение

Адрес для обоих клиентов один: https://mcp.complexqa.com/mcp. Ключ выпускается в ComplexQA на одного человека, одну команду и один проект. Секрет показывается один раз. В заголовок он входит целиком, со словом Bearer и пробелом перед секретом.

Cursor

  1. В боковой панели Cursor откройте Customize и добавьте свой сервер MCP. Cursor откроет файл mcp.json. Тот же файл открывается из настроек: Ctrl+Shift+J, на macOS Cmd+Shift+J.
  2. Файл для всех проектов лежит в папке .cursor домашнего каталога. Файл одного проекта — .cursor/mcp.json в корне этого проекта.
  3. Пустой файл замените примером ниже. Если в mcpServers уже есть другие серверы, добавьте только объект complexqa и сохраните остальные.
  4. В значении Authorization замените cqa_mcp_… на секрет ключа, префикс оставьте. Сохраните файл.
  5. Сохраните файл. В списке MCP сервер complexqa виден и отвечает. Вход через браузер на этом шаге значит, что в Authorization нет слова Bearer или на его месте остался пример cqa_mcp_….

Claude

  1. Откройте настройки Claude, раздел коннекторов, пункт «Добавить пользовательский коннектор». Чат этот коннектор не создаёт.
  2. Имя — любое, например ComplexQA. Адрес — https://mcp.complexqa.com/mcp.
  3. В блоке «Аутентификация» выберите «Без входа». Пункт «Войти сейчас» Claude может пометить «Обнаружено»: без ключа сервер отвечает отказом, и Claude принимает это за вход через OAuth. У этого адреса нет сервера авторизации, и такой вход обрывается.
  4. В «Заголовки запроса» добавьте заголовок. Имя — Authorization. Значение — Bearer, пробел и секрет ключа. Claude отправляет значение как оно введено и схему сам не дописывает.
  5. Транспорт оставьте Streamable HTTP. При «Без входа» блок «Клиент OAuth» не показывается.
  6. Нажмите «Добавить». В организации Claude этот заголовок общий: каждый, кто пользуется коннектором, работает в проекте этого ключа.

Файл mcp.json для Cursor

{
  "mcpServers": {
    "complexqa": {
      "url": "https://mcp.complexqa.com/mcp",
      "headers": {
        "Authorization": "Bearer cqa_mcp_…"
      }
    }
  }
}

Текущие возможности

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

Область Можно Пока нельзя
Проект Найти проект ключа. Прочитать деревья тестов, автотестов и документов. Создать другой проект или перенести ключ в соседний.
Баги Искать, смотреть сводку, создавать, править одно поле, связывать баг с кейсом, прогоном или контекстом того же проекта. Удалять и менять много записей одним действием.
Тест-кейсы Искать наборы, кейсы и шаги. Создавать их, клонировать набор, править одно поле. Удалять кейс или шаг.
Ручные прогоны Искать прогоны и результаты. Создать прогон, добавить в него кейсы, записать результат, поправить одно поле. Отменить прогон и массово обновить результаты.
Автотесты Искать наборы, кейсы, шаги, прогоны и результаты. Собрать кейс из тест-кейса или отдельно, записать шаги, проверить синтаксис, создать прогон. Ждать окончания прогона в том же сообщении. Отменять прогон.
Каталог объектов Искать и создавать папки, страницы и элементы. Клонировать и править одно поле. Удалять элементы каталога.
Документы Искать документы и папки, читать текст, создавать документ и папку, править одно поле. Удалять документ.
Метки Искать, создавать, клонировать, копировать из шаблонов и привязывать метку к элементу этого проекта. Снимать метку удалением.
Свойства Читать каталог команды и варианты. Администратор команды может завести слот и вариант. Значение ставится на элемент проекта. Удалять слот. Писать каталог не администратору.
Вложения Искать, создать запись, прочитать короткий текст или картинку. Большой файл приходит короткой ссылкой. Удалять файл.
Журнал и задачи Искать события проекта. Показать задачи текущего человека. Менять журнал. Создавать задачи.
Контекст исполнения Искать, создавать, клонировать, править одно поле. Удалять контекст.

Границы

  • Один ключ — один человек, одна команда, один проект. Соседний проект той же команды этим ключом не открывается.
  • Ключ не шире человека. Если человека убрали из команды или сузили роль, ключ это наследует.
  • Список действий у всех клиентов одинаковый. Запрет приходит в момент вызова, если этого права на ключе нет.
  • Создание лучше повторять той же формулировкой. Новая формулировка с тем же смыслом может создать вторую запись.
  • Прогон автотеста не дожидаются в одном сообщении. Сначала создают прогон, позже отдельной просьбой читают результат.
  • Есть предел частоты и потолок результатов команды за календарный месяц. Исчерпанный месяц открывается в следующем.

Примеры просьб

Текст ниже можно отдать агенту как есть и заменить только названия из вашего проекта. Служебные команды и номера записей сюда не входят.

Из бага собрать тест-кейс

Возьми один открытый баг текущего проекта. Не выдумывай шаги, которых нет в баге и в связанных записях.

Найди набор, куда логично положить кейс. Создай тест-кейс и добавь шаги по тексту бага, каждый шаг отдельно. Если у бага есть метки, перенеси их на кейс.

В ответе назови кейс и перечисли шаги. Ничего не удаляй.

Из тест-кейса собрать автотест

Прочитай один тест-кейс текущего проекта и его шаги. Шаги автотеста — данные ComplexQA, не файлы в репозитории.

Посмотри дерево автотестов. Создай кейс автотеста по этому тест-кейсу. Запиши шаги и проверь синтаксис.

Верни название кейса автотеста. Прогон не создавай.

Создать прогон и позже прочитать результат

Создай прогон автотеста для одного готового кейса текущего проекта. Дождись только создания записи, не опрашивай статус в цикле.

Назови прогон и остановись. Результат прочитаем отдельной просьбой, когда прогон завершится. Если результата ещё нет, так и скажи.

Из падения завести баг

Найди последний неуспешный результат автотеста в текущем проекте. Если падения нет, баг не создавай.

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

Верни название бага. Ничего не удаляй и не меняй пачкой.