Azure MCP Server とは|Claude Code から接続して読み取り専用・書き込みの確認・ツールの絞り込みを実機で検証

AI

この記事でわかること

  • Azure MCP Server のしくみ(MCP、ツール、認証、権限)
  • 起動オプション(--read-only、--namespace、モード)で、AI にできることを絞る方法
  • Claude Code から実際に使って分かった、書き込み前の確認(elicitation)と注意点

はじめに

Azure MCP Server は、AI から Azure のリソースを調べたり操作したりするための、Microsoft 製の MCP サーバー。
2026年10月に Azure MCP Server 3.0 が一般提供になった。
この記事では、しくみと権限の考え方を整理し、Claude Code から実際に接続して、読み取り、読み取り専用モード、書き込みの確認、ツールの絞り込みを確かめる。
Azure の AI サービスのセキュリティ全体は、AI 編で扱っている。
※2026年11月時点の情報です。

Azure の AI サービスとは|推奨アーキテクチャ(ベースライン Foundry チャット)のセキュリティとネットワークを整理
Azure の AI サービスの全体像と、推奨アーキテクチャ「ベースライン Foundry チャット」を部品ごとに分けて、ID、ネットワーク、閉域にするときの注意を公式ドキュメントで整理。

Azure MCP Server とは

MCP(Model Context Protocol)は、言語モデルが外部のツールやデータとやり取りする方法を決めたオープンなプロトコル。
MCP サーバーが「ツール」を用意し、AI エージェントなどのクライアントがそのツールを呼ぶ。
Azure MCP Server は、MCP に沿って Azure 用のツールを実装したもので、クライアントはツールを通して Azure のリソースとやり取りする。

Azure MCP Server のしくみ。MCP クライアント(Claude Code、VS Code など)が、PC の上で動く Azure MCP Server のツールを stdio で呼び、サーバーは Entra ID のトークンで Azure の API を呼ぶ。モード、namespace、read-only、確認(elicitation)のオプションがある
項目内容
接続できるクライアントVS Code、Visual Studio、Cursor、IntelliJ、Cline などのエディターや、GitHub Copilot の CLI・クラウド エージェント、Python・.NET のプログラム。
MCP に対応したクライアントなら設定で接続できる
入手npm の @azure/mcp、NuGet の Azure.Mcp、PyPI の msmcp-azure。
Docker コンテナーとしても動かせる
認証Azure ID ライブラリを通して Microsoft Entra ID を使う。
認証エラーのときは az login などで Azure にサインインしているかを確かめる
権限アクセスは Azure RBAC で守られる。
使えるツールの範囲は、サブスクリプションでの権限を反映する
ツールStorage、Key Vault、Monitor、Compute、Cosmos DB、App Service など、サービスごとのツール。
ドキュメントやベスト プラクティス、料金を調べるツールもある

公式ドキュメント:
Azure MCP サーバーとは | Microsoft Learn
Azure MCP サーバーを始める | Microsoft Learn

起動オプションで、AI にできることを絞る

Azure MCP Server は、起動するときのオプションで、AI に見せるツールを変えられる。

オプション内容
--mode namespace(既定)Azure のサービスごとにツールをまとめ、名前空間ごとに 1 つのツールを出す
--mode consolidated関連する操作を、AI エージェント向けに整理したツールにまとめる
--mode all200 以上のツールを 1 つずつ出す。
クライアントのツールの上限を超えることがある
--namespacestorage や keyvault など、出すサービスを指定する
--tool出すツールを名前で 1 つずつ指定する
--read-only読み取り専用にする。書き込みの操作をさせない
確認(elicitation)シークレットなど機密情報を扱うツールは、実行前にクライアントでユーザーの確認を求める。
無効にするオプション(--dangerously-disable-elicitation)は推奨されない

クライアントによっては、扱えるツールの数に上限がある(VS Code の GitHub Copilot は 1 回の要求で 128 ツール)。

公式ドキュメント:
Azure MCP サーバーの概念 | Microsoft Learn
Azure MCP サーバー ツールとは | Microsoft Learn

セキュリティの考え方

