Microsoft Graph MCP

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

非公式です。Microsoft Graph API 向けにコミュニティが開発した Claude Code Skill および MCP サーバーです。Microsoft Corporation との提携、同社による推奨または支援はありません。

_{▶ 30秒のデモを見る - デモデータはシミュレーションですが、表示されているすべてのコマンドは実際の CLI で使用できます。}

廃止予定の mgc に代わる、保守が続けられている単一バイナリです。MSP に関係するあらゆる Microsoft Graph の機能に加え、無駄なライセンス、特権アクセスのリスク、古いデバイスを見つけるオフラインストアを備えています。これらは単一の API 呼び出しでは見つけられません。すでにお使いの AI で動作します。ChatGPT（Plus/Pro+、このコネクターが再公開されるまで一時停止中です。mcp-install.md を参照してください）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに対応し、リモート経由でMicrosoft 365 Copilot / Copilot StudioとGoogle Geminiでも利用できます。無料のオープンソースで、ノートパソコン上で動作します。MSP のオーナー向けに構築されています。コードは不要です。

エージェントで使用する

セキュリティに関する注意（このコネクターが再公開されるまで）。 HTTP モード（--transport http）は、localhost 上であっても実行しないでください。このビルドにはパスワードがなく、すべてのネットワークインターフェースで待ち受けます。また、ブラウザーのリバインディング対策が導入される前のものなので、開いたウェブページから接続できてしまいます。さらに、MCP ツールは認証情報を使ってデータを読み取ることもできます。既定の stdio トランスポートを使用してください。リモートエージェント用にトンネルを設定した場合は、停止してください。修正は準備中です。

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

お使いの AI エージェント	Microsoft Graph スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で microsoft-graph-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再公開されるまで一時停止中です。ChatGPT には HTTP モードが必要ですが、このビルドではパスワードが要求されず、すべてのネットワークインターフェースで待ち受け、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。
Codex CLI	以下のインストールプロンプトを貼り付けます。
Claude Code	以下のインストールプロンプトを貼り付けます。
Claude Cowork	以下のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、microsoft-graph-mcp を mcp.json の servers キーの下に追加してから、Agent モードを選択します。

ChatGPT にはリモート HTTPS サーバーが必要です。そのため、このコネクターの HTTP モードが必要ですが、コネクターが再公開されるまで一時停止中です。このビルドではそのモードでパスワードが要求されず、すべてのネットワークインターフェースで待ち受け、開いたウェブページから接続できてしまいます。mcp-install.md のセキュリティに関する注意を参照してください。

Microsoft と Google のスタックも

大きなインストールベースがありますが、正直にお伝えすると、こちらはリモート／エンタープライズ向けの方法であり、先ほどインストールしたローカルバイナリではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで保留です。Copilot Studio には HTTP モードが必要ですが、このビルドではそのモードにパスワードが不要で、すべてのネットワークインターフェースで待ち受け、開いたウェブページからアクセスできます。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同じです。Gemini アプリはリモートで、ChatGPT と同じく保留中の HTTP モードが必要です。mcp-install.md をご覧ください。

スキルネイティブのエージェント（こちらも対象）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。以下のインストール手順をご覧ください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの詳しい設定方法は、docs/which-agent.md をご覧ください。

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

60 秒でインストール

Claude Desktop ならワンクリックの .mcpb が最速です

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは、付属の microsoft-graph-cli を呼び出します。2026-09-18 以降に公開されたリリースでは、この CLI がバンドルに含まれています。それ以前のバンドルには MCP サーバーのみが含まれているため、付属の CLI がない場合は、先に以下の Path A または Path B のインストーラーを実行するか、既存のバイナリを MICROSOFT_GRAPH_CLI_PATH に設定してください。詳細： #331。

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

Claude Code プラグインを使いますか？マーケットプレイスを一度追加してからインストールしてください。すぐに動作し、ディレクトリ一覧の取得も不要です：

/plugin marketplace add Servosity/msp-skills
/plugin install microsoft-graph@msp-skills

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

次の内容を Claude Code、Codex CLI、または Claude Cowork にコピーしてください：

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

シェルを実行できるエージェントなら、同じプロンプトを使えます。

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

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/microsoft-graph/install.ps1 | iex

macOS / Linux：

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

インストーラーにより、microsoft-graph-cli（CLI）と microsoft-graph-mcp（MCP サーバー）の両方がユーザーの bin パスに配置されます。Claude Code、Codex、Cowork は、このディレクトリにある SKILL.md からスキルを検出します。

確認：

microsoft-graph-cli --version

最新バージョンにアップグレードする

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

macOS / Linux：

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

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/microsoft-graph/install.ps1 | iex

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

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

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

Hermes にインストールする

Hermes CLI から実行します。

hermes skills install servosity/msp-skills/skills/microsoft-graph --force

Hermes のチャットセッション内で実行します。

/skills install servosity/msp-skills/skills/microsoft-graph --force

Hermes は MCP をネイティブにサポートしているため、microsoft-graph-mcp サーバーも直接利用できます。インストール方法も環境変数も同じです。

OpenClaw にインストールする

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

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

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

