mcp-tms-jira
Provides tools for interacting with Confluence, enabling management of pages, spaces, and other content through the Confluence API.
Provides tools for interacting with Jira Server/Data Center, including managing issues, transitions, comments, worklogs, links, and sprints. Supports authentication via Chrome cookies for environments where Personal Access Tokens are disabled.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-tms-jirashow me my open Jira issues 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.
mcp-tms-jira
Bản fork của mcp-atlassian (tác giả sooperset, giấy phép MIT,
lấy từ commit 0a5d242, sau v0.23.1). Bản fork thêm một kiểu xác thực chrome_cookie cho Jira Server/Data
Center: MCP dùng lại phiên đăng nhập đang có trong Chrome, không cần token. Kiểu này dành cho các Jira mà admin
đã chặn Personal Access Token và chỉ cho đăng nhập qua trình duyệt (SSO, F5…), ví dụ Jira VinFast TMS.
Các kiểu xác thực gốc (basic, PAT, OAuth, mTLS, external) và toàn bộ tool Jira/Confluence vẫn giữ nguyên. README gốc ở README.upstream.md, giấy phép ở LICENSE.
Cài
Cần Linux, uv và Chrome đã đăng nhập vào Jira.
git clone https://github.com/hotamago/mcp-tms-jira.git && cd mcp-tms-jira
uv sync
ln -sf "$PWD/bin/mcp-tms-jira" ~/.local/bin/mcp-tms-jira
claude mcp add --scope user tms-jira -- ~/.local/bin/mcp-tms-jiraSau đó reload MCP trong Claude Code (/mcp) hoặc mở lại phiên. Kiểm tra bằng claude mcp get tms-jira, kết quả
phải là ✔ Connected.
Launcher bin/mcp-tms-jira đặt sẵn JIRA_URL=https://tms.vinfast.vn, JIRA_AUTH_TYPE=chrome_cookie,
CHROME_PROFILE=auto và TOOLSETS=all. Muốn dùng cho Jira khác thì truyền biến môi trường để ghi đè, ví dụ
claude mcp add --scope user my-jira -e JIRA_URL=https://jira.example.com -- ~/.local/bin/mcp-tms-jira.
Related MCP server: jira-mcp
Cấu hình (biến môi trường)
Biến | Mặc định | Ý nghĩa |
| (bắt buộc; launcher đặt TMS) | Gốc Jira, ví dụ |
| (tự dò như bản gốc) | Đặt |
|
|
|
|
|
|
| tự dò | Thư mục user-data của trình duyệt |
|
| Số giây giữ cookie trong bộ nhớ |
|
| Nhóm tool được bật, giống bản gốc |
|
|
|
| trống | Không đặt thì Confluence tắt |
| (có sẵn) | Ghi đè phần hướng dẫn server gửi cho client |
Các biến khác (JIRA_TIMEOUT, JIRA_SSL_VERIFY, proxy, JIRA_PROJECTS_FILTER…) dùng như bản gốc.
Cách chrome_cookie hoạt động
Mỗi request tới đúng scheme/host/port của
JIRA_URLđược gắn cookie Chrome của host đó (JSESSIONID,atlassian.xsrf.token, cookie F5…), kèm headerX-Atlassian-Token: no-check. Cookie được giữ trong bộ nhớCHROME_COOKIE_TTLgiây.Gặp 401/403, phản hồi
anonymous, hoặc trang HTML trả về cho lời gọi/rest/: MCP đọc lại cookie từ Chrome và gửi lại một lần. Vẫn lỗi thì báo "Open in Chrome, log in again". Nếu 403 vẫn còn sau lần đọc lại cookie thì đó là thiếu quyền thật, MCP trả lỗi như bản gốc.Không gửi cookie tới host khác. Bị chuyển hướng sang host khác hoặc sang trang đăng nhập thì dừng lại và báo lỗi đăng nhập.
Cookie đọc từ DB của Chrome: chép DB vào thư mục tạm quyền 0700 rồi xoá ngay. Khoá
v11lấy từ GNOME Keyring/libsecret. Giá trị cookie không bao giờ được ghi log hay in ra.
Ghi lên Jira
Tool ghi (tạo, sửa, chuyển trạng thái, comment, worklog, link, sprint…) vẫn có. Phần hướng dẫn server gửi cho
client nhắc rằng mọi thao tác ghi phải được người dùng duyệt nguyên văn trước. Muốn chặn hẳn thì đặt
READ_ONLY_MODE=true.
Giới hạn
Chỉ chạy trên Linux, trong phiên desktop có D-Bus và GNOME Keyring đã mở khoá. Launcher tự đặt
DBUS_SESSION_BUS_ADDRESSnếu MCP host không truyền biến này.Cookie hết hạn thì mở
JIRA_URLtrên Chrome, đăng nhập lại, rồi gọi lại tool.Trên Jira Server/DC, hai tool chỉ dành cho Cloud (
jira_move_issue,jira_batch_get_changelogs) bị ẩn, giống bản gốc. Một số tool khác (ProForma forms, dev-status…) tuỳ plugin trên server có thể báo lỗi.Bản fork bỏ
.github/của upstream (CI, publish), nên testtests/unit/test_docker_versioning.pycũng bị bỏ.
Test
uv sync
uv run pytest tests/unit -q # toàn bộ unit test (giả HTTP, không cần mạng)
uv run pytest tests/unit/utils/test_cookie_auth.py -q # riêng phần chrome_cookieEnglish summary
Fork of sooperset/mcp-atlassian (MIT, based on commit 0a5d242). It
adds a chrome_cookie auth type for Jira Server/Data Center. With it, the server reuses the Chrome login session of
the local user instead of a token, which helps when Personal Access Tokens are disabled. All upstream auth types and
tools are kept.
Install:
uv sync, symlinkbin/mcp-tms-jirainto~/.local/bin, then runclaude mcp add --scope user tms-jira -- ~/.local/bin/mcp-tms-jira.Configure:
JIRA_URLJIRA_AUTH_TYPE=chrome_cookieoptional:
CHROME_BROWSER,CHROME_PROFILE(auto),CHROME_USER_DATA_DIR,CHROME_COOKIE_TTL(60 s)TOOLSETS=allREAD_ONLY_MODE=trueto disable writes
Behaviour:
Cookies are attached only to the
JIRA_URLorigin, together withX-Atlassian-Token: no-check.On 401/403, an anonymous reply, or an HTML reply to a
/rest/call, cookies are re-read once.Cross-host redirects and login-page redirects are refused.
Cookie values are never logged.
Write policy: the server instructions tell the client that every write must be approved verbatim by the user first.
Limitations:
Linux only, with a D-Bus session and an unlocked GNOME Keyring.
When the session expires, log in again in Chrome.
This server cannot be deployed
Maintenance
Related MCP Connectors
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Read and write shared BitsWeave context, projects, tasks, and work sessions through MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that enables accessing Jira and Confluence using browser cookies captured via a Chrome extension, avoiding the need for API tokens or browser automation. It wraps the mcp-atlassian toolset and works with Atlassian Cloud and Server/Data Center behind SSO.1GPL 3.0
- AlicenseNot gradedqualityCmaintenanceJira Cloud MCP server providing Jira-first tools for common workflows and full REST API coverage through a generic request tool.380 npmMIT
- FlicenseAqualityBmaintenanceA read-only MCP server for Jira and Confluence Cloud, providing atlassian_get and jira_search tools.211 npm-
- AlicenseNot gradedqualityCmaintenanceEnables read-only querying of Jira Server/Data Center projects, issues, comments, transitions, and issue types through MCP tools.380 npmMIT