項目公式の推奨
最小特権呼び出す人に、作業に必要な Azure RBAC のロールだけを付ける。
範囲もできるだけ狭くする
ローカルのサーバー開発用。
サインインしているアカウントで動くので、つなぐ前にそのアカウントの権限を確かめ、不要な広い権限を外す
動かす場所信頼できる PC やコンテナーで動かし、ほかの人やネットワークにローカルのエンドポイントを公開しない
運用環境運用のデータや運用の資格情報をローカルの Azure MCP Server で扱わない
リモートのサーバーセルフホストするなら、API Management の後ろに置いてトークンの検証、レート制限、監査を行うことを検討する
サーバーの選び方Azure のサービスには、似たツールを出す未確認のサーバーではなく、ファースト パーティの Azure MCP Server を使う

公式ドキュメント:Azure MCP サーバーの展開をセキュリティで保護する | Microsoft Learn

構築手順

今回の構成と実施すること

今回の構成。PC の Claude Code が設定ファイルで Azure MCP Server 3.0.0 を起動し、az login の資格情報で Azure サブスクリプションの rg-mcp-demo を操作する。手順は、既定で一覧、read-only で作成、既定で作成、namespace で絞るの 4 つ

MCP クライアントには Claude Code を使った。
Claude Code の --mcp-config で設定ファイルを渡すと、Azure MCP Server が子プロセスとして起動し、stdio でつながる。
結果を残すために、非対話(claude -p)で実行し、出力を JSON(stream-json)で保存した。
Azure には、あらかじめ Azure CLI でサインイン(az login)しておいた。
Azure MCP Server 側の追加の認証設定はしていない。

