Jira MCP

Локальный MCP-сервер для Jira Server/Data Center. Дает Claude и Codex доступ к задачам, комментариям, переходам, worklog и связям между задачами.

Сервер работает через Jira REST API v2 и Basic Auth. Токен не нужен.

Установка

git clone <URL_РЕПОЗИТОРИЯ> jira-mcp
cd jira-mcp

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp config.example.py config.py
chmod 600 config.py

Заполните config.py:

JIRA_URL = "http://jira.company.local:8080"
JIRA_USER = "firstname.lastname"
JIRA_PASSWORD = "your-password"

config.py находится в .gitignore. Не коммитьте его.

Проверка:

.venv/bin/python -m unittest -v

Команды ниже приведены для Linux/macOS. На Windows используйте .venv\Scripts\python.exe и абсолютные пути.

Related MCP server: jira-mcp

Claude Code

Запустите из каталога jira-mcp:

MCP_DIR="$(pwd)"

claude mcp add \
  --transport stdio \
  --scope user \
  jira -- \
  "$MCP_DIR/.venv/bin/python" \
  "$MCP_DIR/main.py"

Проверка:

claude mcp get jira
claude mcp list

В новой сессии Claude Code выполните /mcp.

Claude Desktop

Откройте Settings → Developer → Edit Config и добавьте сервер:

{
  "mcpServers": {
    "jira": {
      "command": "/ABSOLUTE/PATH/jira-mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/jira-mcp/main.py"
      ]
    }
  }
}

Если в файле уже есть другие серверы, добавьте только секцию jira, не перезаписывая остальную конфигурацию. После изменения полностью перезапустите Claude Desktop.

Codex CLI

Запустите из каталога jira-mcp:

MCP_DIR="$(pwd)"

codex mcp add jira -- \
  "$MCP_DIR/.venv/bin/python" \
  "$MCP_DIR/main.py"

Проверка:

codex mcp get jira
codex mcp list

В новой сессии Codex выполните /mcp.

Codex Desktop

Codex Desktop, Codex CLI и IDE-расширение используют общий ~/.codex/config.toml. Если сервер уже добавлен через codex mcp add, повторная настройка не нужна: перезапустите приложение.

Также сервер можно добавить через Settings → MCP servers → Add server:

• Name: jira

• Type: STDIO

• Command: абсолютный путь к .venv/bin/python

• Args: абсолютный путь к main.py

Ручная конфигурация выглядит так:

[mcp_servers.jira]
command = "/ABSOLUTE/PATH/jira-mcp/.venv/bin/python"
args = ["/ABSOLUTE/PATH/jira-mcp/main.py"]

Проверка Jira

После подключения попросите агента:

Покажи текущего пользователя Jira и доступные проекты.

Если MCP подключен, но Jira не отвечает, проверьте:

• доступ к внутренней сети или VPN;

• JIRA_URL, логин и пароль в config.py;

• права пользователя в нужном проекте;

• статус сервера через /mcp.

Инструменты

Чтение:

• get_myself

• list_projects

• get_ticket

• search_tickets

• get_project_issue_types

• get_create_fields

• find_users

• list_transitions

• get_link_types

• get_remote_links

Изменения:

• create_ticket

• update_ticket

• assign_ticket

• add_comment

• change_status

• add_worklog

• link_tickets

Перед созданием задачи или сменой статуса агент должен сначала проверить доступные типы, поля и переходы.

Обновление

git pull
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m unittest -v

Повторно добавлять MCP не нужно, пока путь к каталогу не изменился.

Развитие

Первое запланированное расширение — связь GitHub-коммитов и pull request с задачами Jira. Решение и порядок внедрения описаны в docs/github-jira-integration.md.

Документация по клиентам:

• Claude Code MCP

• Codex MCP