認証する

CLI に必要な認証情報を設定します（Microsoft Graph ポータルから取得してください）。

MICROSOFT_GRAPH_TOKEN=<value> microsoft-graph-cli doctor

doctor は、データにアクセスする操作を実行する前に、認証情報が有効かどうかを確認します。認証情報が拒否された場合でも終了コード 0 を返すため、スクリプトでは --fail-on error を追加してください。

このスキルでできること

MSP からよく尋ねられる質問	コマンド
料金を支払っているのに十分活用されていない SKU はどれですか？未使用ライセンス数の多い順に確認できますか？	microsoft-graph-cli licenses waste --agent
無効化されたアカウントやゲストアカウントのうち、有料ライセンスをまだ保持しているのはどれですか？	microsoft-graph-cli licenses orphans --json
ライセンスを回収する前に、特定の SKU を使用しているユーザーを正確に確認できますか？	microsoft-graph-cli licenses map "ENTERPRISEPACK" --agent
現在、誰が特権ディレクトリロールを保持していますか？その保持者のうち、ゲストまたは無効化されたアカウントはどれですか？	microsoft-graph-cli admins audit --agent
昨日以降に発生した未解決のセキュリティアラートは何ですか？重大度とソース別に確認できますか？	microsoft-graph-cli security triage --since 24h --agent
今月、コンプライアンス違反、暗号化なし、または古い状態の Intune デバイスはどれですか？	microsoft-graph-cli managed-devices drift --days 30 --agent
テナント全体で、所有者がいないグループ、空のグループ、またはゲストが多いグループはどれですか？	microsoft-graph-cli groups risk --agent
テナントで同意されているサードパーティアプリはどれですか？過剰な権限を持つアプリや、管理者が同意したアプリはどれですか？	microsoft-graph-cli apps consent --agent
ユーザー、ライセンスの無駄、管理者、アラート、デバイスの状態について、このテナントの全体像を確認できますか？	microsoft-graph-cli tenant snapshot --agent

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

このスキルの特徴

ほとんどの Microsoft Graph 統合や MCP サーバーは、質問ごとにライブ API 呼び出しへ中継します。1件のレコードを取得するだけなら問題ありません。しかし、「テナント全体でどれだけライセンス費用を削減できるか」や「現在、誰がこのテナントを管理できるか」といった質問をするようになると、規模の拡大に対応できず、必要な一括読み取りが Graph によってスロットリングされます。

このスキルは、MSP に関連する Microsoft Graph のデータを、全文検索機能を備えたローカルの SQLite ミラーに同期します。集計の質問はローカル SQL の結合1回で処理できるため、即座に、オフラインで回答でき、AI には生データではなく答えが提示されます。licenses waste、admins audit、tenant snapshot のような複合コマンドは、ユーザー、サブスクライブ済み SKU、ディレクトリロール、セキュリティアラート、Intune デバイスを横断して結合します。これはステートレスな API ラッパーではできない処理です。また、.NET や PowerShell のランタイムを必要としないクロスプラットフォームの単一バイナリとして動作します。これは、Microsoft が 2026年8月28日に廃止する mgc CLI の軽量な後継です。

この課題を解決します

Microsoft は 2026 年 8 月 28 日に Microsoft Graph CLI（mgc）を廃止します。2025 年 9 月以降は非推奨となり、セキュリティ修正のみが提供されています。Microsoft は、より大規模な PowerShell SDK への移行を推奨しています（Microsoft 365 Developer Blog、「Microsoft Graph CLI retirement」）。軽量でクロスプラットフォーム対応のバイナリを使ってテナントのレポート作成をスクリプト化していた MSP は、実行するすべてのマシンに .NET／PowerShell への依存関係を抱えることになります。また、mgc では、MSP が実際に知りたい、回収可能なライセンス費用、管理者権限を持つユーザー、準拠状態から外れつつあるデバイスなど、エンティティをまたぐ質問には答えられません。これらの情報をまとめて返す Graph エンドポイントがないためです。その結果、顧客ごとに毎月、CSV をエクスポートしてスプレッドシート上で結合することになります。

このスキルは、軽量な後継ツールであると同時に、その課題も解決します。

課題	コマンド
「無駄になっているライセンスはどれ？」と調べるには、SKU の CSV をエクスポートし、シート数を手作業で照合する必要があります	microsoft-graph-cli licenses waste --agent
「このテナントを管理できるのは誰？」と調べるには、Entra で特権ロールをひとつずつ開く必要があります	microsoft-graph-cli admins audit --agent
「昨日以降、Defender で何が新たに発生した？」と調べるには、毎朝ポータルでページを切り替えて確認する必要があります	microsoft-graph-cli security triage --since 24h --agent
「コンプライアンスに準拠していないデバイスはどれ？」と調べるには、毎週ポータルからスプレッドシートへの ETL が必要です	microsoft-graph-cli managed-devices drift --days 30 --agent
「メールやファイルを読み取れるサードパーティ製アプリはどれ？」と調べるには、Entra でエンタープライズアプリごとにアクセス許可のブレードをクリックする必要があります	microsoft-graph-cli apps consent --agent
「このテナントの現状は？」を確認できる単一の画面はありません	microsoft-graph-cli tenant snapshot --agent

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

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free プランではまだ Developer Mode を利用できません）は、HTTPS 経由のリモート MCP サーバーにのみ接続できます。そのため、Microsoft Graph MCP サーバーを HTTP モードで実行する必要があります。このビルドの HTTP モードではパスワードが要求されず、すべてのネットワークインターフェイスで待ち受け、開いた Web ページからアクセスできるため、コネクターが再公開されるまでは実行したり、トンネルの背後に配置したりしないでください。その理由は mcp-install.md のセキュリティに関する注意事項で説明しています。それまでは Claude Desktop、Claude Code、または Codex をお使いください。

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