{ "mcpServers": { "azure": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@azure/mcp@3.0.0", "server", "start"] } } }

Windows では、npx を cmd /c から起動した。
読み取り専用にするときは、args の最後に “--read-only” を足す。

claude -p "<依頼>" --mcp-config mcp-rw.json --strict-mcp-config --allowedTools mcp__azure --output-format stream-json --verbose

① 読み取り:リソース グループの一覧

Claude Code に、rg-mcp-demo のあるサブスクリプションのリソース グループの一覧を頼んだ結果。subscription_list と group_list のツールを呼び、10 個のリソース グループを表で答えた

既定の設定では、Azure MCP Server のツールが 69 個出た。
AI は subscription_list でサブスクリプションを調べてから group_list を呼び、結果を表にして答えた。
ツールの結果は JSON で返り、それを AI が読みやすく整えている。

② --read-only:作成のコマンドがなくなる

read-only で起動した Azure MCP Server にストレージ アカウントの作成を頼んだ結果。storage ツールで使えるコマンドは storage_account_get、storage_blob_get、storage_blob_container_get、storage_table_list だけで、作成できないと答えた

--read-only で起動すると、ツールは 67 個になった。
storage のツールで使えるコマンドは、取得と一覧だけ(storage_account_get など 4 つ)だった。
AI は arm のツールでも作成の手段を探したが見つからず、「作成できない」と答えた。
Azure CLI など、MCP 以外の手段は使わないよう依頼に書いておいた。

既定--read-only
ツールの数6967
storage のコマンドstorage_account_create
storage_account_get
storage_blob_get
storage_blob_upload
storage_blob_container_create
storage_blob_container_get
storage_table_list
storage_account_get
storage_blob_get
storage_blob_container_get
storage_table_list

③ 既定の設定:作成の前に確認が求められる

既定の設定でストレージ アカウントの作成を頼んだ結果。storage_account_create を呼んだが、結果は Operation cancelled by user. で、Claude Code のデバッグ ログに Elicitation request received in print mode が出ていた

既定の設定では、AI は storage_account_create のコマンドを呼んだ。
しかし結果は「Operation cancelled by user.」で、ストレージ アカウントは作られなかった。
Claude Code のデバッグ ログを見ると、Azure MCP Server から確認(elicitation)の要求が届き、非対話の実行だったため取り消されていた。
BLOB コンテナーの作成でも同じだった。
人が確認に答えない限り、作成は進まない。

④ --namespace:出すツールを絞る

namespace storage と read-only で起動した Azure MCP Server の結果。ツールは group_list、group_resource_list、storage、subscription_list の 4 つで、ストレージ アカウントの一覧とリソース グループの一覧を取得できた

--namespace storage を付けると、ツールは 4 個(storage と、サブスクリプション・リソース グループの一覧の 3 つ)になった。
ストレージ アカウントの情報(場所、SKU、パブリック アクセスの設定など)と、リソース グループの一覧を取得できた。
作業に要るサービスだけを出せば、AI が使うツールを選びやすくなり、触れる範囲も狭くなる。

公式ドキュメント:Azure Storage 向けの Azure MCP Server ツール | Microsoft Learn

実機でつまずいた点

検証中に実際に出たエラーや、つまずいたところ。

Operation cancelled by user.

非対話の Claude Code から作成を頼むと Operation cancelled by user. になった。Azure MCP Server が作成の前に確認を求め、非対話では答えられず取り消された

Claude Code を非対話(claude -p)で動かし、ストレージ アカウントの作成を頼むと、ツールの結果が「Operation cancelled by user.」になった。
自分では取り消していない。
Claude Code のデバッグ ログ(--debug)に「Elicitation request received in print mode: mode=form fields=[“decision”]」とあり、Azure MCP Server が作成の前に確認を求めていたと分かった。
非対話の実行では確認に答えられないため、取り消しになる。
書き込みは、確認に答えられる形で実行する。
確認を無効にするオプションもあるが、公式は推奨していない。

@latest でベータ版が入る

npx -y @azure/mcp@latest で起動すると 4.0.0-beta.8 が入った。npm の dist-tags の latest がベータ版を指していた。3.0.0 を指定して使った

公式の設定例は「@azure/mcp@latest」になっている。
このとおり起動して --version を見ると「4.0.0-beta.8」だった。
npm の dist-tags を見ると、latest がベータ版を指していた(2026年11月18日時点)。
一般提供の 3.0.0 を使うなら、「@azure/mcp@3.0.0」のようにバージョンを指定する。

推奨構成

項目推奨理由
バージョンバージョンを指定して起動する(例:@azure/mcp@3.0.0)@latest はベータ版を指すことがある
権限AI に使わせるアカウントは、作業に必要なロールを必要な範囲だけにするツールでできることは、そのアカウントの Azure RBAC で決まる
読み取り専用調べものや確認が目的なら --read-only で起動する書き込みのコマンド自体が出なくなる
ツールの絞り込み--namespace や --tool で、作業に要るサービスだけを出すAI が触れる範囲が狭くなり、ツールの数の上限にもかかりにくい
確認書き込みの確認(elicitation)を無効にしない危険度の高い操作の前に人が確かめられる
動かす場所開発用の信頼できる PC やコンテナーで動かすローカルの Azure MCP Server は開発用

公式ドキュメント:
Azure MCP サーバーの展開をセキュリティで保護する | Microsoft Learn
Azure MCP サーバーの概念 | Microsoft Learn

注意事項

項目内容
資格情報ローカルでは、PC でサインインしているアカウントの権限で動く。
所有者などの広いロールのアカウントでつなぐと、AI もその範囲を操作できる
非対話の実行書き込みの確認に答えられず、取り消される(今回の検証)
運用環境運用のデータや運用の資格情報をローカルの Azure MCP Server で扱わない
ツールの上限クライアントには扱えるツールの数に上限がある。--mode all は 200 以上のツールを出す
料金ツールで作ったリソースには、通常どおり Azure の料金がかかる。
AI のクライアントの利用料も別にかかる

公式ドキュメント:
Azure MCP サーバーとは | Microsoft Learn
Azure MCP サーバーの展開をセキュリティで保護する | Microsoft Learn

まとめ

Azure MCP Server は、AI が Azure のリソースを調べたり操作したりするための MCP サーバー。
今回の検証では、Claude Code から読み取りはそのままでき、--read-only では書き込みのコマンドが消え、既定でも書き込みの前に確認が求められた。

・AI ができることは、サインインしているアカウントの Azure RBAC で決まる。
最小特権にする
・調べものなら --read-only、作業に要るサービスだけを --namespace で出す
・書き込みの確認(elicitation)は無効にしない
・@latest はベータ版のことがあるので、バージョンを指定する

コメント

タイトルとURLをコピーしました