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

تنظیمات

این متغیرهای محیطی لازم است:

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

نمونه 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 محلی یا متغیر محیطی سیستم بگذارید.

عیب‌یابی