Microsoft SharePoint および OneDrive MCP サーバー リファレンス

概要

使用可能なツール

createFolder

指定した親フォルダーの子として、指定したドキュメント ライブラリ内に新しいフォルダーを作成します。 ドキュメント ライブラリを指定しない場合、サーバーはユーザーの OneDrive を使用します。 親フォルダーを指定しない場合、サーバーはルートにフォルダーを作成します。 同じ名前のフォルダーが既に存在する場合、サーバーは、NewFolder (1) などの数値サフィックスを持つ新しいフォルダーを作成します。

必須パラメーター:

• folderName(文字列) – 作成するフォルダーの名前。 同じ名前のフォルダーが既に存在する場合、サーバーは、新しいフォルダー名に NewFolder (1) などの数値サフィックスを追加します。
• documentLibraryId(文字列) – フォルダーを作成するドキュメント ライブラリ (ドライブとも呼ばれます) の ID。 ユーザーのドライブまたはその OneDrive にフォルダー ("マイ ドライブ" や "マイ onedrive" など) を作成する場合は、"me" を documentLibraryId として送信します。

オプション パラメーター:

• parentFolderId(文字列、既定値 = "root") – 新しいフォルダーを作成する親フォルダーの ID。 指定しない場合、ドキュメント ライブラリのルートが既定値になります。

findSite

ユーザーがアクセスできる SharePoint サイトを検索します。 このツールは、指定した検索クエリに基づいて特定のサイトを検索するか、検索クエリを指定しない場合にユーザーがアクセスできる上位 20 の関連サイトを見つけることができます。

必須パラメーター:

なし

オプション パラメーター:

• searchQuery(文字列、既定値 = null) – サイト名の全体または一部を指定できる検索クエリ。 検索クエリを指定すると、ユーザーが特定のサイトを探している場合にのみ、サイトを効率的に検索できます。 たとえば、ユーザーが xyz というサイトを要求した場合、xyz を searchQuery として渡します。 ユーザーが単に "マイ サイト" を要求した場合は、このパラメーターを空のままにします。

listDocumentLibrariesInSite

指定した SharePoint サイトのドキュメント ライブラリ (ドライブとも呼ばれます) を一覧表示します。 サイトを指定しない場合、サーバーはルート サイトを使用します。

必須パラメーター:

なし

オプション パラメーター:

• siteId: サイト ID (既定値: ルート)

findFileOrFolder

検索クエリを渡すことによってユーザーがアクセスできるファイルまたはフォルダー (DriveItem とも呼ばれます) を検索します。

必須パラメーター:

• searchQuery: ファイル名の全体または一部を指定できる検索クエリ

renameFileOrFolder

指定したドキュメント ライブラリ内のファイルまたはフォルダー (DriveItems とも呼ばれます) の名前を変更します。 注: 新しい名前は名前付け規則に従う必要があります。

必須パラメーター:

• documentLibraryId: ドキュメント ライブラリ ID (文字列)
• fileOrFolderId: ファイルまたはフォルダー ID (文字列)
• newFileOrFolderName: ファイルまたはフォルダーの新しい名前 (文字列)

deleteFileOrFolder

指定したドキュメント ライブラリからファイルまたはフォルダーを削除します。

必須パラメーター:

• documentLibraryId: ドキュメント ライブラリ ID (文字列)
• fileOrFolderId: ファイルまたはフォルダー ID (文字列)

readSmallTextFile

特定のドキュメント ライブラリからテキスト ファイルを読み取ります (ダウンロードします)。 ドキュメント ライブラリを指定しない場合、ユーザーの OneDrive が使用されます。 ファイルを識別してダウンロードするには、fileId (ファイルの driveItemId) を指定する必要があります。

必須パラメーター:

• fileId(文字列)
• documentLibraryId(文字列) – 読み取るファイルのドキュメント ライブラリ (ドライブとも呼ばれます) の Id。 ユーザーがドライブまたは Onedrive のファイルを読み取るかダウンロードするように要求した場合 (例: "マイ ドライブ" でファイルを読み取る、"マイ onedrive" でファイルを読み取る)、documentLibraryId として "me" で送信する必要があります。

