Ключ на себя
Человек выпускает ключ в ComplexQA: на себя, одну команду и один проект. Секрет показывается один раз.
Сервер отдаёт внешнему агенту действия над багами, кейсами, автотестами, документами и связанными записями. Агент читает контекст и меняет сущности по одной. Код автотеста в репозитории заказчика этот сервер не пишет.
Человек выпускает ключ в ComplexQA: на себя, одну команду и один проект. Секрет показывается один раз.
Клиент агента ходит на путь /mcp этого сайта и передаёт ключ с каждым запросом, включая список действий.
Задачу пишут текстом. Агент выбирает действия только в пределах прав ключа и прав этого человека.
Адрес для обоих клиентов один: https://mcp.complexqa.com/mcp. Ключ выпускается в ComplexQA на одного человека, одну команду и один проект. Секрет показывается один раз. В заголовок он входит целиком, со словом Bearer и пробелом перед секретом.
mcp.json. Тот же файл открывается из настроек: Ctrl+Shift+J, на macOS Cmd+Shift+J..cursor домашнего каталога. Файл одного проекта — .cursor/mcp.json в корне этого проекта.mcpServers уже есть другие серверы, добавьте только объект complexqa и сохраните остальные.Authorization замените cqa_mcp_… на секрет ключа, префикс оставьте. Сохраните файл.complexqa виден и отвечает. Вход через браузер на этом шаге значит, что в Authorization нет слова Bearer или на его месте остался пример cqa_mcp_….https://mcp.complexqa.com/mcp.Authorization. Значение — Bearer, пробел и секрет ключа. Claude отправляет значение как оно введено и схему сам не дописывает.{
"mcpServers": {
"complexqa": {
"url": "https://mcp.complexqa.com/mcp",
"headers": {
"Authorization": "Bearer cqa_mcp_…"
}
}
}
}
Ключ видит один проект. Каталог пользовательских свойств общий для команды: слот не привязан к проекту, а значение ставится на элемент этого проекта.
| Область | Можно | Пока нельзя |
|---|---|---|
| Проект | Найти проект ключа. Прочитать деревья тестов, автотестов и документов. | Создать другой проект или перенести ключ в соседний. |
| Баги | Искать, смотреть сводку, создавать, править одно поле, связывать баг с кейсом, прогоном или контекстом того же проекта. | Удалять и менять много записей одним действием. |
| Тест-кейсы | Искать наборы, кейсы и шаги. Создавать их, клонировать набор, править одно поле. | Удалять кейс или шаг. |
| Ручные прогоны | Искать прогоны и результаты. Создать прогон, добавить в него кейсы, записать результат, поправить одно поле. | Отменить прогон и массово обновить результаты. |
| Автотесты | Искать наборы, кейсы, шаги, прогоны и результаты. Собрать кейс из тест-кейса или отдельно, записать шаги, проверить синтаксис, создать прогон. | Ждать окончания прогона в том же сообщении. Отменять прогон. |
| Каталог объектов | Искать и создавать папки, страницы и элементы. Клонировать и править одно поле. | Удалять элементы каталога. |
| Документы | Искать документы и папки, читать текст, создавать документ и папку, править одно поле. | Удалять документ. |
| Метки | Искать, создавать, клонировать, копировать из шаблонов и привязывать метку к элементу этого проекта. | Снимать метку удалением. |
| Свойства | Читать каталог команды и варианты. Администратор команды может завести слот и вариант. Значение ставится на элемент проекта. | Удалять слот. Писать каталог не администратору. |
| Вложения | Искать, создать запись, прочитать короткий текст или картинку. Большой файл приходит короткой ссылкой. | Удалять файл. |
| Журнал и задачи | Искать события проекта. Показать задачи текущего человека. | Менять журнал. Создавать задачи. |
| Контекст исполнения | Искать, создавать, клонировать, править одно поле. | Удалять контекст. |
Текст ниже можно отдать агенту как есть и заменить только названия из вашего проекта. Служебные команды и номера записей сюда не входят.
Возьми один открытый баг текущего проекта. Не выдумывай шаги, которых нет в баге и в связанных записях. Найди набор, куда логично положить кейс. Создай тест-кейс и добавь шаги по тексту бага, каждый шаг отдельно. Если у бага есть метки, перенеси их на кейс. В ответе назови кейс и перечисли шаги. Ничего не удаляй.
Прочитай один тест-кейс текущего проекта и его шаги. Шаги автотеста — данные ComplexQA, не файлы в репозитории. Посмотри дерево автотестов. Создай кейс автотеста по этому тест-кейсу. Запиши шаги и проверь синтаксис. Верни название кейса автотеста. Прогон не создавай.
Создай прогон автотеста для одного готового кейса текущего проекта. Дождись только создания записи, не опрашивай статус в цикле. Назови прогон и остановись. Результат прочитаем отдельной просьбой, когда прогон завершится. Если результата ещё нет, так и скажи.
Найди последний неуспешный результат автотеста в текущем проекте. Если падения нет, баг не создавай. Собери заголовок и описание из результата и связанного кейса. Создай один баг. Если к результату есть вложение и оно уместно, приложи его. Верни название бага. Ничего не удаляй и не меняй пачкой.