Jira Cloud

السجل الرسمي أدوات المطورين

MCP server for Jira Cloud — manage issues, sprints, boards, filters, and custom fields

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @aaronsb/jira-cloud-mcp
Claude Code
claude mcp add jira-cloud -e 'JIRA_API_TOKEN=<your jira_api_token>' -e 'JIRA_EMAIL=<JIRA_EMAIL>' -e 'JIRA_HOST=<JIRA_HOST>' -- npx -y @aaronsb/jira-cloud-mcp@0.11.3
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "jira-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "@aaronsb/jira-cloud-mcp@0.11.3"
            ],
            "env": {
                "JIRA_API_TOKEN": "<your jira_api_token>",
                "JIRA_EMAIL": "<JIRA_EMAIL>",
                "JIRA_HOST": "<JIRA_HOST>"
            }
        }
    }
}

متغيرات البيئة

  • JIRA_API_TOKEN إلزامي سري Jira API token (generate at https://id.atlassian.com/manage/api-tokens)
  • JIRA_EMAIL إلزامي Atlassian account email address
  • JIRA_HOST إلزامي Jira instance URL (e.g., https://your-team.atlassian.net)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Jira Cloud MCP Server
  2. Install
  3. Tools
  4. MCP Resources
  5. License

Jira Cloud MCP Server

A Model Context Protocol server for interacting with Jira Cloud instances.

Install

Claude Desktop (one-click)

Download jira-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Jira credentials.

Claude Code
claude mcp add jira-cloud -e JIRA_API_TOKEN=your-token -e JIRA_EMAIL=your-email -e JIRA_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/jira-cloud-mcp
Manual (any MCP client)
{
  "mcpServers": {
    "jira-cloud": {
      "command": "npx",
      "args": ["-y", "@aaronsb/jira-cloud-mcp"],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email",
        "JIRA_HOST": "https://your-team.atlassian.net"
      }
    }
  }
}
Credentials

Generate an API token at Atlassian Account Settings.

Tools

ToolDescription
manage_jira_issueGet, create, update, delete, move, transition, comment on, link, or traverse hierarchy of issues
manage_jira_filterSearch for issues using JQL queries, or manage saved filters
manage_jira_projectList projects or get project configuration and metadata
manage_jira_boardList boards or get board details and configuration
manage_jira_sprintManage sprints: create, start, close, and assign issues to sprints
queue_jira_operationsBatch multiple operations with result references ($0.key) and error strategies
analyze_jira_issuesCompute metrics, exact counts, and data cube analysis over issues selected by JQL

Each tool accepts an operation parameter (except queue_jira_operations which takes an operations array, and analyze_jira_issues which takes jql + metrics). Per-tool documentation is available as MCP resources at jira://tools/{tool_name}/documentation.

See docs/tools.md for detailed tool descriptions, workspace patterns, and design principles.

MCP Resources

ResourceDescription
jira://instance/summaryInstance-level statistics
jira://projects/distributionProject distribution overview
jira://projects/{key}/overviewProject overview with status counts
jira://boards/{id}/overviewBoard overview with sprint info
jira://issue-link-typesAvailable issue link types
jira://custom-fieldsCustom field catalog (auto-discovered at startup)
jira://custom-fields/{project}/{issueType}Context-specific custom fields
jira://analysis/recipesAnalysis query patterns and compute DSL reference
jira://tools/{name}/documentationPer-tool documentation

License

MIT License

الأسئلة الشائعة

ما هو Jira Cloud؟

MCP server for Jira Cloud — manage issues, sprints, boards, filters, and custom fields

كيف أثبّت Jira Cloud؟

يعمل على جهازك. في Claude Code: claude mcp add jira-cloud -e 'JIRA_API_TOKEN=<your jira_api_token>' -e 'JIRA_EMAIL=<JIRA_EMAIL>' -e 'JIRA_HOST=<JIRA_HOST>' -- npx -y @aaronsb/jira-cloud-mcp@0.11.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Jira Cloud إلى مفتاح API؟

نعم. يتطلب JIRA_API_TOKEN, JIRA_EMAIL, JIRA_HOST، وتضبطها في إعداداته.

هل Jira Cloud مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Jira Cloud؟

ينشره aaronsb. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.