moveSmallFile

指定したドキュメント ライブラリにあるファイルを別のフォルダーに移動します。 このツールでは、5 MB 未満のファイルの移動と、同じサイト内の移動のみがサポートされます。 この要求を使用してドライブ間でファイルを移動することはできません。

必須パラメーター:

• documentLibraryId(文字列) – 移動するファイルのドキュメント ライブラリ (ドライブとも呼ばれます) の Id。 ユーザーがドライブまたは Onedrive のファイルを移動するように要求した場合 (例: "マイ ドライブ" でファイルを移動する、"マイ onedrive" でファイルを移動する)、documentLibraryId として "me" で送信する必要があります。
• fileId(文字列) – 移動するファイルの Id
• newParentFolderId(文字列) – ファイルを移動するターゲット フォルダーの ID。 ファイルの元の場所と同じドキュメント ライブラリに存在する必要があります。

getFileOrFolderMetadata

Sharepoint サイトの指定したドキュメント ライブラリからファイルまたはフォルダーのメタデータを取得します。

必須パラメーター:

• FileOrFolderId(文字列) – ファイルまたはフォルダーの Id。 これらは DriveItems とも呼ばれます。 また、その ID は driveItemId と呼ばれることもあります。
• documentLibraryId(文字列) – メタデータが必要なファイルまたはフォルダーのドキュメント ライブラリ (ドライブとも呼ばれます) の Id。 ユーザーがドライブまたは Onedrive でファイルまたはフォルダーを取得するように要求した場合 (例: "マイ ドライブでファイルのメタデータを取得する" や "マイ onedrive でフォルダーのメタデータを取得する") 、documentLibraryId として "me" で送信する必要があります。

createSmallTextFile

5 MB 未満のテキスト ファイルを作成するか、特定のドキュメント ライブラリにアップロードします。 ドキュメント ライブラリを指定しない場合、ユーザーの OneDrive が使用されます。 ファイルを特定のフォルダーにアップロードすることができます。 フォルダーを指定しない場合、ファイルはルート フォルダーにアップロードされます。

必須パラメーター:

• filename (文字列) – 作成するファイルの名前
• contentText (文字列) – 作成するファイルのテキスト コンテンツ
• documentLibraryId (文字列) – ファイルのドキュメント ライブラリ (ドライブとも呼ばれます) の ID。 ユーザーがドライブまたは OneDrive にファイルを作成するように要求した場合 ("マイ ドライブにファイルを作成する" や "マイ onedrive にファイルを作成する" など)、documentLibraryId として "me" を送信します。

オプション パラメーター:

• parentfolderId(文字列、既定値 = "ルート") – 新しいファイルを追加するドライブ内のフォルダー ID。

getFileOrFolderMetadataByUrl

共有 URL からファイルまたはフォルダーのメタデータを取得します。 ファイルにアクセスするための明示的なアクセス許可を持つユーザーのみがメタデータを取得できます。

必須パラメーター:

• fileOrFolderUrl:(文字列) – ファイルまたはフォルダー (DriveItems とも呼ばれます) の URL。 URL は、ユーザーと共有するために使用されません。ファイルへの明示的なアクセス権を既に持っている必要があります。

shareFileOrFolder

共有の招待を送信して、指定したドキュメント ライブラリ内のファイルまたはフォルダーに対するアクセス許可を付与します。 ロールの割り当てと受信者への通知をサポートします。

必須パラメーター:

• documentLibraryId: ドキュメント ライブラリ ID (文字列、必須)
• fileOrFolderId: ファイルまたはフォルダー ID (文字列、必須)
• recipientEmails:(string[]、必須) – 招待する受信者のメール アドレス。 少なくとも 1 つの受信者のメールが必要です。

オプション パラメーター:

• ロール(string[]) – 受信者に割り当てるロール。 指定できる値: 読み取り、書き込み (書き込みでは読み取りアクセスと書き込みアクセスの両方が許可されます)。 指定しない場合は、読み取りロールが既定値になります。
• sendInvitation(bool、既定値 = true) – 共有の招待を送信するかどうかを示します。 指定しない場合、true が既定値になります。
• メッセージ(文字列、既定値 = "これが協力しているファイルです。") – 招待メールに含めるカスタム メッセージ。 指定しない場合、標準メッセージが既定値になります。

