Important
- これはプレビュー機能です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能は、追加使用条件の対象であり、公式リリース前にお客様が早期にアクセスし、フィードバックを提供できるよう利用可能になっています。
概要
| サーバー ID | 表示名 | 説明 |
|---|---|---|
mcp_OneDriveRemoteServer |
Work IQ OneDrive | OneDrive操作用の MCP サーバー。 このサーバーは、ユーザーの個人用OneDrive内のファイルとフォルダーを管理するために使用します。 すべてのファイル操作は、≤5 MB に制限されています。 |
注
- Microsoft Teams MCP サーバーなど、以前のバージョンの Microsoft MCP サーバーを使用する既存の接続は引き続きサポートされます。
- すべての新しい接続には、Work IQ Teams などの最新の Work IQ MCP サーバーを使用します。
使用可能なツール
getOnedrive
ドライブのメタデータ、クォータ、所有者情報など、ユーザーの OneDrive に関する情報を取得します。
必須パラメーターはありません。
getFolderChildrenInMyOnedrive
ユーザーの OneDrive 内の指定した親フォルダーに含まれる上位 20 個のファイルとフォルダー (DriveItems) を列挙します。
オプション パラメーター:
- parentFolderId: ファイルとフォルダーが一覧表示される親フォルダーの ID (既定値: 'root')
マイドライブ内のファイルまたはフォルダーを検索する
ユーザーの OneDrive 内のファイルまたはフォルダー (DriveItem) を検索クエリで検索します。 アイテムがユーザーの OneDrive にあることがわかっている場合は、アクセス可能なすべてのファイルを検索するよりも効率的です。
[Required parameters]\(必須のパラメーター\):
- Searchquery： 検索クエリ。ファイル名の全体または一部を指定できます。
getFileOrFolderMetadataInMyOnedrive
ユーザーの OneDrive からファイルまたはフォルダー (DriveItem) のメタデータを取得します。
[Required parameters]\(必須のパラメーター\):
- fileOrFolderId: ユーザーの OneDrive 内のファイルまたはフォルダーの ID
getFileOrFolderMetadataByUrl (URL からファイルまたはフォルダーのメタデータを取得)
共有 URL からファイルまたはフォルダー (DriveItem) のメタデータを取得します。 ファイルにアクセスするための既存の明示的なアクセス許可を持つユーザーのみがメタデータを取得できます。
[Required parameters]\(必須のパラメーター\):
- fileOrFolderUrl: ファイルまたはフォルダーの URL。 URL はユーザーとの共有のために再利用されません。ユーザーはすでに明示的なアクセス権を持っている必要があります。
readSmallTextFileFromMyOnedrive
ユーザーの OneDrive からテキスト ファイルを読み取り (ダウンロード) します。 ファイルを識別してダウンロードするには、fileId (driveItemId) を指定する必要があります。
[Required parameters]\(必須のパラメーター\):
- fileId: 読み取り/ダウンロードするファイルの driveItemId
MyOnedriveに小さなテキストファイルを作成する
5 MB 未満のサイズのテキスト ファイルを作成するか、ユーザーの OneDrive にアップロードします。
[Required parameters]\(必須のパラメーター\):
- Filename： 作成するファイルの名前
- contentText: ファイルのテキスト コンテンツ
オプション パラメーター:
- parentFolderId: 親フォルダーの ID (既定値: 'root')
フォルダをマイOneDriveに作成する
指定した親フォルダーの子として、ユーザーの OneDrive に新しいフォルダー (DriveItem) を作成します。 同じ名前のフォルダーが既に存在する場合は、数値サフィックスが追加されます (たとえば、NewFolder (1))。
[Required parameters]\(必須のパラメーター\):
- folderName: 作成するフォルダーの名前
オプション パラメーター:
- parentFolderId: 親フォルダーの ID (既定値: 'root')
ファイルまたはフォルダーを私の OneDrive 内で名前を変更する
ユーザーの OneDrive のファイルまたはフォルダー (DriveItem) の名前を変更します。 新しい名前は、名前付け規則に従う必要があります。
[Required parameters]\(必須のパラメーター\):
- fileOrFolderId: 名前を変更するファイルまたはフォルダーの ID
- newFileOrFolderName: ファイルまたはフォルダーの新しい名前
- Etag： コンカレンシー制御の ETag 値。 DriveItem の現在の ETag が一致する場合にのみ、操作が成功します
MyOnedrive 内のファイルまたはフォルダーを削除
ユーザーの OneDrive からファイルまたはフォルダー (DriveItem) を削除します。
[Required parameters]\(必須のパラメーター\):
- fileOrFolderId: 削除するファイルまたはフォルダーの ID
- Etag： コンカレンシー制御の ETag 値
小さいファイルを私のOneDriveに移動する
ユーザーの OneDrive 内のファイル (DriveItem) を別のフォルダーに移動します。 5 MB 未満のファイルのみをサポートします。
[Required parameters]\(必須のパラメーター\):
- fileId: 移動するファイルの ID
- newParentFolderId: ターゲット フォルダーの ID (ユーザーの OneDrive に含まれている必要があります)
- Etag： コンカレンシー制御の ETag 値
マイオンードライブ内のファイルまたはフォルダーを共有するコマンド (shareFileOrFolderInMyOnedrive)
ユーザーの OneDrive 内のファイルまたはフォルダー (DriveItem) に対する読み取り/書き込みアクセス許可を付与する共有の招待を送信します。
[Required parameters]\(必須のパラメーター\):
- fileOrFolderId: 共有するファイルまたはフォルダーの ID
- recipientEmails: 招待する受信者のメール アドレスの配列
- 役割： 割り当てるロールの配列。 受け入れ可能な値: 'read'、'write' (書き込みでは読み取りと書き込みの両方が許可されます)
オプション パラメーター:
- メッセージ： 招待メールに含めるカスタム メッセージ (既定: '共同作業を行っているファイルは次のとおりです。'
- sendInvitation: 共有の招待を送信するかどうか (既定値: true)
マイワンドライブ内のファイルにセンシティビティラベルを設定
ユーザーの OneDrive でファイルの秘密度ラベルを設定します。
[Required parameters]\(必須のパラメーター\):
- fileId: ファイルの driveItemId
- sensitivityLabelId: 割り当てる秘密度ラベルの ID、または削除する空の文字列
オプション パラメーター:
- assignmentMethod: 割り当て方法: 'standard'、'privileged'、'auto'、または 'unknownFutureValue' (既定値: 'privileged')
- justificationText: 監査目的での正当な理由のテキスト。ラベルをダウングレードまたは削除する場合は必須 (既定値: 'MCPServer によって変更されました')
主要な機能
OneDrive管理
- OneDrive 情報 (クォータ、所有者) を取得する
- ユーザーの個人用 OneDrive にアクセスする
- 認証されたユーザーの OneDrive を対象とするすべての操作
ファイルの検索と検出
- ユーザーの OneDrive 内の名前でファイルとフォルダーを検索する
- ID または共有 URL でファイルまたはフォルダーのメタデータを取得する
- フォルダーの内容を参照する (最大 20 個のアイテム)
ファイル操作
- テキスト ファイルの作成 (≤5 MB)
- テキスト ファイルの読み取り
- コンカレンシー制御を使用してファイルを削除する
- eTag 保護を使用してファイルの名前を変更する
- フォルダー間でファイルを移動する
フォルダー管理
- オプションの親パスを使用してフォルダーを作成する
- 重複するフォルダー名の自動数値サフィックス
- フォルダーの内容を一覧表示する (最大 20 項目)
- フォルダー メタデータを取得する
- コンカレンシー制御を使用してフォルダーを削除する
- eTag 保護を使用してフォルダーの名前を変更する
共有とアクセス許可
- ファイルとフォルダーをユーザーと共有する
- ロールベースのアクセス制御 (読み取り、書き込み)
- 共有用の電子メール通知
- 招待のカスタム メッセージ
セキュリティとコンプライアンス
- 機密ラベルを適用および削除する
- 複数の割り当て方法 (標準、特権、自動)
- 監査の正当な理由のサポート
- eTag を使用したコンカレンシー制御
メモ
- すべての操作は、認証されたユーザーの個人用 OneDrive を対象としています
- ファイルの操作は、アップロードとダウンロードに≤5 MB に制限されます
- 削除、名前の変更、および移動操作には、コンカレンシー制御に eTag が必要です
- すべての操作で Microsoft Graph API を使用する
- 共有するには、有効な電子メール アドレスと適切なアクセス許可が必要です
- 秘密度ラベルには、適切なライセンスと構成が必要です
- フォルダー一覧では、既定で最大 20 個のアイテムが返されます
- 同時操作での競合を防ぐ eTag 保護
注
MCP ツールの名前とパラメーターは変更される可能性があり、ハードコーディングされた依存関係は避ける必要があります。 シナリオのサポートは維持されます。