jira-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| JIRA_PAT | Yes | Personal Access Token for authentication (required) | |
| HTTP_PORT | No | Port for HTTP transport (optional, default 3000) | |
| JIRA_BASE_URL | Yes | Jira server base URL (required) | |
| MCP_AUTH_TOKEN | No | Bearer token for HTTP transport authentication (optional) | |
| JIRA_DEFAULT_PROJECT | No | Default project key (optional) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_current_userA | Lấy thông tin user Jira hiện tại (ứng với PAT đang dùng). Trả về username, display name, email, timezone. Dùng để: (1) verify PAT hợp lệ, (2) biết username để dùng trong JQL hoặc assigneeFilter, (3) xác nhận đúng account khi dùng multi-tenant. |
| list_issuesB | Lấy danh sách Jira issues theo filter linh hoạt. Mặc định: issues được assign cho tôi, đang mở. Có thể lọc theo user khác (assigneeFilter), role (assignee/reporter/watcher), trạng thái (statusFilter), hoặc JQL tùy chỉnh (customJql = full override). Trước đây có tên list_my_open_issues. |
| get_issue_detailA | Đọc toàn bộ thông tin chi tiết của 1 Jira issue: mô tả đầy đủ, comments, sub-tasks, priority, status hiện tại. Dùng trước khi phân tích hoặc implement một task cụ thể. |
| update_issueA | Cập nhật Jira issue: assign/unassign user, chuyển trạng thái, thêm comment, hoặc xem transitions khả dụng. Dùng dryRun=true để xem danh sách transitions mà không thay đổi gì. Truyền assignee để gán/gỡ người làm. Truyền dueDate để đổi/gỡ deadline ('clear' = gỡ). Truyền chỉ comment (không transitionName) để thêm ghi chú mà không đổi status. Truyền transitionName để chuyển trạng thái (kèm comment, resolution nếu cần). Có thể combine assignee + dueDate + transitionName + comment trong cùng 1 call. ⚠️ PHẢI hỏi user xác nhận TRƯỚC KHI thay đổi assignee, due date, status hoặc thêm comment. |
| create_issueA | Tạo một Jira issue mới (Task, Sub-task, Bug, Story). Dùng dryRun=true để xem metadata (custom fields, users, epics) — không tạo issue. Dùng khi phân rã một task lớn thành các sub-task nhỏ hơn, hoặc khi tạo task từ file mô tả nghiệp vụ .md. Nếu người dùng yêu cầu tạo task mới như 'tạo task mới cho tôi nhé', hãy yêu cầu họ cung cấp các thông tin dựa trên ví dụ sau:
|
| log_workA | Ghi nhận thời gian làm việc (logwork) lên một Jira issue. Dùng sau khi hoàn thành công việc để track effort. Ví dụ: đã làm 2 tiếng fix bug VNPTAI-456. ⚠️ PHẢI hỏi user xác nhận TRƯỚC KHI gọi tool này — không được tự động submit. Hiển thị nội dung sẽ log cho user review trước. |
| list_worklogsA | Truy vấn worklog của 1 user trong khoảng thời gian. Mặc định: current user, tháng hiện tại, summary aggregate theo issue. detail=true: show từng worklog entry với worklogId (dùng để lấy ID cho delete_worklog). Use case: 'tháng này tôi log bao nhiêu giờ', 'liệt kê chi tiết worklog tuần qua'. |
| delete_worklogA | Xoá 1 hoặc nhiều worklog trên 1 Jira issue. ⚠️ DESTRUCTIVE. BẮT BUỘC chạy dryRun=true trước, show preview cho user, đợi xác nhận rồi mới chạy dryRun=false. adjustEstimate=auto (Jira tự cộng giờ đã xoá vào remaining estimate). Chỉ xoá được worklog của chính mình (hoặc admin). Dùng list_worklogs với detail=true để lấy worklogId. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
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/hieutv-dng/jira-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server