Microsoft SharePoint と OneDrive MCP サーバー参照

概要

使用可能なツール

createFolder

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

必須パラメーター:

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

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

• 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を送るのです。

moveSmallFile

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

必須パラメーター:

• documentLibraryId(文字列) – 移動したいファイルのドキュメントライブラリ(ドライブとも呼ばれる)のID。 ユーザーが自分のドライブやOneDriveのファイルを移動するように頼んだときにこのパラメータを使います。 例えば、「Drive 内のファイルを移動する」や「OneDrive のファイルを移動する」といった、 documentLibraryIdとして「me」を送る場合などです。
• fileId(string) – 移動するファイルのID。
• newParentFolderId(文字列) – ファイルを移動するターゲット フォルダーの ID。 ファイルの元の場所と同じドキュメント ライブラリに存在する必要があります。

getFileOrFolderMetadata

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

必須パラメーター:

• FileOrFolderId(文字列) – ファイルまたはフォルダのID 彼らは DriveItemsとも呼ばれます。 彼らのIDは時に driveItemIdと呼ばれることもあります。
• documentLibraryId(文字列) – メタデータが必要なファイルやフォルダのドキュメントライブラリ(ドライブとも呼ばれる)のID。 ユーザーが自分のドライブやOneDriveにファイルやフォルダを取ってほしいと頼んだときにこのパラメータを使いましょう。 例えば、「私のドライブにあるファイルのメタデータを取得する」や「OneDriveのフォルダのメタデータを取得する」といった documentLibraryIdで「me」を送る場合などです。

createSmallTextFile

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

必須パラメーター:

• ファイル名 (文字列)– 作成するファイル名。
• contentText (文字列) – 作成するファイルのテキストコンテンツ。
• documentLibraryId (文字列)– ファイルのドキュメントライブラリ(ドライブとも呼ばれる)のID。 ユーザーが「自分のドライブにファイルを作成」や「OneDriveにファイルを作成」など、ファイルを作成してほしいと言われた場合は、 documentLibraryIdとして「私」を送ってください。

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

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

getFileOrFolderMetadataByUrl

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

必須パラメーター:

• fileOrFolderUrl:(文字列) – ファイルまたはフォルダのURL( DriveItemsとも呼ばれます)。 URLパラメータはオブジェクトをユーザーと共有する権限を与えません。ユーザーはすでにファイルに明示的にアクセスできる必要があります。

shareFileOrFolder

指定されたドキュメントライブラリ内のファイルやフォルダに対して権限を与える共有招待を送信します。 ロールの割り当てと受信者への通知をサポートします。

必須パラメーター:

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

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

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

getFolderChildren

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

必須パラメーター:

• documentLibraryId(文字列) – 親フォルダのドキュメントライブラリ(ドライブとも呼ばれる)のID。 ユーザーが「ドライブ内のフォルダにファイルを取ってほしい」や「OneDriveのフォルダにファイルを取って」といったリクエストを documentLibraryIdにして「私」を送ってください。

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

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

エコー

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

必須パラメーター:

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

setSensitivityLabelOnFile

指定されたドキュメントライブラリからファイルのセンシティビティラベルを設定します。

必須パラメーター:

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

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

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

getDefaultDocumentLibraryInSite

SharePointサイトにデフォルトのドキュメントライブラリ(ドライブとも呼ばれます)を入手してください。 サイトを指定しない場合は、ルート サイトが使用されます。

必須パラメーター:

なし

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

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

主な機能

フォルダー管理

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

ファイル操作

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

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

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

共有とアクセス許可

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

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

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

統合

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

ノート

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