getFolderChildren

ドキュメント ライブラリで指定された親フォルダー内の上位 20 個のファイルとフォルダーを列挙します。 ドキュメント ライブラリを指定しない場合、ユーザーの OneDrive が使用されます。

必須パラメーター:

• documentLibraryId(文字列) – 親フォルダーのドキュメント ライブラリ (ドライブとも呼ばれます) の ID。 ユーザーがドライブまたは OneDrive のフォルダーにあるファイルを取得するように要求した場合 ("マイ ドライブのフォルダーにあるファイルを取得する" や "マイ onedrive のフォルダーにあるファイルを取得する" など)、documentLibraryId として "me" を送信します。

オプション パラメーター:

• parentFolderId:(文字列、既定値 = "ルート") – ファイルとフォルダーがリストされている親フォルダー (DriveItem) の ID。 指定しない場合、ドキュメント ライブラリのルート フォルダーが既定値になります。

エコー

メッセージをクライアントに返送します。

必須パラメーター:

• メッセージ: 返送するメッセージ

setSensitivityLabelOnFile

指定したドキュメント ライブラリのファイルの秘密度ラベルを設定します。

必須パラメーター:

• documentLibraryId(文字列) – ドキュメント ライブラリのドキュメント ライブラリ ID (driveId とも呼ばれます)
• fileId(文字列) – ファイルのファイル ID (driveItemId とも呼ばれます)
• sensitivityLabelId(文字列) – 必須。 割り当てる秘密度ラベルの ID、または秘密度ラベルを削除する空の文字列。

オプション パラメーター:

• assignmentMethod(文字列、既定値 = "privileged") - ドキュメントのラベルの割り当て方法。 ラベルの割り当てが自動、標準、または権限操作 (管理者操作に相当) のいずれかで行われたかを示します。 使用できる値は、standard、privileged、auto、unknownFutureValue です。
• justificationText(文字列、既定値 = "MCPServer によって変更") – オプション。 監査目的の理由テキストであり、ラベルをダウングレードまたは削除する場合に必要です。

getDefaultDocumentLibraryInSite

SharePoint サイトの既定のドキュメント ライブラリ (ドライブとも呼ばれます) を取得します。 サイトを指定しない場合は、ルート サイトが使用されます。

必須パラメーター:

なし

オプション パラメーター:

• siteId: サイト ID (既定値: ルート)

主な機能

フォルダー管理

• 名前の競合を自動的に解決するフォルダーの作成
• フォルダーの子を列挙 (上位 20)
• フォルダー間でのファイルの移動 (同じサイト内)

ファイル操作

• 小さいテキスト ファイルを作成してアップロード (< 5 MB)
• テキスト ファイルの読み取りとダウンロード
• ファイルとフォルダの名称変更
• ファイルとフォルダーを削除する
• ID または URL でファイルとフォルダーのメタデータを取得

サイトとライブラリの検出

• 検索クエリで SharePoint サイトを検索
• サイト内のドキュメント ライブラリを一覧表示
• 既定のドキュメント ライブラリを取得

共有とアクセス許可

• ロールの割り当てでファイルとフォルダーを共有
• カスタム メッセージを使用して共有の招待を送信
• 明示的なアクセス許可によるアクセスの制御

セキュリティとコンプライアンス

• ファイルに秘密度ラベルを設定
• 権限、標準、自動の割り当て方法のサポート
• コンプライアンス監査の理由テキスト

統合

• OneDrive と SharePoint Online のサポート
• テナント固有のサーバー接続
• ファイルとフォルダーの DriveItem 抽象化

ノート

1. 既定のドキュメント ライブラリは 'me' (ユーザーの OneDrive) です
2. 既定の親フォルダーは 'ルート' です
3. 数値サフィックスで解決されたフォルダー名の競合
4. ファイルの移動は同じサイト内で 5 MB 未満に制限されます
5. 共有 URL には明示的なアクセス許可が必要です
6. DriveItems は、ファイルとフォルダーの両方を表します
7. フォルダーの子リストの上限 20