MCP-сервер ТестОпс

MCP-серверСервис, реализованный по MCP-протоколу, который выступает посредником между ИИ-моделями и внешними системами ТестОпс позволяет работать с данными инстанса напрямую в интерфейсе внешних инструментов и сред с поддержкой ИИ (например, Cursor, Claude, IntelliJ IDEA, Visual Studio Code — VS Code).

Подключение к ТестОпс осуществляется по протоколу MCPОткрытый стандарт, который позволяет ИИ-модели подключаться к внешним системам поверх HTTP. Действия выполняются от имени учетной записи владельца API-токена, указанного в настройках подключения, и в пределах ее прав в проектах ТестОпс.

Подробнее о доступных инструментахФункциональная возможность внешней системы, которую вызывает ИИ-модель, чтобы выполнять действия или получать внешние данные MCP-сервера ТестОпс и примерах запросов см. Инструменты MCP-сервера ТестОпс.

Настройка подключения к MCP-серверу ТестОпс

Чтобы подключить MCP-сервер ТестОпс к инструменту или среде с поддержкой ИИ:

1. Создайте API-токен в ТестОпс.
2. Добавьте конфигурацию MCP-сервера ТестОпс в настройки инструмента или среды с поддержкой ИИ.
3. Проверьте подключение к MCP-серверу ТестОпс из интерфейса инструмента или среды с поддержкой ИИ.

1. Создайте API-токен в ТестОпс

Создайте API-токен в ТестОпс и сохраните его в безопасном месте.

2. Добавьте конфигурацию MCP-сервера в инструмент или среду с поддержкой ИИ

Конфигурация MCP-сервера ТестОпс указывается в JSON-файле инструмента или среды с поддержкой ИИ. Большинство приложений используют одинаковый формат — необходимо указать тип протокола, URL-адрес MCP-сервера и заголовок авторизации.

Воспользуйтесь одним из способов в зависимости от вашего инструмента или среды с поддержкой ИИ:

1. Перейдите в Cursor.

2. Создайте файл mcp.json в директории проекта (.cursor/) или в домашней директории (~/.cursor/mcp.json) согласно официальной документации Cursor.

3. Откройте файл mcp.json и добавьте конфигурацию:

   {
     "mcpServers": {
       "testops": {
         "type": "http",
         "url": "https://<домен ТестОпс>/api/mcp",
         "headers": {
           "Authorization": "Api-Token <API-токен>"
         }
       }
     }
   }

   где:

   • <домен ТестОпс> — домен вашего инстанса ТестОпс (например, testops.example.com);
   • <API-токен> — API-токен, который вы сохранили на шаге 1.

4. Сохраните изменения в файле.

5. Включите добавленный MCP-сервер в настройках Cursor.

3. Проверьте подключение к MCP-серверу в инструменте или среде с поддержкой ИИ

1. Убедитесь, что инструмент или среда с поддержкой ИИ показывает MCP-сервер ТестОпс как подключенный (например, со статусом «Connected» или «Active»).
2. Убедитесь, что в чате инструмента или среды с поддержкой ИИ появились инструменты MCP-сервера с префиксом testops_.
3. В чате выполните контрольный запрос к MCP-серверу ТестОпс, например: Найди тест-кейсы в проекте N.

Примечание

Подробнее о доступных инструментах MCP-сервера ТестОпс и примерах запросов см. Инструменты MCP-сервера ТестОпс.

Устранение неполадок

Не удается подключиться к MCP-серверу ТестОпс

Если инструмент или среда с поддержкой ИИ не подключается к MCP-серверу ТестОпс или возвращает ошибку авторизации (например, 401):

1. Откройте файл с конфигурацией MCP-сервера:

   1. Убедитесь, что в конфигурации указан URL-адрес вида https://<домен ТестОпс>/api/mcp, где <домен ТестОпс> — домен вашего инстанса ТестОпс.
   2. Убедитесь, что API-токен, созданный на шаге 1, не отозван и указан в конфигурации целиком, без лишних пробелов.

2. Сохраните изменения, перезапустите инструмент или среду с поддержкой ИИ и выполните повторное подключение к MCP-серверу.

MCP-сервер ТестОпс подключен, но инструменты не отображаются

Если MCP-сервер ТестОпс отображается как подключенный, но в чате нет инструментов с префиксом testops_:

• Убедитесь, что инструмент или среда с поддержкой ИИ разрешает использование протокола MCP по HTTP и передачу произвольных заголовков авторизации.
• Если вы используете Claude Code, подтвердите запуск MCP-сервера ТестОпс в запросе при запуске Claude Code или позже командой /mcp.

Запросы к инструментам не возвращают данные или завершаются ошибкой доступа

Действия через MCP-сервер ТестОпс выполняются от имени владельца API-токена и в пределах его прав в проектах.

Если инструменты MCP-сервера доступны, но запросы не находят данные или завершаются ошибкой доступа:

• Убедитесь, что в запросе указан нужный проект и что учетная запись владельца API-токена имеет доступ к этому проекту.
• Убедитесь, что ролей владельца API-токена достаточно для нужного действия, например для создания или изменения сущностей.

Claude Desktop не запускает MCP-сервер через mcp-remote

Если после сохранения файла claude_desktop_config.json MCP-сервер ТестОпс не запускается, убедитесь, что у вас установлен Node.js — он нужен для выполнения команды npx.