Azure Files

Azure Files共有に保存されたファイルとディレクトリを参照し、必要なファイルを読み取るか、ファイルストレージに取り込むことができます。必要に応じて、新しいディレクトリの作成、作業中に生成したファイルのアップロード、既存ファイルの置換、同じ共有内でのファイルやディレクトリの名前変更・移動もできます。

主な機能

Azure Storageアカウントのファイル共有一覧照会
共有内のディレクトリとファイル参照
ファイルまたはディレクトリのメタデータ照会
テキストファイル内容の読み取り
PDF、Officeドキュメント、バイナリファイルのダウンロード
ファイル名またはパスの一部を基準にしたファイル検索
既存ディレクトリ配下への新しいディレクトリ作成
ファイルストレージのファイルをAzure Files共有へアップロード
既存ファイルの内容の置換
同じ共有内でのファイルまたはディレクトリの名前変更・移動

基本情報

認証方式

Microsoft OAuth認証を使用します。

使用範囲

このMCPはAzure Filesクラウドストレージにアクセスします。ユーザーのローカルファイルシステムを参照または読み取る用途では使用しません。

サポートするMCPツール

list_shares

設定されたAzure Storageアカウントでアクセス可能なAzure Files共有一覧を照会します。ユーザーが共有名を指定していない場合に最初に使用します。

list_directory

指定した共有とディレクトリパス配下のファイルおよびサブディレクトリを照会します。結果には名前、パス、タイプ、サイズ情報が含まれる場合があります。

get_file_metadata

ファイルまたはディレクトリのメタデータを照会します。ファイル内容を読み取る、またはダウンロードする前にサイズとコンテンツタイプを確認する場合に使用します。

read_file

Azure Filesに保存されたテキストファイル内容をチャット応答内で直接読み取ります。バイナリファイルや大容量ファイルは download_file を使用します。

download_file

Azure Filesのファイルをファイルストレージにダウンロードし、aip-temp:// または aip-drive:// URIを返します。PDF、Officeドキュメント、画像、バイナリファイルのようにチャットに直接表示しにくいファイルに使用します。

search_files

ファイル名またはパスに含まれる文字列を基準にAzure Filesを検索します。本文全体検索はサポートしていません。検索範囲が広すぎる場合は、パスや検索語を絞り込んで再度実行することを推奨します。

create_directory

指定した共有の既存親ディレクトリ配下に新しいディレクトリを作成します。一度に作成できるのは1階層のみです。親ディレクトリが存在しない場合は、先に作成先を確認する必要があります。対象ディレクトリが既に存在する場合は、新規作成せず既存ディレクトリとして扱います。

upload_file

チャット、スキル、他のMCPツールなどで生成または取得したAIPファイルURIを、Azure Files共有の既存ディレクトリに新しいファイルとしてアップロードします。対象ファイル名が既に存在する場合、アップロードは失敗します。既存ファイルの上書きやファイル名の自動変更は行いません。

replace_file

チャット、スキル、他のMCPツールなどで準備したファイルで、Azure Filesの既存ファイル全体を置き換えます。新しいファイルを作成する場合はupload_fileを使用してください。

ファイル内容とコンテンツタイプは準備したファイルの内容に変わります。
既存ファイルのカスタムメタデータとSMB ACLは維持されます。
ディレクトリは置き換えできず、対象ファイルが既に存在する必要があります。
既存ファイルの置換または上書きを明示的に依頼された場合のみ使用します。

rename_item

同じSMB File Share内で既存のファイルまたはディレクトリの名前を変更したり、別のパスに移動したりします。たとえばreports/draft.mdをarchive/final.mdへ移動できます。

ソースパスと移動先パスは異なる必要があります。
移動先の親ディレクトリはあらかじめ存在している必要があります。
移動先パスに既にファイルまたはディレクトリがある場合、上書きせずに失敗します。
処理が完了すると、ソースパスは使用できなくなります。

使用例

「Azure Filesで reports 共有の2026年売上レポートを探して」
「finance 共有の /monthly フォルダにどんなファイルがあるか見せて」
「Azure Filesにある summary.txt の内容を読んで」
「契約書PDFをファイルとして取り込んで要約して」
「finance 共有の /monthly 配下に 2026-08 フォルダーを作成して」
「先ほど作成したレポートをAzure Filesの reports/2026 フォルダーにアップロードして」
「finance 共有の monthly/summary.xlsx を先ほど更新したファイルで上書きして」
「finance 共有の drafts/plan.md を archives/2026/plan-final.md に移動して」

注意事項

Azure StorageアカウントとAzure Files共有にアクセスできるMicrosoftアカウント権限が必要です。
read_file はテキスト形式ファイルに適しています。PDF、Officeドキュメント、画像、大容量ファイルはダウンロード後に別のツールまたはスキルと一緒に処理してください。
search_files はファイル名とパス基準の検索であり、ファイル本文内容は検索しません。
create_directory は複数階層のフォルダーを一度に作成しません。必要に応じて親ディレクトリから順番に作成してください。
upload_file はAzure Filesの既存ディレクトリに新しいファイルを保存する機能です。対象ディレクトリは自動作成されず、既存ファイルは上書きされません。
upload_file、replace_file、rename_itemは現在、SMB Azure Files共有のみサポートします。NFS共有では使用できません。
rename_itemはFile Share間の移動をサポートしません。同じ共有内でのみ名前変更または移動できます。
replace_fileはバージョン管理や同時編集の保護を提供しません。置換ファイルを準備した後に別のユーザーが対象ファイルを変更しても、その変更は置換時に上書きされます。最新の内容を反映する必要がある場合は、置換前に対象ファイルを再度ダウンロードして置換ファイルを準備してください。
ファイルのアップロード、置換、名前変更には読み取り権限に加えて書き込み権限が必要です。権限を新たに付与された場合は、Microsoft OAuthを再接続してから再試行してください。