Jira Service Management MCP

Jira Service Management + AI — ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。Jira Service Management API 向けにコミュニティが構築した Claude Code Skill および MCP サーバーです。Atlassian Pty Ltd との提携、承認、またはスポンサー関係はありません。

_{▶ 30 秒のデモを見る — デモデータはシミュレーションですが、表示されるすべてのコマンドは実際の CLI に存在します。}

Jira Service Management Cloud のすべてのリクエスト API（servicedeskapi）と Assets エンドポイントを 1 つのバイナリにまとめ、キュー全体の SLA 違反ランキング、非公開のまま保たれる内部メモ、チケットのタイムライン、Assets（CMDB）とチケットの結合にも対応しています。すでにお使いの AI で利用できます。ChatGPT（Plus/Pro+）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに加え、リモート経由でMicrosoft 365 Copilot / Copilot StudioおよびGoogle Geminiにも対応しています。無料のオープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されており、コードは不要です。

お使いのエージェントで利用できます

MSP オーナーが実際に使用している 6 つのエージェントに対応しています（セルフサービスで、今すぐ利用できます）。

お使いの AI エージェント	Jira Service Management スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で jira-service-management-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、jira-service-management-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Codex CLI	以下のインストールプロンプトを貼り付けます。
Claude Code	以下のインストールプロンプトを貼り付けます。
Claude Cowork	以下のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に jira-service-management-mcp を追加してから、Agent モードを選択します。

ChatGPT では、JIRA_SERVICE_MANAGEMENT_MCP_HTTP_TOKEN にベアラートークンを設定し、jira-service-management-mcp --transport http を実行して、HTTPS の背後で公開します。ブリッジパッケージは不要です。mcp-install.md を参照してください。

Microsoft と Google のスタックにも対応

大規模なインストールベースを持つ一方で、率直にお伝えすると、これらは今インストールしたローカルバイナリではなく、リモート／エンタープライズ向けの方法です。

エージェント	必要なこと
Microsoft 365 Copilot / Copilot Studio	セルフサービスでは利用できません。 jira-service-management-mcp を HTTPS 経由でホストし、Copilot Studio（Tools > Add a tool > Model Context Protocol > Server URL）または宣言型エージェントに接続します。Copilot Studio のライセンスとテナント管理者権限が必要です。mcp-install.md を参照してください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作し、ChatGPT と同じ HTTPS の方法を使用します。mcp-install.md を参照してください。

スキルを直接扱えるエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。インストール方法は以下の各セクションを参照してください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed にも対応しています。ツールごとの詳しい接続方法については、docs/which-agent.md を参照してください。

複数のエージェントを使っていますか？ 1 つのコマンドで、対応する 51 以上のすべてのエージェントにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。続けて、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md を参照してください。

60 秒でインストール

Claude Desktop で最速の方法 - ワンクリック .mcpb

Jira Service Management MCP（.mcpb）をダウンロード - 次に Claude Desktop > Settings > Extensions を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（Jira Service Management のすべてのリリースはリリースページでご覧いただけます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください。ディレクトリ一覧は不要で、すぐに利用できます。

/plugin marketplace add Servosity/msp-skills
/plugin install jira-service-management@msp-skills

方法 A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーします。

このエージェントのワークスペースに Servosity/msp-skills から Jira Service Management Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使用している場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jira-service-management/install.sh) を実行してください。Windows PowerShell を使用している場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jira-service-management/install.ps1 | iex を実行してください。その後、README に従って認証し、jira-service-management-cli --help を実行して確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使用できます。

方法 B - インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jira-service-management/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jira-service-management/install.sh)

インストーラーは、jira-service-management-cli（CLI）と jira-service-management-mcp（MCP サーバー）の両方をユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を通じて Skill を検出します。

確認：

jira-service-management-cli --version

最新バージョンへのアップグレード

インストーラーは常に最新リリースを取得します。アップグレードするには、再度実行してください。

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jira-service-management/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/jira-service-management/install.ps1 | iex

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update jira-service-management@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、または別の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法について mcp-install.md と docs/which-agent.md を参照してください。各エージェント向けのセクションがあり、GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot / Copilot Studio への接続方法も記載されています。最も簡単なのは Claude Desktop の Settings > Extensions パネルを使う方法です。MCP 設定ブロック（JSON を編集したい方向け）は mcp-install.md に記載されています。

Hermes 用にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/jira-service-management --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/jira-service-management --force

Hermes は MCP にネイティブ対応しているため、jira-service-management-mcp サーバーを直接使用することもできます。インストール方法も環境変数も同じです。

