jira-sisoog-mcp
Provides tools for interacting with Jira, enabling management of issues, worklogs, comments, transitions, and JQL searches on a Jira instance.
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., "@jira-sisoog-mcp Log 2 hours on APP-1851"
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-sisoog-mcp
MCP سرور برای Jira خودمیزبان (jira.sisoog.com) تا از داخل Cursor تسکها را مدیریت و worklog ثبت کنید.
پیشنیاز
Node.js 18+
دسترسی به Jira (یوزرنیم + پسورد یا Personal Access Token)
Related MCP server: JIRA MCP Server
نصب
cd E:/jira-mcp
npm install
npm run buildتنظیمات
این متغیرهای محیطی لازم است:
متغیر | توضیح |
| آدرس Jira (پیشفرض: |
| نام کاربری Jira |
| پسورد یا PAT |
|
|
نمونه: فایل .env.example را ببینید. برای Cursor، مقادیر را در کانفیگ MCP بگذارید (نه در گیت).
اگر Jira Data Center از Personal Access Token پشتیبانی میکند، همان را در JIRA_API_TOKEN بگذارید. برای PATهای Bearer مقدار JIRA_AUTH_TYPE=bearer را ست کنید؛ در غیر این صورت basic کافی است.
اتصال به Cursor
در %USERPROFILE%\.cursor\mcp.json:
{
"mcpServers": {
"jira-sisoog": {
"command": "node",
"args": ["E:/jira-mcp/dist/index.js"],
"env": {
"JIRA_BASE_URL": "https://jira.sisoog.com",
"JIRA_USERNAME": "YOUR_USER",
"JIRA_API_TOKEN": "YOUR_PASSWORD_OR_PAT",
"JIRA_AUTH_TYPE": "basic"
}
}
}
}بعد Cursor را ریاستارت کنید یا MCP را Reload کنید. نمونه کامل: mcp.cursor.example.json.
استفاده
در چت Cursor میتوانید بگویید:
تسکهای In Progress من را بیاور
جزئیات APP-1851 را نشان بده
۲ ساعت لاگ کار برای دیروز روی APP-1851 بزن
ورکلاگ ۲۱۸۰۷ را به ۱ دقیقه تغییر بده
APP-1851 را Done کن
روی APP-1851 کامنت بگذار: ...
نمونه پرامپت کوتاه:
تسکهای باز من رو لیست کن
روی APP-1851 برای سه روز پیش 2h لاگ بزن
همین لاگ رو ویرایش کن بکن 1m
APP-1851 رو Done کنابزارهای MCP
Tool | کار |
| تست لاگین و پروفایل کاربر |
| تسکهای بازِ assignشده به من |
| جستجو با JQL |
| جزئیات یک ایشو |
| آپدیت summary / description / labels / assignee |
| افزودن کامنت |
| لیست انتقال وضعیت |
| تغییر وضعیت |
| ثبت زمان |
| لیست ورکلاگها |
| ویرایش ورکلاگ |
| حذف ورکلاگ |
نمونه JQL
assignee = currentUser() AND status = "In Progress"
assignee = currentUser() AND resolution = Unresolved ORDER BY updated DESC
project = APP AND updated >= -7dفرمت زمان worklog
مثل Jira: 1h, 30m, 2h 15m, 1m
تاریخ شروع (اختیاری): ISO مثل 2026-08-08T10:00:00
توسعه
npm run dev # اجرای مستقیم با tsx
npm run build # کامپایل به dist/
npm start # اجرای distنکته امنیتی
رمز یا توکن را در گیت commit نکنید. فقط در mcp.json محلی یا متغیر محیطی سیستم بگذارید.
عیبیابی
مشکل | کار پیشنهادی |
MCP در Cursor دیده نمیشود | مسیر |
| یوزرنیم/پسورد یا PAT و |
| دسترسی Log Work در Jira را چک کنید |
ابزار جدید نیست | بعد از |
Available Tools
12 toolsjira_add_commentA
Add a comment to an issue.
Inputs: body (required), issueKey (required).
jira_add_worklogC
Log work on an issue. timeSpent uses Jira format like 1h, 30m, 2h 15m.
Inputs: issueKey (required), timeSpent (required), comment, started, +3 more.
jira_delete_worklogB
Delete a worklog from an issue.
Inputs: issueKey (required), worklogId (required).
jira_get_issueA
Get full details for a Jira issue by key (e.g. APP-1851).
Inputs: issueKey (required).
jira_get_transitionsA
List available status transitions for an issue.
Inputs: issueKey (required).
jira_get_worklogsB
List worklogs for an issue.
Inputs: issueKey (required).
jira_my_open_issuesB
Shortcut: list unresolved issues assigned to the current user.
Inputs: maxResults.
jira_myselfA
Verify Jira authentication and return the current user profile.
Inputs: no named parameters.
jira_searchA
Search Jira issues with JQL. Example: assignee = currentUser() AND resolution = Unresolved ORDER BY updated DESC
Inputs: jql (required), maxResults.
jira_transition_issueA
Transition an issue to another status using a transition id from jira_get_transitions.
Inputs: issueKey (required), transitionId (required).
jira_update_issueB
Update common issue fields (summary, description, labels, assignee username).
Inputs: issueKey (required), labels, summary, assignee, +1 more.
jira_update_worklogA
Update an existing worklog (timeSpent, started, comment). Prefer this over UpdateWorklog.jspa.
Inputs: issueKey (required), worklogId (required), comment, started, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool has a distinct resource and action: search vs. get issue vs. worklog operations vs. transitions vs. comments. The only potential overlap is jira_search and jira_my_open_issues, but the latter is clearly a shortcut for a specific filtered search, so ambiguity is minimal.
Most tools follow a consistent verb_noun pattern (jira_get_issue, jira_add_worklog, jira_update_issue). Two exceptions jira_myself and jira_my_open_issues break the pattern, but they are easy to understand and do not cause confusion.
With 12 tools covering issue retrieval, updates, worklogs, transitions, comments, and user info, the scope is well-sized for a Jira integration without being overwhelming.
The set covers read, update, transition, comment, and worklog operations, but notably lacks any way to create a new Jira issue. This is a significant gap for a Jira server, as issue creation is a core workflow that agents would likely need.
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personal…
MCP Server for JFrog, providing tools for development and artifact management.
One MCP server for all your work accounts: Slack, Teams, Google Chat, Jira, ClickUp, digest, tasks.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.-
- AlicenseBqualityDmaintenanceA Model Context Protocol server that integrates JIRA directly into Cursor IDE, allowing users to view assigned issues, get detailed information on specific tickets, and convert JIRA issues into local tasks without leaving their editor.1419 npm6TypeScriptMIT
- AlicenseNot gradedqualityDmaintenanceA simple MCP server that provides access to Jira issues from Cursor AI, allowing users to reference and query Jira tickets directly in the chat panel.18MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that provides tools for interacting with Jira. Enables Cursor and other MCP clients to fetch tickets, manage linked tickets, and update ticket status.3-