はい。いずれも MCP に対応しています。ツールごとのインストールコマンドは上の一覧と、docs/which-agent.md の詳しい説明をご覧ください。

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

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

Microsoft Graph のデータは安全ですか？

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

廃止される Microsoft Graph CLI（mgc）の後継ですか？

ディレクトリ、ライセンス、セキュリティ、デバイス関連の機能を対象とした、MSP 向けの読み取りとレポート作成の中核を担う、軽量な後継ツールとして開発されています。.NET や PowerShell のランタイムを必要としない、クロスプラットフォーム対応の単一 Go バイナリです。Microsoft が推奨する方法は PowerShell SDK です。こちらは、スクリプトで操作できる単一バイナリと AI エージェントを使いたいチーム向けの選択肢です。Microsoft とは提携関係になく、Microsoft の推奨を受けた製品でもありません。

Microsoft Graph のスロットリング制限に達しますか？

ローカルの SQLite ミラーがあるため、読み取り時に Graph へアクセスする必要はありません。最初の pull の後は、エンティティをまたぐビュー（licenses waste／orphans／map、admins audit、security triage、managed-devices drift、groups risk、tenant snapshot）はローカルの SQLite に対して実行され、API 呼び出しは一切ありません。ライブ呼び出しは @odata.nextLink に従い、--rate-limit のスロットリングを尊重します。また、pull はトークンでアクセスできないリソースを失敗ではなく警告として扱います。

委任トークンとアプリ専用トークンのどちらを使用しますか？

どちらも使用できます。microsoft-graph-cli auth login --tenant <id> --client-id <id> --client-secret <secret> を実行すると、無人の MSP 運用向けにアプリ専用（クライアント資格情報）トークンを発行してキャッシュできます。または、発行済みのトークンを MICROSOFT_GRAPH_TOKEN としてエクスポートしてください。Directory.Read.All、RoleManagement.Read.Directory、SecurityAlert.Read.All、DeviceManagementManagedDevices.Read.All などの読み取りスコープを付与し、管理者の同意を得る必要があります。アプリ専用トークンには /me がないため、users me は委任トークンでのみ使用できます。

テナントにアクセスできるサードパーティ製アプリを監査するにはどうすればよいですか？

microsoft-graph-cli apps consent --agent を実行します。テナントに同意済みの、Microsoft 製ではないすべてのエンタープライズアプリケーション（サービスプリンシパル）と、そのアクセス権を一覧化します。サービスプリンシパル、委任された同意付与（oauth2PermissionGrants）、アプリケーション／アプリ専用のアクセス許可（appRoleAssignments）を結合し、リスク順の表にまとめます。過剰な権限（広範なスコープや全項目への書き込み権限）、管理者が同意した（テナント全体に適用される）アプリ、権限昇格のアクセス許可、ユーザーが同意したシャドー IT にフラグを付けます。すべて読み取り専用です。Microsoft 独自のファーストパーティアプリは集計されますが、一覧には表示されません。読み取りスコープ Application.Read.All、Directory.Read.All、DelegatedPermissionGrant.Read.All が必要です。

費用はかかりますか？

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

安全性モデル

ティア	例	推奨されるエージェントポリシー
読み取り	licenses waste、admins audit、apps consent、security triage、managed-devices drift、groups risk、tenant snapshot、users list、pull、search、export	許可
書き込み（インポートのみ）	import <resource> --input data.jsonl - 唯一の書き込み経路。JSONL レコードごとに POST を 1 回実行	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
破壊的操作／設定	なし - CLI には削除や更新の経路はありません	人間による確認を必須にする

型指定されたすべてのコマンドは読み取り専用です。唯一の作成経路は import で、--dry-run でプレビューできます。最も強力な制御は、Microsoft Graph の認証情報に付与するスコープです。CLI が実行できるのは、認証情報に許可された操作だけです。ロックダウンの方法を含む詳細は、governance.md を参照してください。

ステータス

ベータ版です。Microsoft Graph API の仕様に照らして検証済みで、毎週開催される Build Sessions では、本番環境の独自テナントで稼働させている MSP とともに検証を進めています。compoundingteams.com/build-sessions で参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月。40 以上のエージェントに対応）に準拠しています。MCP 互換で、Hermes を含む MCP 対応エージェントで使用できます。OpenClaw に対応済みです（フロントマターの設定済み。OpenClaw のリリース待ち）。

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