OpenClaw 用にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

https://github.com/servosity/msp-skills/tree/main/skills/jira-service-management から jira-service-management スキルをインストールしてください。このスキルには、必要な CLI（jira-service-management-cli）を openclaw: frontmatter ブロックでインストールする方法が定義されています。

OpenClaw はまだ一般公開されていません。frontmatter による接続設定はあらかじめ組み込まれており、OpenClaw のリリースと同時に有効になります。

認証

JSM サイトにエージェントとしてサインインし、id.atlassian.com/manage-profile/security/api-tokens で Atlassian API トークンを作成します。次に、サイトのサブドメイン（acme.atlassian.net の場合は acme）、Atlassian のメールアドレス、トークンの3つの変数を設定します。

macOS / Linux:

export JIRA_SERVICE_MANAGEMENT_SITE=acme
export [email protected]
export JIRA_SERVICE_MANAGEMENT_API_TOKEN=<api-token>
jira-service-management-cli doctor

Windows (PowerShell):

$env:JIRA_SERVICE_MANAGEMENT_SITE = "acme"
$env:JIRA_SERVICE_MANAGEMENT_EMAIL = "[email protected]"
$env:JIRA_SERVICE_MANAGEMENT_API_TOKEN = "<api-token>"
jira-service-management-cli doctor

Assets（CMDB）コマンドでは、サイトの cloudId と Assets workspaceId も必要です（Assets は JSM Premium と Enterprise に含まれています）。jira-service-management-cli cmdb discover --save をクライアントサイトごとに一度実行すると、両方を調べて、そのサイトの設定ファイルに保存できます。保存された ID は、見つかったサイトでのみ有効です。安全策として、Assets の各呼び出しは cloudId が現在のサイトのもの（サイトの公開 tenant_info に対して実行ごとに一度確認）であり、workspaceId がサイトに登録されているもののいずれかでない限り拒否されます。そのため、別のクライアントの JIRA_SERVICE_MANAGEMENT_CLOUD_ID や _WORKSPACE_ID が残っていても、そのクライアントの CMDB を参照することはありません。環境変数の値は保存済み ID より優先されるため、サイトを切り替えるときは環境変数の設定を解除してください。

doctor は設定とパスを確認し、不足している SITE、EMAIL、API_TOKEN を示し、認証済みの読み取り（GET /servicedesk）を1回実行してトークンを検証します。

このスキルでできること

MSP からよく寄せられる質問	コマンド
すべてのキューを対象に、今後2時間以内に SLA 違反となるチケットはどれですか？	jira-service-management-cli breaches --within 2h
返信する前に、このチケットで何があったか（内部メモも含む）を確認できますか？	jira-service-management-cli request timeline SD-123
顧客には見えないように、ほかの技術者向けのメモを追加できますか？	jira-service-management-cli request note SD-123 "Escalated to network team"
クライアントとの通話前に、Acme Corp の未解決チケットの状況を確認できますか？	jira-service-management-cli client "Acme Corp"
過去30日間のリクエストタイプ別 SLA 違反率はどれくらいですか？	jira-service-management-cli sla-report --since 30d --group-by requesttype
クライアントのスタッフのうち、どの組織にも属していない人、または2つの組織に属している人は誰ですか？	jira-service-management-cli roster 3
このサーバーに関連するチケットはどれですか？	jira-service-management-cli cmdb tickets srv-01
RMM のエクスポートにはあるものの、Assets にないノート PC はどれですか？	jira-service-management-cli cmdb reconcile --type Laptop --file rmm.csv --key Name --compare Serial,OS

client と sla-report はローカルコピーを読み取ります。まず jira-service-management-cli sync --resources organization,request,requesttype,servicedesk を実行してください。それ以外はすべてライブデータを読み取ります。

MCP サーバー経由で cmdb reconcile を実行する場合、エクスポートファイルを読み取れるのはサーバーの作業ディレクトリ内に限られます。また、そのディレクトリがファイルシステムのルートまたはホームフォルダーの場合は実行を拒否するため、任意のファイルを読み取る用途には使えません。MCP ホストがサーバーを / またはホームフォルダーから起動する場合は、エクスポートファイルがあるフォルダーで CLI から cmdb reconcile を実行してください。

コマンドの完全なリファレンスについては、guide.md を参照してください。AI エージェントの運用規約（--agent、--dry-run、変更を行う前に確認すべきタイミング）については、AGENTS.md を参照してください。

これが異なる点

