testkube-mcp — MCP-сервер для Claude Code: как установить
Подключает ассистента к платформе Testkube для управления тестами в кластере Kubernetes. Помогает запускать проверки и разбирать артефакты прямо из чата.
claude mcp add --env TK_ACCESS_TOKEN=<TK_ACCESS_TOKEN> --env TK_ORG_ID=<TK_ORG_ID> --env TK_ENV_ID=<TK_ENV_ID> --env TK_CONTROL_PLANE_URL=<TK_CONTROL_PLANE_URL> --env TK_DASHBOARD_URL=<TK_DASHBOARD_URL> --transport stdio testkube-mcp -- docker run -i --rm -e TK_ACCESS_TOKEN -e TK_ORG_ID -e TK_ENV_ID -e TK_CONTROL_PLANE_URL -e TK_DASHBOARD_URL docker.io/kubeshop/mcp-server:2.14.2Что делает testkube-mcp
Сервер связывает ИИ-ассистента с инфраструктурой Testkube в Kubernetes. С его помощью агент запускает сценарии тестирования, читает логи прогонов и собирает метрики ресурсов без перехода в веб-интерфейс.
Для интеграции доступны два способа подключения. Первый вариант использует контейнер docker.io/kubeshop/mcp-server:2.14.2 через протокол stdio. Второй работает по HTTP через адрес api.testkube.io.
Без токена доступа TK_ACCESS_TOKEN и параметров организации подключение к облачной панели не сработает. Если вы выбираете запуск через stdio, в системе обязательно должен быть установлен Docker.
Какие задачи решает
- запустить сценарии тестирования в Kubernetes через диалог с агентом
- получить логи и артефакты упавших тестов для разбора ошибок
- проверить метрики ресурсов и результаты выполнения воркфлоу
Примеры запросов агенту
- Покажи результаты последних запусков тестов в Testkube и выведи упавшие шаги.
- Запусти тестовый воркфлоу в нашем окружении и забери логи контейнера.
Как установить testkube-mcp
1Командой платформы
claude mcp add --env TK_ACCESS_TOKEN=<TK_ACCESS_TOKEN> --env TK_ORG_ID=<TK_ORG_ID> --env TK_ENV_ID=<TK_ENV_ID> --env TK_CONTROL_PLANE_URL=<TK_CONTROL_PLANE_URL> --env TK_DASHBOARD_URL=<TK_DASHBOARD_URL> --transport stdio testkube-mcp -- docker run -i --rm -e TK_ACCESS_TOKEN -e TK_ORG_ID -e TK_ENV_ID -e TK_CONTROL_PLANE_URL -e TK_DASHBOARD_URL docker.io/kubeshop/mcp-server:2.14.2Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
2Командой платформы: удалённый сервер
claude mcp add --transport http testkube-mcp https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp1Командой платформы
codex mcp add testkube-mcp --env TK_ACCESS_TOKEN=<TK_ACCESS_TOKEN> --env TK_ORG_ID=<TK_ORG_ID> --env TK_ENV_ID=<TK_ENV_ID> --env TK_CONTROL_PLANE_URL=<TK_CONTROL_PLANE_URL> --env TK_DASHBOARD_URL=<TK_DASHBOARD_URL> -- docker run -i --rm -e TK_ACCESS_TOKEN -e TK_ORG_ID -e TK_ENV_ID -e TK_CONTROL_PLANE_URL -e TK_DASHBOARD_URL docker.io/kubeshop/mcp-server:2.14.2Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
2Командой платформы: удалённый сервер
codex mcp add testkube-mcp --url https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp1Файл настроек
{
"mcpServers": {
"testkube-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TK_ACCESS_TOKEN",
"-e",
"TK_ORG_ID",
"-e",
"TK_ENV_ID",
"-e",
"TK_CONTROL_PLANE_URL",
"-e",
"TK_DASHBOARD_URL",
"docker.io/kubeshop/mcp-server:2.14.2"
],
"env": {
"TK_ACCESS_TOKEN": "<TK_ACCESS_TOKEN>",
"TK_ORG_ID": "<TK_ORG_ID>",
"TK_ENV_ID": "<TK_ENV_ID>",
"TK_CONTROL_PLANE_URL": "<TK_CONTROL_PLANE_URL>",
"TK_DASHBOARD_URL": "<TK_DASHBOARD_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
2Файл настроек
{
"mcpServers": {
"testkube-mcp": {
"url": "https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp"
}
}
}1Файл настроек
{
"servers": {
"testkube-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TK_ACCESS_TOKEN",
"-e",
"TK_ORG_ID",
"-e",
"TK_ENV_ID",
"-e",
"TK_CONTROL_PLANE_URL",
"-e",
"TK_DASHBOARD_URL",
"docker.io/kubeshop/mcp-server:2.14.2"
],
"env": {
"TK_ACCESS_TOKEN": "<TK_ACCESS_TOKEN>",
"TK_ORG_ID": "<TK_ORG_ID>",
"TK_ENV_ID": "<TK_ENV_ID>",
"TK_CONTROL_PLANE_URL": "<TK_CONTROL_PLANE_URL>",
"TK_DASHBOARD_URL": "<TK_DASHBOARD_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
2Файл настроек
{
"servers": {
"testkube-mcp": {
"type": "http",
"url": "https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp"
}
}
}1Командой платформы
gemini mcp add -e TK_ACCESS_TOKEN=<TK_ACCESS_TOKEN> -e TK_ORG_ID=<TK_ORG_ID> -e TK_ENV_ID=<TK_ENV_ID> -e TK_CONTROL_PLANE_URL=<TK_CONTROL_PLANE_URL> -e TK_DASHBOARD_URL=<TK_DASHBOARD_URL> testkube-mcp docker run -i --rm -e TK_ACCESS_TOKEN -e TK_ORG_ID -e TK_ENV_ID -e TK_CONTROL_PLANE_URL -e TK_DASHBOARD_URL docker.io/kubeshop/mcp-server:2.14.2Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
2Командой платформы: удалённый сервер
gemini mcp add -t http testkube-mcp https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о testkube-mcp
Как установить testkube-mcp в Claude Code?
Для подключения через HTTP выполните команду claude mcp add --transport http testkube-mcp https://api.testkube.io/organizations/{organization_id}/environments/{environment_id}/mcp. В адресе укажите ваши идентификаторы организации и окружения.
Что делает testkube-mcp?
Он даёт модели возможность запускать тесты в Kubernetes, проверять результаты прогонов и анализировать артефакты.
Какие варианты запуска поддерживает testkube-mcp?
Сервер можно запустить локально через образ docker.io/kubeshop/mcp-server:2.14.2 по протоколу stdio либо подключить напрямую по HTTP через Testkube API.
