jira-mcp-server

Jira MCP サーバー

Jira 用の MCP サーバーです。MCP 対応クライアントを Jira のプロジェクト、課題、スプリント、ボードに接続できます。

これは何ですか？

オープンソースのMCP（Model Context Protocol） サーバーです。AI アシスタントやエージェントから Jira インスタンスにフルアクセスできます。JQL での課題検索、チケットの作成・更新、スプリントやボードの管理、ワークフローを通じた課題のステータス遷移、関連作業のリンクなど、すべて自然言語で操作できます。

Claude Desktop、Cursor、Windsurf、Cline、Continue、またはその他の MCP 対応クライアントから使用でき、チャットを離れずにプロジェクトを管理できます。

選ばれる理由

• 組み込みツール14種類 — 検索、CRUD、ステータス遷移、コメント、プロジェクト、ボード、スプリント、バックログに対応
• JQLを全面サポート — Jira Query Language の任意の式で課題を検索
• ワークフローのステータス遷移 — 名前を指定して、課題をカスタムワークフロー内で移動
• スプリント管理 — スプリントの状態、ゴール、ボードのバックログを照会
• Jira Cloud に対応 — 任意の *.atlassian.net インスタンスに接続

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor / VS Code

MCP 設定に追加します。

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

手動での設定

npm install -g jira-mcp-server
export JIRA_HOST=your-domain.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your-api-token
jira-mcp-server

環境変数

変数	必須	説明
JIRA_HOST	はい	Jira のホスト名（例：your-domain.atlassian.net）
JIRA_API_TOKEN	はい	Jira API トークンまたはパーソナルアクセストークン
JIRA_EMAIL	条件付き	Jira のメールアドレス（Basic 認証で必須）
JIRA_AUTH_TYPE	いいえ	basic（デフォルト）または bearer（PAT 用）
JIRA_API_VERSION	いいえ	REST API のバージョン（デフォルト：3）

API トークンの取得方法

1. Atlassian API Tokens にアクセスします
2. Create API token をクリックします
3. 名前（例：「MCP Server」）を付けて、トークンをコピーします
4. Atlassian のメールアドレスを JIRA_EMAIL に設定します

ツール

ツール	説明
jira_search	JQL で課題を検索
jira_get_issue	課題の詳細をすべて取得
jira_create_issue	新しい課題を作成
jira_update_issue	課題のフィールドを更新
jira_transition_issue	課題を新しいステータスに遷移
jira_add_comment	課題にコメントを追加
jira_delete_issue	課題を削除（完全に削除されます）
jira_list_projects	アクセス可能なプロジェクトを一覧表示
jira_get_project	プロジェクトの詳細を取得
jira_get_issue_types	プロジェクトの課題タイプを一覧表示
jira_link_issues	2つの課題をリンク
jira_get_boards	Jira Software のボードを一覧表示
jira_get_sprints	ボードのスプリントを一覧表示
jira_get_backlog	ボードのバックログ項目を取得

使用例

JQL で課題を検索

{ "tool": "jira_search", "arguments": { "jql": "project = PROJ AND status = Open ORDER BY created DESC" } }

バグを作成

{
  "tool": "jira_create_issue",
  "arguments": {
    "projectKey": "PROJ",
    "summary": "Login page broken on mobile",
    "issueType": "Bug",
    "priority": "High",
    "labels": "mobile,urgent"
  }
}

課題のステータスを遷移

{ "tool": "jira_transition_issue", "arguments": { "issueKey": "PROJ-123", "transitionName": "In Progress" } }

スプリントのバックログを取得

{ "tool": "jira_get_backlog", "arguments": { "boardId": "42" } }

ユースケース

• プロジェクト管理 — 「モバイルプロジェクトの未解決のバグをすべて表示して」→ JQL を使って jira_search
• スプリント計画 — 「現在のスプリントには何がある？」→ jira_get_sprints + jira_get_backlog
• 課題のトリアージ — 「ログインのタイムアウトに関するバグを作成して」→ jira_create_issue
• ワークフローの自動化 — 「PROJ-456 をレビュー中に移動して」→ jira_transition_issue
• 複数プロジェクトの概要把握 — 「アクセス権のあるプロジェクトをすべて一覧表示して」→ jira_list_projects

API Coverage

Resource	Tools
Issues	jira_search, jira_get_issue, jira_create_issue, jira_update_issue, jira_transition_issue, jira_delete_issue
Comments	jira_add_comment
Projects	jira_list_projects, jira_get_project
Issue Types	jira_get_issue_types
Links	jira_link_issues
Boards	jira_get_boards
Sprints	jira_get_sprints
Backlog	jira_get_backlog

Development

git clone https://github.com/friendlygeorge/jira-mcp-server.git
cd jira-mcp-server
npm install
npm run build
npm start

License

MIT