ほとんどの Jira Service Management 統合や MCP サーバーは、質問のたびにライブ API 呼び出しへ中継します。1 件のレコードなら問題ありません。しかし、「未解決チケット 300 件のうち、次に SLA 違反となるのはどれか」と尋ねると行き詰まります。キューをまたいでチケットを順位付けする API 呼び出しはないため、AI はすべてのキューを確認し、重複を取り除き、ツールを 1 回ずつ呼び出して各チケットの SLA 指標を読み取る必要があります。

このスキルは、その処理をバイナリ内で行います。breaches はすべてのキューをライブで確認し、チケットの重複を取り除いて SLA の残り時間で順位付けします。request timeline はコメント（公開または内部のラベル付き）、ステータス履歴、承認、SLA 状態を 1 つのビューにまとめます。cmdb tickets は Assets（CMDB）オブジェクトと、それらに関連付けられたすべてのチケットを結合します。期間に関する質問では、全文検索に対応したローカル SQLite コピーも保持します。sync の後は、API 呼び出しなしでローカルコピーから sla-report、client、search が回答します。

Atlassian の公式 Rovo MCP Server は Atlassian がホストしており、Jira と Confluence に加えて、リクエストの検索、作成、トランジション、承認など、拡充が進む JSM ツールを提供します（開発者向けドキュメント）。また、運用アラートや Assets 検索にも対応しています（サポートドキュメント）。コミュニティ製の mcp-atlassian サーバーは、サービスデスクのキューや内部コメントを含め、Jira と Confluence を幅広くカバーしています。このコネクターはそれらを補完します。マシン上で動作し、JSM 独自の SLA タイマーを使ってキューをまたいでチケットを順位付けし、期間別の SLA レポートやクライアント別ビュー用にローカルコピーを保持し、Assets と RMM または PSA のエクスポートを比較します。

このツールが解決する課題

内部メモが誤って顧客に届くことがあります。Atlassian の公式公開トラッカーにも、この要望が掲載されています（JSDCLOUD-17210）。エージェントは「コメントが内部向けか外部向けか分からず、誤った方を選択してしまうことがある」のです。汎用コメント呼び出しを使って投稿する AI エージェントにも、同じ問題があります。一方、SLA の残り時間でキューをまたいで未解決チケットを順位付けする API 呼び出しはありません。そのため、「次に SLA 違反となるのはどれか」という質問には、すべてのキューを確認したうえでチケットごとに SLA を読み取る必要があります。また、Assets（CMDB）が把握しているのは誰かがインポートした情報だけなので、RMM との差異は障害発生時に表面化します。

• jira-service-management-cli request note SD-123 "..." - 常に public=false として投稿し、JSM がコメントを公開として保存した場合はエラーになります。
• jira-service-management-cli request timeline SD-123 - 返信する前に、すべてのコメントに PUBLIC または INTERNAL のラベルを付けて表示します。
• jira-service-management-cli breaches --within 2h - すべてのキューを一度ずつ確認し、チケットの重複を取り除いて SLA の残り時間で順位付けします。
• jira-service-management-cli roster 3 - どの組織にも属していない、または 2 つの組織に属しているクライアントのスタッフと、デスクに関連付けられていない組織を表示します。
• jira-service-management-cli cmdb reconcile --type Laptop --file rmm.csv --key Name - Assets と RMM または PSA のエクスポートを比較します。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

はい、Plus、Pro、Team、Business、Enterprise、Education プランで利用できます（Free プランではまだ Developer Mode を利用できません）。ChatGPT は、ローカルの stdio バイナリではなく、HTTPS 経由でリモート MCP サーバーに接続します。Jira Service Management MCP サーバーはローカルで動作しますが、HTTP にネイティブ対応しています。JIRA_SERVICE_MANAGEMENT_MCP_HTTP_TOKEN にベアラートークンを設定し、jira-service-management-mcp --transport http で起動してください（デフォルトでは http://127.0.0.1:7777/mcp を提供します）。そのエンドポイントを HTTPS トンネルまたは独自のリバースプロキシの背後に配置します。ブリッジパッケージは不要です。手順は mcp-install.md をご覧ください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini で使えますか？

はい。いずれも MCP に対応しています。複数のツールに対応したインストールコマンドは上記の一覧に、詳しい説明は docs/which-agent.md にあります。

コーディングの知識は必要ですか？

いいえ。推奨インストール方法は、Claude Code または Codex に1文を貼り付けるだけです。エージェントが SKILL.md を読み、インストールを実行します。代替方法として、OS ごとの1行インストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。Jira Service Management の認証情報を一度入力します。

