Which integrations are available for this server?

Provides tools for interacting with Jira Cloud, enabling AI agents to manage issues (create, read, update, delete), comments, workflows, projects, sprints, boards, and users through the Jira REST API. Extends Jira integration with features specific to Jira Software, such as managing sprints and boards, leveraging JQL for issue search, and supporting workflow transitions.

How do I use jira-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@jira-mcp find issues in progress assigned to me" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

jira-mcp

by rifujin123

Overview Schema Related Servers Score Discussions

Python

Remote

🚀 Jira MCP Server

Jira MCP Server là cầu nối giữa AI (Claude, Claude Code, Cursor, v.v.) và Jira Cloud của bạn. Thay vì phải vào web Jira để tạo issue, tìm kiếm, hay cập nhật trạng thái — bạn chỉ cần nói hoặc gõ lệnh, AI sẽ làm thay bạn.

Ví dụ:

"Tạo issue bug cho project DEV, mô tả lỗi login bị 500"
"Tìm tất cả issues đang In Progress được gán cho tôi"
"Chuyển issue DEV-123 sang Done"

✨ Tính năng

📋 Quản lý Issue

Bạn nói	Server làm
"Tạo issue mới"	Tạo issue với project, summary, type, priority, labels, assignee
"Xem issue DEV-123"	Lấy chi tiết issue (status, assignee, description, v.v.)
"Sửa issue DEV-123"	Cập nhật summary, description, priority, labels, assignee
"Xoá issue DEV-123"	Archive (soft-delete) issue vào thùng rác
"Tìm issue bị lỗi"	Search bằng JQL — mạnh mẽ, linh hoạt

💬 Comments

Bạn nói	Server làm
"Thêm comment vào DEV-123"	Ghi comment vào issue
"Xem comments của DEV-123"	Liệt kẻ tất cả comments

🔄 Workflow

Bạn nói	Server làm
"DEV-123 đang ở trạng thái gì?"	Liệt kẻ các transition có thể chuyển
"Chuyển DEV-123 sang In Progress"	Thực hiện chuyển trạng thái workflow

📂 Projects

Bạn nói	Server làm
"Liệt kê tất cả projects"	Danh sách projects + lead + loại
"Xem project DEV"	Thông tin chi tiết project

🏃 Sprint & Board

Bạn nói	Server làm
"Board nào đang có?"	Danh sách Scrum/Kanban boards
"Sprint đang active?"	Sprint hiện tại của board
"Issues trong sprint 5?"	Tất cả issues trong sprint (dùng JQL)

⚠️ Yêu cầu Jira Software license. Free plan không support — server sẽ báo rõ.

👤 Users

Bạn nói	Server làm
"Tìm user tên An"	Search users theo tên, email, account ID

Related MCP server: JIRA MCP Server

🛠️ Cài đặt

Yêu cầu

Python 3.10+
Tài khoản Jira Cloud (free cũng được)
Jira API Token

Các bước

# 1. Vào thư mục project
cd D:/GITHUB/Jira-mcp

# 2. Tạo môi trường ảo (recommended)
python -m venv .venv

# 3. Kích hoạt
# Windows:
.venv\Scripts\activate
# Mac / Linux:
# source .venv/bin/activate

# 4. Cài thư viện
pip install -r requirements.txt

# 5. Tạo file .env từ mẫu
cp .env.example .env

Lấy Jira API Token

Vào https://id.atlassian.com/manage/api-tokens
Click Create API token
Đặt tên, ví dụ "Jira MCP"
Copy token vừa tạo

Điền credentials

Sửa file .env:

# Domain Jira Cloud của bạn
JIRA_URL=https=//tên-domain.atlassian.net

# Email đăng nhập Jira
JIRA_EMAIL=email-của-bạn@gmail.com

# API Token vừa tạo ở trên
JIRA_API_TOKEN=your-api-token-dai-loan

🚀 Chạy & Sử dụng

1. Kiểm tra kết nối (smoke test)

# Windows:
PYTHONIOENCODING=utf-8 .venv\Scripts\python jira_client.py

# Mac/Linux:
# python jira_client.py

Nếu thành công → hiện danh sách projects.

2. Chạy MCP Server

python server.py

Server ở chế độ stdio — chờ nhận lệnh JSON-RPC từ stdin. Trông như "treo" — đó là bình thường.

3. Kết nối với Claude Code

Nếu bạn đang mở Claude Code trong thư mục này, tự động detect. Nếu không, thêm vào config:

Windows — file %APPDATA%\Claude Code\settings.json:

{
  "mcpServers": {
    "jira": {
      "command": "python",
      "args": ["D:/GITHUB/Jira-mcp/server.py"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Hoặc nếu dùng uv (nhanh hơn) — không cần cài thủ công:

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp",
        "--with", "atlassian-python-api",
        "--with", "python-dotenv",
        "--directory", "D:/GITHUB/Jira-mcp",
        "python", "D:/GITHUB/Jira-mcp/server.py"
      ]
    }
  }
}

