Skip to main content
Glama

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_BASE_URL

آدرس Jira (پیش‌فرض: https://jira.sisoog.com)

JIRA_USERNAME

نام کاربری Jira

JIRA_API_TOKEN

پسورد یا PAT

JIRA_AUTH_TYPE

basic (پیش‌فرض) یا bearer

نمونه: فایل .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

کار

jira_myself

تست لاگین و پروفایل کاربر

jira_my_open_issues

تسک‌های بازِ assign‌شده به من

jira_search

جستجو با JQL

jira_get_issue

جزئیات یک ایشو

jira_update_issue

آپدیت summary / description / labels / assignee

jira_add_comment

افزودن کامنت

jira_get_transitions

لیست انتقال وضعیت

jira_transition_issue

تغییر وضعیت

jira_add_worklog

ثبت زمان

jira_get_worklogs

لیست ورک‌لاگ‌ها

jira_update_worklog

ویرایش ورک‌لاگ

jira_delete_worklog

حذف ورک‌لاگ

نمونه 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 دیده نمی‌شود

مسیر dist/index.js و ری‌استارت Cursor را چک کنید

401 Unauthorized

یوزرنیم/پسورد یا PAT و JIRA_AUTH_TYPE را بررسی کنید

403 Forbidden روی worklog

دسترسی Log Work در Jira را چک کنید

ابزار جدید نیست

بعد از npm run build سرور MCP را Reload کنید

Available Tools

12 tools
jira_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_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

    A3.6/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      14
      19 npm
      6
      TypeScript
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A 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
      -