Jenkins MCP: три сервера для сборок в Claude Code, Codex и Cursor

lanbaoshen/mcp-jenkins· Проверено 12.11.2026· 159на GitHub

Подключает агента к Jenkins: найти job, запустить сборку с параметрами, прочитать консоль и упавшие тесты, разобрать причину падения, посмотреть очередь, агентов и плагины.

3 реализации:

34 инструмента на Python: jobs, сборки, тесты, артефакты, очередь, агенты, плагины, шаги input и Groovy; режим только чтения и HTTP-режим с данными доступа в заголовках.

Как подключить

Что сделать до подключения

uv: команда uvx скачает пакет mcp-jenkins из PyPI

JENKINS_PASSWORD

пароль или API-токен пользователя Jenkins, вместе с JENKINS_USERNAME; без обоих сервер ходит в Jenkins анонимно

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'JENKINS_URL=<адрес Jenkins>' --env 'JENKINS_USERNAME=<пользователь>' --env 'JENKINS_PASSWORD=<пароль или API-токен>' --transport stdio jenkins \
  -- uvx mcp-jenkins

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.jenkins]
command = "uvx"
args = ["mcp-jenkins"]

[mcp_servers.jenkins.env]
JENKINS_URL = "<адрес Jenkins>"
JENKINS_USERNAME = "<пользователь>"
JENKINS_PASSWORD = "<пароль или API-токен>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "<адрес Jenkins>",
        "JENKINS_USERNAME": "<пользователь>",
        "JENKINS_PASSWORD": "<пароль или API-токен>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "jenkins": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "<адрес Jenkins>",
        "JENKINS_USERNAME": "<пользователь>",
        "JENKINS_PASSWORD": "<пароль или API-токен>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "<адрес Jenkins>",
        "JENKINS_USERNAME": "<пользователь>",
        "JENKINS_PASSWORD": "<пароль или API-токен>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "<адрес Jenkins>",
        "JENKINS_USERNAME": "<пользователь>",
        "JENKINS_PASSWORD": "<пароль или API-токен>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "jenkins": {
        "type": "local",
        "command": ["uvx", "mcp-jenkins"],
        "environment": {
          "JENKINS_URL": "<адрес Jenkins>",
          "JENKINS_USERNAME": "<пользователь>",
          "JENKINS_PASSWORD": "<пароль или API-токен>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "<адрес Jenkins>",
        "JENKINS_USERNAME": "<пользователь>",
        "JENKINS_PASSWORD": "<пароль или API-токен>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "<адрес Jenkins>",
        "JENKINS_USERNAME": "<пользователь>",
        "JENKINS_PASSWORD": "<пароль или API-токен>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_all_itemsперечисляет все jobs

query_itemsищет jobs по шаблону

get_item_configчитает конфигурацию job

get_item_parametersчитает параметры job

build_itemзапускает сборку

get_buildчитает сведения о сборке

get_build_console_outputчитает консоль сборки

get_build_test_reportчитает отчёт о тестах

get_build_test_failuresпоказывает упавшие тесты

get_running_buildsпоказывает идущие сборки

stop_buildостанавливает сборку

get_pending_inputsпоказывает ждущие шаги input

submit_inputпродолжает или прерывает шаг input

get_all_build_artifactsперечисляет артефакты

get_build_artifactскачивает артефакт

get_all_queue_itemsпоказывает очередь

get_all_nodesперечисляет агентов

get_plugins_with_updatesнаходит плагины с обновлениями

get_plugins_with_problemsнаходит сломанные плагины

run_groovy_scriptвыполняет любой Groovy-скрипт

Показано 20 из 34.

39 инструментов на Node.js с bearer-токеном: стадии пайплайна, разбор упавшей сборки одним вызовом, создание и копирование jobs, управление агентами; несколько Jenkins через списки в переменных.

Как подключить

Что сделать до подключения

Node.js с командой npx

MCP_JENKINS_API_TOKEN

API-токен пользователя Jenkins вместе с MCP_JENKINS_USER; для входа по bearer-токену вместо них задайте MCP_JENKINS_BEARER_TOKEN

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MCP_JENKINS_URL=<адрес Jenkins>' --env 'MCP_JENKINS_USER=<пользователь>' --env 'MCP_JENKINS_API_TOKEN=<API-токен>' --transport stdio mcp-jenkins \
  -- npx --yes @kud/mcp-jenkins@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-jenkins]
command = "npx"
args = ["--yes", "@kud/mcp-jenkins@latest"]

[mcp_servers.mcp-jenkins.env]
MCP_JENKINS_URL = "<адрес Jenkins>"
MCP_JENKINS_USER = "<пользователь>"
MCP_JENKINS_API_TOKEN = "<API-токен>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "<адрес Jenkins>",
        "MCP_JENKINS_USER": "<пользователь>",
        "MCP_JENKINS_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-jenkins": {
      "type": "stdio",
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "<адрес Jenkins>",
        "MCP_JENKINS_USER": "<пользователь>",
        "MCP_JENKINS_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "<адрес Jenkins>",
        "MCP_JENKINS_USER": "<пользователь>",
        "MCP_JENKINS_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "<адрес Jenkins>",
        "MCP_JENKINS_USER": "<пользователь>",
        "MCP_JENKINS_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-jenkins": {
        "type": "local",
        "command": ["npx", "--yes", "@kud/mcp-jenkins@latest"],
        "environment": {
          "MCP_JENKINS_URL": "<адрес Jenkins>",
          "MCP_JENKINS_USER": "<пользователь>",
          "MCP_JENKINS_API_TOKEN": "<API-токен>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "<адрес Jenkins>",
        "MCP_JENKINS_USER": "<пользователь>",
        "MCP_JENKINS_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-jenkins": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-jenkins@latest"],
      "env": {
        "MCP_JENKINS_URL": "<адрес Jenkins>",
        "MCP_JENKINS_USER": "<пользователь>",
        "MCP_JENKINS_API_TOKEN": "<API-токен>"
      }
    }
  }
}

Инструменты сервера

jenkins_search_jobsищет jobs

jenkins_get_job_statusпоказывает состояние job

jenkins_get_job_parametersчитает параметры job

jenkins_create_jobсоздаёт job

jenkins_copy_jobкопирует job

jenkins_update_job_configменяет конфигурацию job

jenkins_trigger_buildзапускает сборку

jenkins_replay_buildповторяет сборку

jenkins_get_console_logчитает консоль сборки

jenkins_get_pipeline_stagesпоказывает стадии пайплайна

jenkins_diagnose_buildразбирает упавшую сборку

jenkins_get_build_changesпоказывает изменения в сборке

jenkins_get_test_resultsчитает результаты тестов

jenkins_get_artifactскачивает артефакт

jenkins_get_queueпоказывает очередь

jenkins_list_nodesперечисляет агентов

jenkins_toggle_node_offlineвыводит агента из работы

jenkins_get_pluginsперечисляет плагины

jenkins_list_instancesперечисляет подключённые Jenkins

jenkins_safe_restartмягко перезапускает Jenkins

Показано 20 из 39.

Заточен под разбор падений: поиск по логам через ripgrep, дерево вложенных сборок, диагностика с рекомендациями, по желанию векторный поиск похожих ошибок через Qdrant; маршрутизация между несколькими Jenkins.

Как подключить

Что сделать до подключения

Python 3.10 или новее; склонировать репозиторий и выполнить python3 -m pip install -e .

Скопировать config/mcp-config.example.yml в config/mcp-config.yml и вписать адреса Jenkins, пользователя и API-токен

Для semantic_search — Qdrant; есть вариант запуска в Docker Compose

mcp-config.yml

адрес Jenkins, имя пользователя и API-токен Jenkins для каждого экземпляра

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio jenkins-mcp-enterprise \
  -- jenkins_mcp_enterprise --config config/mcp-config.yml

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.jenkins-mcp-enterprise]
command = "jenkins_mcp_enterprise"
args = ["--config", "config/mcp-config.yml"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "jenkins-mcp-enterprise": {
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "jenkins-mcp-enterprise": {
      "type": "stdio",
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "jenkins-mcp-enterprise": {
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "jenkins-mcp-enterprise": {
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "jenkins-mcp-enterprise": {
        "type": "local",
        "command": ["jenkins_mcp_enterprise", "--config", "config/mcp-config.yml"]
      }
    }
  }
}

{
  "mcpServers": {
    "jenkins-mcp-enterprise": {
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "jenkins-mcp-enterprise": {
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

Инструменты сервера

find_jobsищет jobs

get_jenkins_job_parametersчитает параметры job

trigger_buildзапускает сборку и ждёт итога

trigger_build_asyncставит сборку в очередь

trigger_build_with_subsследит за вложенными сборками

list_job_buildsперечисляет последние сборки

get_build_infoчитает сведения о сборке

get_job_definitionпоказывает, откуда берётся job

ripgrep_searchищет по логу регулярками

filter_errors_grepвыбирает ошибки из лога

navigate_logпереходит к разделу лога

get_log_contextдостаёт кусок лога

diagnose_build_failureразбирает причину падения

semantic_searchищет похожие ошибки

apply_job_editзагружает правку job в Jenkins

Что попросить агента

«Разбери упавшую сборку <ссылка на сборку Jenkins>»Enterprise вызовет diagnose_build_failure и поищет ошибки в логе через filter_errors_grep; @kud/mcp-jenkins сделает это одним jenkins_diagnose_build

«Найди корневую причину во вложенном пайплайне <ссылка на сборку>»Enterprise пройдёт дерево вложенных сборок и вызовет diagnose_build_failure, navigate_log и get_log_context

«Покажи упавшие тесты последней сборки <имя job>»MCP Jenkins вызовет get_build и get_build_test_failures

«Запусти <имя job> с параметром BRANCH=<ветка>»Агент прочитает параметры через get_item_parameters и запустит сборку build_item

«Какие плагины Jenkins пора обновить и какие сломаны?»MCP Jenkins вызовет get_plugins_with_updates и get_plugins_with_problems

Для каких задач

Разобрать упавшую сборку по ссылке и найти корневую причину

Показать упавшие тесты и нужный кусок консоли

Запустить job с параметрами и дождаться итога

Продолжить или прервать пайплайн, который ждёт подтверждения input

Найти плагины с обновлениями или сломанными зависимостями

Посмотреть очередь и вывести агента из работы

Ограничения

По умолчанию серверы могут запускать, останавливать и удалять: у MCP Jenkins есть run_groovy_script с любым кодом на Jenkins, у @kud/mcp-jenkins — удаление jobs и перезапуск; ограничьте флагом --read-only или списком MCP_JENKINS_ALLOW_TOOLS

У @kud/mcp-jenkins 19 звёзд, у Jenkins MCP Server Enterprise 30

Enterprise ставится только из исходников или в Docker; semantic_search требует Qdrant, apply_job_edit включается отдельно

get_pending_inputs в MCP Jenkins читает данные плагина pipeline-rest-api

Если не работает

@kud/mcp-jenkins: «Jenkins request timed out»

Сервер сам сдаётся через 30 секунд. На большом или загруженном Jenkins поднимите MCP_JENKINS_TIMEOUT_MS, например до 60000.

MCP Jenkins: get_pending_inputs не видит шагов input

Инструмент читает эндпоинт wfapi плагина pipeline-rest-api, он идёт вместе с pipeline-stage-view. submit_input с явным input_id работает и без него.

Enterprise: в списке нет semantic_search

Инструмент появляется только с векторным поиском: запустите Qdrant и задайте в конфиге disable_vector_search: false и vector.host.

Enterprise: в списке нет apply_job_edit

Включите в config/mcp-config.yml settings.enable_job_editing: true и задайте job_edit_workspace_dir.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP Jenkins	lanbaoshen	159	локально	токен	34	9 ноября 2026
@kud/mcp-jenkins	kud	19	локально	токен	39	12 ноября 2026
Jenkins MCP Server Enterprise	Jordan-Jarvis	30	локально	токен	15	21 сентября 2026

Частые вопросы

Какой из трёх серверов выбрать?

Для повседневной работы со сборками в Claude Code или Cursor подойдёт MCP Jenkins: запуск через uvx и 34 инструмента. @kud/mcp-jenkins нужен, если у вас bearer-токен, несколько Jenkins или вы хотите править jobs. Enterprise берите для глубокого разбора падений по логам вложенных пайплайнов.

Как запретить агенту запускать сборки и менять jobs?

У MCP Jenkins добавьте флаг --read-only. У @kud/mcp-jenkins перечислите разрешённые инструменты в MCP_JENKINS_ALLOW_TOOLS или скрытые в MCP_JENKINS_BLOCK_TOOLS. В Enterprise правка jobs работает, только если в конфиге включён enable_job_editing.

Можно подключить несколько Jenkins?

У @kud/mcp-jenkins перечислите адреса через запятую в MCP_JENKINS_URL, имена задаются в MCP_JENKINS_INSTANCES. Enterprise выбирает экземпляр по jenkins_url в каждом вызове, сразу по всем серверам он не ходит.

Можно поднять один сервер для всей команды?

Да, MCP Jenkins запускается с --transport streamable-http на порту 9887 или из образа ghcr.io/lanbaoshen/mcp-jenkins. Адрес Jenkins и данные входа клиент передаёт в заголовках x-jenkins-url, x-jenkins-username и x-jenkins-password.

Как подключить Jenkins MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить»: там запуск MCP Jenkins через uvx mcp-jenkins с переменными JENKINS_URL, JENKINS_USERNAME и JENKINS_PASSWORD. Данные можно держать и в файле .env, сервер подхватит его сам.

Как подключить Jenkins MCP в VS Code?

Запустите uvx mcp-jenkins с --jenkins-url, --jenkins-username, --jenkins-password и --transport sse, затем в .vscode/mcp.json добавьте сервер с type sse и url http://localhost:9887/sse. Для streamable-http адрес http://localhost:9887/mcp.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и обращаются только к вашему Jenkins, зарубежные аккаунты не нужны.

Jenkins MCP: три сервера для сборок в Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы