Jira MCP Server

Jira MCP Server とは？

Jira MCP Server（@aashari/mcp-server-atlassian-jira）は、任意の Jira REST API v3 エンドポイントを呼び出せる 5 つの汎用ツールで、Claude、Cursor などの MCP クライアントを Jira Cloud に接続するコミュニティ製の jira mcp server です。

aashari が開発したオープンソースの Node.js/TypeScript プロジェクトで、Atlassian の公式製品ではありません。自分の Atlassian メールアドレスと API トークンを使ってローカルで stdio 経由で動作し、AI アシスタントが JQL で課題を検索し、課題やコメントを読み、課題を作成・更新し、作業ログを記録し、ワークフローのトランジションを実行できるようにします。同じパッケージはコマンドラインツールとしても使えます。

Jira MCP Server の使い方

Node.js 18 以上と Jira Cloud サイト（your-company.atlassian.net）が必要です。Jira Server と Data Center には対応していません。

1. Atlassian API Tokens で API トークンを作成します。Create API token をクリックし、名前を付けて、すぐにトークンをコピーしてください。
2. 3 つの値を設定します。ATLASSIAN_SITE_NAME（サブドメイン。例：your-company）、ATLASSIAN_USER_EMAIL、ATLASSIAN_API_TOKEN です。
3. クライアントに接続する前に、ターミナルでテストします。

export ATLASSIAN_SITE_NAME="your-company"
export ATLASSIAN_USER_EMAIL="your.email@company.com"
export ATLASSIAN_API_TOKEN="your_api_token"

npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/search"

Claude Desktop

claude_desktop_config.json にサーバーを追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-jira"],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

Claude Code

Claude Code CLI で同じ stdio コマンドを登録します。

claude mcp add jira \
  -e ATLASSIAN_SITE_NAME=your-company \
  -e ATLASSIAN_USER_EMAIL=your.email@company.com \
  -e ATLASSIAN_API_TOKEN=your_api_token \
  -- npx -y @aashari/mcp-server-atlassian-jira

Cursor とその他のクライアント

stdio の MCP サーバーに対応したクライアントであれば、上の mcpServers ブロックをそのまま使えます（Cursor では MCP 設定ファイルに記述します）。npm install -g @aashari/mcp-server-atlassian-jira でグローバルにインストールすることもできます。

クライアントごとに認証情報を書く代わりに、~/.mcp/configs.json にまとめて保存することもできます。

{
  "jira": {
    "environments": {
      "ATLASSIAN_SITE_NAME": "your-company",
      "ATLASSIAN_USER_EMAIL": "your.email@company.com",
      "ATLASSIAN_API_TOKEN": "your_api_token"
    }
  }
}

キーは "jira" の代わりに "atlassian-jira"、"@aashari/mcp-server-atlassian-jira"、"mcp-server-atlassian-jira" も使えます。

Jira MCP Server の主な機能

• 5 つの汎用ツール（jira_get、jira_post、jira_put、jira_patch、jira_delete）で、固定された操作ではなく任意の Jira Cloud REST API v3 エンドポイントにアクセスできます。
• デフォルトの出力形式は TOON（Token-Oriented Object Notation）で、README によると JSON と比べてトークン使用量を 30〜60% 削減します。--output-format json または outputFormat: "json" で JSON も使えます。
• JMESPath フィルタ（--jq）で、key、summary、status など必要なフィールドだけを返せます。
• 約 40k 文字を超えるレスポンスは自動的に切り詰められ、完全な生レスポンスは /tmp/mcp/mcp-server-atlassian-jira/ に保存されます。
• すべての MCP ツールに対応する CLI（get、post、put、patch、delete）があり、スクリプトや簡単な確認に使えます。
• 自分の認証情報でローカル実行され、第三者のサービスを経由しません。
• DEBUG=true でデバッグログを有効にでき、ログは ~/.mcp/data/ に書き込まれます。

Jira MCP Server のツール

バージョン 3 では、以前のタスク別ツール（jira_ls_projects や jira_get_issue など）が、HTTP メソッドごとに 1 つのツールに置き換えられました。

• 読み取り： jira_get は、プロジェクト（/rest/api/3/project/search）、課題の詳細（/rest/api/3/issue/{key}）、JQL 検索（jql パラメータ付きの /rest/api/3/search/jql）、コメント、作業ログ、ステータス、課題タイプ、優先度、ユーザーをカバーします。
• 作成： jira_post で課題の作成（/rest/api/3/issue）、コメントや作業ログの追加、トランジションの実行を行います。
• 更新： jira_put はリソースを置き換え、jira_patch は課題フィールドなどを部分的に更新します。
• 削除： jira_delete でコメントや作業ログなどのリソースを削除します。

ツールが汎用的なので、アシスタントは正しい API パスを知っている必要があります。README には主なパスが掲載されており、/rest/api/3/search は非推奨で /rest/api/3/search/jql を使うよう記載されています。

Jira MCP Server のユースケース

• スタンドアップの準備： "Show me details about PROJ-123 including comments."
• 自分のタスク整理： "List all high priority issues assigned to me that are in progress."
• JQL によるプロジェクト横断検索： "Find all bugs in progress across my projects."
• エディタからの課題作成： 失敗しているコードを見ながら "Create a new bug in the MOBILE project" と依頼します。
• 進捗の共有： "Add a comment to PROJ-456: 'Code review completed, ready for testing.'"
• 作業時間とワークフロー： Jira を開かずに作業ログを記録したり、課題を次のトランジションに進めたりできます。

Jira MCP Server と代替ツールの比較

• Atlassian Rovo MCP Server（公式）： Atlassian が自らホストするリモートサーバーで、Jira、Confluence、その他の Atlassian Cloud アプリに対応し、OAuth 2.1 または API トークンでサインインします。ベンダーがサポートするホスト型を求める場合はこちらを選んでください。Atlassian Rovo MCP ドキュメントを参照してください。
• Atlassian MCP Server (Jira & Confluence)： Jira と Confluence の両方を扱い、それぞれに専用ツールを持つコミュニティ製サーバーです。
• この Jira MCP サーバー： 小さく、ローカルで動く Jira 専用の atlassian jira mcp です。5 つの汎用ツールでツール一覧を短く保ちつつ REST API 全体にアクセスできますが、どのエンドポイントを呼ぶかをモデルが知っている必要があります。

Jira MCP Server のトラブルシューティング

• "Authentication failed" または 403 Forbidden： API トークンが有効か、ATLASSIAN_SITE_NAME がサブドメインのみ（完全な URL ではなく mycompany）になっているかを確認します。npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/myself" でテストできます。
• 404 / リソースが見つからない： API パスは大文字と小文字を区別します。プロジェクト名ではなくプロジェクトキー（DEV）を、課題は完全なキー（DEV-123）を使ってください。ブラウザでそのプロジェクトを開けるかも確認します。
• 検索結果が空： まず Jira の高度な検索で JQL を検証し、非推奨の /rest/api/3/search ではなく /rest/api/3/search/jql を使います。
• Claude Desktop にサーバーが表示されない： 設定ファイルを編集した後に Claude Desktop を再起動し、OS に対応した正しい設定ファイルを編集したか確認します。
• レスポンスが途中で切れる： 大きなペイロードは仕様で切り詰められます。--jq や JQL でリクエストを絞り込むか、/tmp/mcp/mcp-server-atlassian-jira/ に保存された生ファイルを参照してください。