jira-mcp

Сервер Model Context Protocol для Jira Cloud. Создайте задачи и подзадады, читайте задачи, ищите через JQL, просматривайте agile-доски и их swimlane, перемещайте задачи по их рабочему процессу, добавляйте коментарии и приереплите файлы.

Аутентификац происодит с помощью адрес электронной почты аккаунта Atlassian и API-токена, поэтому сервер работает без интерфейса — без OAuth, без хождения в браузер, без интерактикового согласия.

Устанока

Устанавливать нечего. Укажите вашему MCP-клиенту на пакет и позвольте npx скачать его:

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:skurekjakub/jira-mcp#v1.0.0"],
      "env": {
        "NPM_CONFIG_ALLOW_GIT": "root",
        "JIRA_SITE": "your-team.atlassian.net",
        "JIRA_CLOUD_ID": "00000000-0000-0000-0000-000000000000",
        "JIRA_PROJECT_KEY": "ABC",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}

Собранный артефакт закомичен, а завичимостей времени выполнения уже встроены в него, поэтому установка — это клонирование и создание ссылок: без шага сборки, без пакетов, которые надо получать, и без установочного скрипта, который нужно одобрять.

NPM_CONFIG_ALLOW_GIT

npx 12 по умолчанию присвоивает allow-git значение none, поэтому без этого npm отклан fetch packages with EALLOWGIT — «Загрузка пакетов типа git в данной системе группы»: "Загрузка пакетов типа git была отключена". Установим эту переменную в блоке env сервера, исключаются только этот подпроцесс, а для всех остальных установок на машине fetch git-пакетов останется отключенным. root разрешает её только для устанавливаемого пакета, но не для всего, от чего он может заведения; all полностью снимает ограничение, и в даном случае она не нужна. On npm 11 and older, they don't take it into account.

Установка один раз вместо этого

npx при каждом запуске токи разреша процедуру а git-reф, на что уходит несколько секунд и сетевой обмен. Чтобы избе both:

npm install -g --allow-git=root github:skurekjakub/jira-mcp

Затем использовать "command": "jira-mcp" без args и без NPM_CONFIG_ALLOW_GIT. App is updated by re-running your command manually.

Related MCP server: JIRA MCP Server

На конфигурации

Все настройкий scroll through the environment. No config file is needed and does not need a server .SERVER does not appear in Doc . .env is not read — MCPлient transfer it in the env unit.

Найдите облачный идентификатор:

curl -s https://your-team.atlassian.net/_edge/tenant_info

How to keep token out of version control

Setup: script "keep MCP-config" cannot contain token in the clear itself. Claude Code getList with ${VAR} references in command, args, env, url and headers, therefore the config is a variable name and the value is elsewhere — in shell profile, or in a settings file that is not directly committed.

A reference that no one has completed is not an error: Claude Code passes the literal ${JIRA_API_TOKEN} to the server. This server initially rejects the value of this format and names the variable instead of sending it to Jira and returning 401.

Instruments

jira_create_issue

Creates the task in the project JIRA_PROJECT_KEY.

jira_create_subtask

Creates a subtask under the existing task.

jira_get_issue

Fetch name of issue, description, type, status, parent, subtasks, Issue links and fix versions.

| Parameter |Print | Required | Description | |-----------|---------| ----------| | issueKey| string | yes | Key of task, e.g. ABC-3316 | | transtrale| string[]| no | Additional field ids (e.g. customfield_15000) return in raw form under extra, keyed by field id |

jira_search_issues

Search for JQL, page.

pira_get_board

Displays the برd layout — columns, quick filters and swimlane — each solutionelons interface "with their JQL". Use it before jira_board_issues to search for the names you use. Board ID — this is the segment boards/<id> in the board URL.

Swimline obtained from GreenHopper’s 333rokashnogo API; Atlassian doesn't provide any supported endpoint for them.

jira_board_issues

It outputs current tasks on the board, and renders them by swimlane. It reproduces board view: board's own filter, its kanban sub‑ filter, any names of the quick filters and additional JQL.

Each task falls precisely one one in exactly one swimlane — the first one in queue, whose order is überein. Even if the subset of swimlanes is requested, the lanes above are still computing its considerations are maintained.

jira_list_transitions

Выводит transitions of workflow, to the task in which can be accessed now. Names passed at runtime, pre-process-specific issue — always call this method before using jira_transition_issue.

jira_transition_issue

Trannfers Task along workflow. Alignes transitionName / trying to optional.

jira_add_comment

Add a comment. Text uses wiki markup Jira (h3. for headings, {{code}} for inline code, {code:lang}…{code} for blocks, bq. for blockquotes). Use real newlines, not literal \n characters.

jira_add_attachment

Adds attachment / file. File should be in JIRA_ATTACHMENTS_DIR; reject file that goes beyond that folder.

Transport

stdio is used by default. --transport http --port 500 — serves the same instruments through a Streamable HTTP transport and path , /mcp, and has a /health check in the stream at /health.

Development

npm install
npm test          # vitest
npm run lint      # tsc --noEmit
npm run build     # webpack -> dist/bundle.js

Bundle dist/bundle.js committed and not claimed: installation is not required to build from Vulnerability. If the build introduces Changed, CI update it at each main commit, so it is cannot diverge from src/.

License

MITwars.