4. Kết nối với Claude Desktop

File config: claude_desktop_config.json

Vị trí:

Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

5. Test với MCP Inspector (Web UI)

# Nếu chưa có
pip install "mcp[cli]"

# Mở inspector
mcp dev server.py

Mở browser: http=//localhost=5173 → test từng tool trực quan.

📚 Danh sách Tools đầy đủ

Issue

Tool	Tham số chính	Mô tả
`create_issue`	`project_key`, `summary`, `issue_type`, `description?`, `priority?`, `labels?`, `assignee?`	Tạo issue mới
`get_issue`	`issue_key`	Xem chi tiết issue
`update_issue`	`issue_key`, `summary?`, `description?`, `priority?`, `labels?`, `assignee?`	Sửa thông tin issue
`delete_issue`	`issue_key`	Archive issue (soft-delete)
`search_issues`	`jql`, `max_results?`	Tìm kiếm bằng JQL

Comment

Tool	Tham số chính	Mô tả
`add_comment`	`issue_key`, `comment`	Thêm comment
`get_comments`	`issue_key`	Xem tất cả comments

Workflow

Tool	Tham số chính	Mô tả
`get_transitions`	`issue_key`	Xem các trạng thái có thể chuyển
`transition_issue`	`issue_key`, `transition_name_or_id`	Chuyển trạng thái (VD: "Done")

Project

Tool	Tham số chính	Mô tả
`list_projects`	—	Danh sách projects
`get_project`	`project_key`	Chi tiết project

Board & Sprint

Tool	Tham số chính	Mô tả
`list_boards`	`project_key?`	Danh sách boards
`list_sprints`	`board_id`, `state?`	Danh sách sprints
`get_active_sprint`	`board_id`	Sprint đang active
`get_sprint_issues`	`sprint_id`	Issues trong sprint

User

Tool	Tham số chính	Mô tả
`search_users`	`query`, `max_results?`	Tìm kiếm người dùng

🔧 JQL Examples

// Tất cả issues của project DEV
project = DEV

// Issues đang In Progress, gán cho tôi
assignee = currentUser() AND status = "In Progress"

// Tìm theo từ khoá
text ~ "database error"

// Issues được tạo trong 7 ngày gần đây
created >= -7d

// Priority cao nhất, sắp xếp theo thời gian tạo
project = DEV ORDER BY priority DESC, created ASC

// Issues trong sprint cụ thể
sprint = 5

// Bugs chưa được assign
issuetype = Bug AND assignee IS NULL

⚠️ Lỗi thường gặp

Lỗi	Nguyên nhân	Cách fix
"Authentication failed"	Sai email hoặc API token	Kiểm tra lại `.env`
"Permission denied"	Tài khoản không có quyền	Kiểm tra role trong Jira
"Resource not found"	Sai issue key, project key	Kiểm tra lại key
"Site temporarily unavailable"	Jira site chưa active	Vào browser xem site có mở được không
"Rate limit exceeded"	Gọi API quá nhanh (~100 req/phút)	Chờ 1 lúc rồi thử lại
Board/sprint lỗi	Free plan không có Jira Software	Nâng cấp plan hoặc bỏ qua tính năng này

📁 Cấu trúc project

D:/GITHUB/Jira-mcp/
├── server.py          # ★ File chính — MCP server, tất cả tools
├── jira_client.py     # Lớp JiraClient — gọi Jira API, xử lý lỗi, format dữ liệu
├── requirements.txt   # Thư viện cần cài
├── .env               # Credentials Jira của bạn (đã có .gitignore)
├── .env.example       # Mẫu file .env
├── .gitignore         # Bỏ qua .env, __pycache__, .venv
└── README.md          # Bạn đang đọc đây

File server.py = tất cả tools (decorator @mcp.tool()). File jira_client.py = logic gọi Jira API + format + xử lý lỗi.

🧠 Kiến trúc

Bạn ── nói ──► Claude ── JSON-RPC ──► Jira MCP Server ── HTTP ──► Jira Cloud API
                                        │
                                        ▼
                                16 tools sẵn sàng

Transport: stdio (process-to-process)
Protocol: MCP (Model Context Protocol) — chuẩn của Anthropic
Library: atlassian-python-api gọi Jira REST API /api/3
Error handling: 3 lớp — HTTP → JiraError → "Error: ..." string
Sprint: Dùng JQL fallback (sprint = N) — không cần Agile REST API

📝 Ghi chú

Issue description hỗ trợ Markdown lẫn Atlassian Document Format (ADF) — tự động detect
Assignee có thể nhập email, display name, hoặc account ID — tự động resolve
Soft-delete = archive (có thể khôi phục), không hard-delete
Max results search: 200. User search: 50
Rate limit Jira Cloud: ~100 requests/phút

📄 License

MIT — tự do dùng, sửa, chia sẻ.

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rifujin123/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server