Подключение Test IT MCP

Опция тарифов Стандарт и Про

Эта опция доступна в тарифах:

Test IT Стандарт
Test IT Про, версия 5.8 и более поздние
Подробнее: о тарифах Test IT.

Test IT MCP: общие принципы и данные для подключения

При настройке Test IT MCP нужно указать в IDE или ИИ-агенте адрес MCP-сервера (уже развернут в Test IT) и передать учетные данные для доступа к вашей платформе Test IT.

Работа ведется в MCP-клиенте — Cursor, VS Code с расширением Kilo Code, Zed или другом агенте с поддержкой MCP по HTTP. В настройках часто указывают транспорт (transport): Streamable HTTP или type: "streamable-http". Подключение через локальный stdio в этом сценарии не используется.

Данные, которые указываются при настройке:

URL Test IT — URL, по которому вы заходите в Test IT, без / в конце. Пример: https://qaspace.testit.software. При обращении к серверу MCP-клиент отправляет URL Test IT в заголовке X-baseurl.
URL MCP-сервера — URL Test IT с постфиксом /mcp. Пример: https://qaspace.testit.software/mcp (без / в конце).
API-токен Test IT. При обращении к серверу MCP-клиент отправляет API-токен в заголовке X-token.

Условия безопасной обработки данных

Некоторые команды MCP изменяют данные в Test IT (создание кейсов, архив, смена статуса). В чате с агентом подтверждайте действия, которые меняют проект.
Для проверок удобно создавать отдельный проект в Test IT и отдельный токен с ограниченными правами.

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

Предварительные условия

Перед настройкой, убедитесь, что:

MCP поддерживается по HTTP (не только локальный stdio).
В интерфейсе можно задать произвольные HTTP-заголовки на каждый запрос.
Поддерживаются MCP Prompts (готовые сценарии Test IT).
На вашем компьютере есть сетевой доступ к URL MCP-сервера.

Test IT MCP можно использовать в AI-агентах, поддерживающих Model Context Protocol и подключение по HTTP. При настройке в конфигурации указываются данные:

Endpoint / URL — URL платформы Test IT + /mcp
Transport — HTTP, Streamable HTTP — как в документации клиента
Custom headers — X-baseurl и X-token Конфигурация обычно расположена в файле mcp.json, в разделе mcpServers настроек IDE или в панели интеграций агента.

Пример конфигурации:

{
  "mcpServers": {
    "test-it": {
      "url": "https://xxxx.testit.software/mcp",
      "headers": {
        "X-baseurl": "https://xxxx.testit.software",
        "X-token": "PrivateToken <ваш_api_token>"
      }
    }
  }
}

Подключение в Cursor

В Cursor откройте настройки MCP одним из способов:
- Нажмите F1 или Ctrl + Shift + P (на macOS — Cmd + Shift + P ).
- Примените команду Open MCP Settings.
- Откройте директорию Settings → MCP → Add Custom Server.
  Конфигурация может быть глобальной или в файле .cursor/mcp.json в корне рабочей папки.
В конфигурационном файле укажите данные сервера:
```
{
  "mcpServers": {
    "test-it": {
      "url": "https://xxxx.testit.software/mcp",
      "headers": {
        "X-baseurl": "https://xxxx.testit.software",
        "X-token": "PrivateToken <ваш_api_token>"
      }
    }
  }
}
```
Имя test-it можно заменить на другой. В строки "url" и "X-baseurl" подставьте свой адрес Test IT. В строке url добавьте постфикс /mcp.
Сохраните файл.
Проверьте статус MCP-сервера. Убедитесь, что MCP-сервер в списке имеет статус Connected. В случае ошибки обратитесь к разделу Устранение ошибок.
Проверьте работу MCP-сервера в чате с помощью тестового запроса. Например: «Покажи список проектов в Test IT».
При корректной настройке ассистент обратится к MCP и отобразит данные вашей платформы Test IT.

В Cursor доступны готовые сценарии через MCP Prompts — команды вида /имя-сервера/имя-сценария (имя сервера совпадает с ключом в mcpServers, например test-it).

Подключение в VS Code (Kilo Code)

В VS Code MCP настраивается в расширении Kilo Code.

Установите Kilo Code. Если расширение уже установлено, пропустите этот шаг.
Откройте настройки MCP в директории: Settings → Agent Behavior → MCP Servers. Затем выберите сферу применения MCP:
- Edit Global MCP — для всех проектов в VS Code, или
- Edit Project MCP — только для текущей папки.

Добавьте конфигурацию:

{
  "mcpServers": {
    "test-it": {
      "type": "streamable-http",
      "url": "https://xxxx.testit.software/mcp",
      "headers": {
        "X-baseurl": "https://xxxx.testit.software",
        "X-token": "PrivateToken <ваш_api_token>"
      },
      "disabled": false
    }
  }
}

Укажите поле "type": "streamable-http", как показано в примере.
Опционально: Используйте параметр alwaysAllow.

О параметре `alwaysAllow`

Параметр alwaysAllow со списком имен команд позволяет делать вызовы без подтверждения действия. Его не рекомендуется использовать для команд, изменяющих данные в Test IT.

Проверьте работу сервера:
а. Если сервер не отображается, перезапустите окно VS Code.
б. В чате Kilo Code запросите список проектов Test IT. При ошибке авторизации проверьте X-baseurl (убедитесь, что указан префикс https://) и актуальность токена.

Подключение в Zed

В Zed внешние MCP-серверы называются context servers. Чтобы подключить MCP-сервер в Zed:

Откройте настройки, для этого нажмите F1 , затем примените команду zed: open settings file.

Добавьте данные сервера (context server):

{
  "context_servers": {
    "test-it-mcp": {
      "enabled": true,
      "url": "https://xxxx.testit.software/mcp",
      "headers": {
        "X-baseurl": "https://xxxx.testit.software",
        "X-token": "PrivateToken <ваш_api_token>"
      }
    }
  }
}

Вместо test-it-mcp можно использовать другое имя.
Сохраните файл и при необходимости перезапустите Zed.

Проверьте работу:
а. В AI-панели включите context server.
б. Задайте контрольный вопрос по данным Test IT, например: «Какие у меня проекты в Test IT?».
В случае ошибки обратитесь к разделу Устранение ошибок.

Устранение ошибок

Ниже описаны наиболее распространенные ошибки и способы их устранения:

Нет подключения / timeout: Проверьте URL: адрес пространства + /mcp, HTTPS, VPN и доступ в сеть организации.
Ошибка, связанная с заголовками или контекстом безопасности (security context): В конфигурационном файле проверьте X-baseurl и X-token.
Ошибка 401 или отказ Test IT: Перевыпустите API-токен Test IT, проверьте адрес платформы Test IT в X-baseurl и права пользователя в проекте.
Ассистент вносит некорректные изменения или изменяет некорректные данные: Просмотрите историю вызовов MCP в клиенте; при необходимости отмените изменения в Test IT вручную.

Если проблема сохраняется, напишите на support@testit.software. В письме укажите: клиент (Cursor / Kilo Code / Zed / другой), текст или скриншот ошибки, версию клиента.
Не отправляйте API-токен — при необходимости поддержка попросит проверить доступ иным способом.