Jira Service Management のデータは安全ですか？

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite のミラーは、ユーザーアカウント内のディレクトリに保存されます。AI エージェントに表示されるのは CLI が返す情報のみです。通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含められたり、MSP Skills によってどこかへ送信されたりすることはありません。

Jira Service Management Data Center または Server でも使えますか？

いいえ。対象は Jira Service Management Cloud（your-site.atlassian.net）です。Data Center と Server ではホストと認証方式が異なり、このコネクターはそれらを呼び出しません。

Assets（CMDB）を利用するには JSM Premium が必要ですか？

Assets のコマンドを使う場合のみ必要です。Assets は JSM Premium と Enterprise に含まれています。キュー、SLA、リクエスト、コメント、顧客、組織は、どの JSM Cloud プランでも利用できます。Assets を使う場合は、クライアントのサイトごとに jira-service-management-cli cmdb discover --save を一度実行してください。そのサイトの cloudId と Assets workspaceId が見つかり、そのサイト専用に保存されます。

内部メモが顧客に届くことはありますか？

内部向けの内容には request note を使ってください。このコマンドは常に public=false を指定して投稿し、JSM が保存されたコメントを公開として報告した場合はエラーで終了するため、エージェントにそのことが伝わります。request comment add は顧客への返信用コマンドです。顧客に表示する返信には --public を指定してください。このフラグを省略すると public フィールドは送信されないため、内部メモには決して使わないでください。返信する前に request timeline を確認してください。すべてのコメントに PUBLIC または INTERNAL のラベルが付いています。

Atlassian API のレート制限に達しますか？

リアルタイムコマンドは通常の API 呼び出しを行い、Atlassian が返すレート制限ヘッダーに合わせてペースを調整します（--rate-limit で上書きできます）。breaches は各キューを読み込み、その後チケットごとに SLA を読み込むため、大規模なサイトでは --desk と --queue で対象を絞ってください。sync の後に実行する sla-report、client、search はローカルコピーを読み込むため、API 呼び出しは行いません。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。利用する AI エージェント（Claude、ChatGPT、Codex など）の費用のみをお支払いいただきます。その料金は当社ではなく、利用する AI プロバイダーから請求されます。

安全モデル

ティア	例	推奨されるエージェントポリシー
読み取り	breaches、request timeline、servicedesk queue list-issues、sla-report、roster、client、cmdb tickets、object find-by-aql	許可
書き込み（定型）	request note、request comment add、request transition perform、request create、request approval answer、object create / update	--dry-run でプレビューした後、レビュー済みの書き込みを実行
顧客と組織	customer create、servicedesk customer add / invite / remove、organization create、organization user add / remove、customer revoke-portal-only-access-for-user	人間の承認が必要です。これらの操作によって、顧客のチケット起票権限が変わります
破壊的操作／設定	organization delete、object delete、objectschema delete、objecttype delete、servicedesk requesttype delete、importsource token generate、api-import	必ず人間が関与してください

書き込み操作は即時に送信されます。--dry-run は明示的に指定してプレビューするもので、デフォルトではありません。MCP サーバーの環境に JIRA_SERVICE_MANAGEMENT_MCP_READ_ONLY=1 を設定すると、request_note、sync、export、workflow_archive、learnings_forget、learnings_reject、cmdb_reconcile（ローカルファイルを読み取ります）が無効になります。汎用の jira-service-management_execute ツールは GET 以外の API 呼び出しを拒否し、cmdb_discover は --save を拒否します。ローカル学習ツール（teach、teach_*、playbook_amend、learnings_confirm、recall）は引き続き利用できます。これらが書き込むのは CLI 独自のローカルストアのみです（recall は検索のたびにそのストアへ記録します）。サイトには書き込みません。

最も強力な制御は、API トークンに紐づく Atlassian アカウント です。CLI が実行できるのはそのアカウントに許可された操作のみなので、AI に許可したいアクセス権を持つエージェントとしてトークンを作成してください。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。Jira Service Management API の機能に対して検証済みで、毎週開催される Build Sessions では、本番環境のテナントで稼働させている MSP とともに検証を進めています。compoundingteams.com/build-sessions で参加をお申し込みください。

---

標準規格。 公開されている Agent Skills 仕様（Anthropic、2025 年 12 月、40 以上のエージェント）に準拠しています。MCP に対応しており、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw にも対応済みです（フロントマターは設定済みで、OpenClaw のリリースを待っています）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-10-16。