SharePoint参照(プレビュー)

Note

本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。

Important

これはプレビュー機能です。

  • Microsoftは、お客様が早期にアクセスしてフィードバックを提供できるように、公式リリースの前にプレビュー機能をリリースします。
  • プレビュー機能は機能が制限されており、運用環境での使用を目的としていません。
  • Microsoftは、プレビュー MCP ツールの名前とパラメーターを変更する可能性があります。 ハードコーディングされた依存関係を回避します。 Microsoftでは、シナリオのサポートが維持されます。
  • プレビュー機能には、Microsoft追加の使用条件が適用されます。

Note

アプリケーション固有のMicrosoft 365 MCPツール(Copilot、カレンダー、Mail、SharePoint、OneDrive、Teams、User、Word)は後方互換性の目的のみを意図しており、本番環境や新規プロジェクトでの使用は推奨されません。 Microsoft 365リソースへのアクセスが必要な新規プロジェクトでは、Microsoft Copilotハーネスを併用したWork IQ MCPをご利用ください。 詳細については、Copilot StudioのWork IQ MCPをご覧ください。

Overview

サーバー ID テナントレベルの URL 表示名 Description
mcp_SharePointRemoteServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/servers/
mcp_SharePointRemoteServer
SharePoint SharePoint運用のためのツール。 このサーバーは、サイト、リスト、リスト アイテム、列、ドキュメント ライブラリ、ファイル、フォルダー、ファイル共有を管理するために使用します。 ファイル操作は、5 MB 以下のファイルに制限されます。

使用可能なツール

findSite

アクセスできるSharePointサイトを検索します。 検索クエリに一致する特定のサイト、またはクエリを指定しない場合は上位 20 の関連サイトを返します。

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

  • searchQuery: 検索クエリ(サイト名の全体または一部)。 上位 20 のアクセス可能なサイトを返すには省略します。

getSiteByPath

正確なホスト名とサーバー相対パスを使用して、SharePoint サイトを解決します。 このメソッドは、完全なサイト URL 構造がある場合にのみ使用します。 サイト名しか知らない場合は、 findSite を使用します。

[Required parameters]\(必須のパラメーター\):

  • ホスト名: 正確なホスト名(例:『contoso.sharepoint.com』)
  • serverRelativePath: サーバー相対パス(例:『sites/Marketing』)。 先頭のスラッシュは省略可能です。

listSubsites

SharePoint サイトのすべてのサブサイト (子サイト) を一覧表示します。

[Required parameters]\(必須のパラメーター\):

  • siteId:親SharePointサイトのID(フォーマット:'hostname, siteCollectionId, webId')

ドキュメントライブラリをサイト内で一覧表示する

指定したSharePoint サイト内のドキュメント ライブラリ (ドライブ) を一覧表示します。

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

  • siteId:SharePointサイトのID(デフォルト:'root')

getDefaultDocumentLibraryInSite(デフォルトのドキュメントライブラリをサイト内で取得する)

SharePoint サイトの既定のドキュメント ライブラリ (ドライブ) を取得します。

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

  • siteId:SharePointサイトのID(デフォルト:'root')

getFolderChildren (フォルダーの子要素を取得)

ドキュメント ライブラリ (ドライブ) 内の指定された親フォルダーに含まれる上位 20 個のファイルとフォルダー (DriveItems) を列挙します。

[Required parameters]\(必須のパラメーター\):

  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID

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

  • parentFolderId: 親フォルダのID(デフォルト:'root')。

ファイルまたはフォルダーを見つける

検索クエリでユーザーがアクセスできるファイルまたはフォルダー (DriveItem) を検索します。 ユーザーがアクセスできるすべてのサイトとドキュメント ライブラリを検索します。

[Required parameters]\(必須のパラメーター\):

  • 検索クエリ: 検索クエリ(ファイル名全体または部分的)

getFileOrFolderMetadata

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

[Required parameters]\(必須のパラメーター\):

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

getFileOrFolderMetadataByUrl (URL からファイルまたはフォルダーのメタデータを取得)

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

[Required parameters]\(必須のパラメーター\):

  • fileOrFolderUrl: ファイルまたはフォルダのURLです。 この URL は、ユーザーと共有するためのアクセス権の付与には使用されません。ユーザーは、あらかじめ明示的にアクセス権を付与されている必要があります。

readSmallTextFile

特定のドキュメントライブラリ(ドライブ)から5MB未満のテキストファイルを読み込み(ダウンロード)します。

[Required parameters]\(必須のパラメーター\):

  • fileId: 読み取りまたはダウンロードするファイル ID (DriveItem) の ID
  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID

readSmallBinaryFile

特定のドキュメント ライブラリ (ドライブ) から 5 MB 未満のバイナリ ファイルを読み取ります。 ファイルの内容は、base64 でエンコードされた文字列として返されます。

[Required parameters]\(必須のパラメーター\):

  • fileId: 読み取りまたはダウンロードするためのファイルID(DriveItem)です
  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID

createSmallTextFile

5MB未満のテキストファイルを特定のドキュメントライブラリ(ドライブ)に作成またはアップロードします。

[Required parameters]\(必須のパラメーター\):

  • ファイル名: 拡張子を含むファイル名。
  • 内容テキスト: ファイルのテキスト内容。
  • documentLibraryId: ドキュメント ライブラリ(ドライブ)の ID

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

  • parentFolderId: 親フォルダのID(デフォルト:'root')。

createSmallBinaryFile

特定のドキュメント ライブラリ (ドライブ) にコンテンツを base64 エンコードして、5 MB 未満のバイナリ ファイルを作成します。

[Required parameters]\(必須のパラメーター\):

  • ファイル名: 拡張子を含むファイル名。
  • base64Content: base64文字列としてエンコードされたバイナリファイルの内容。
  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID

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

  • parentFolderId: 親フォルダのID(デフォルト:'root')。

フォルダーを作成する

指定したドキュメント ライブラリ (ドライブ) 内に新しいフォルダー (DriveItem) を作成します。 同じ名前のフォルダーが存在する場合、システムは数値サフィックス (NewFolder (1) など) を追加します。

[Required parameters]\(必須のパラメーター\):

  • フォルダ名: フォルダ名
  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID

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

  • parentFolderId: 親フォルダのID(デフォルト:'root')。

ファイルまたはフォルダーの名前を変更する

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

[Required parameters]\(必須のパラメーター\):

  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID
  • fileOrFolderId: 名前を変更するファイルまたはフォルダのID
  • newFileOrFolderName: 新しい名前

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

  • etag: 並行制御のためのETag

ファイルまたはフォルダーを削除

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

[Required parameters]\(必須のパラメーター\):

  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID
  • fileOrFolderId: 削除すべきファイルまたはフォルダのID

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

  • etag: 並行制御のためのETag

ファイルまたはフォルダを移動

ファイルまたはフォルダー (DriveItem) を移動先フォルダーに移動します。 SharePoint内の異なるドキュメント ライブラリ (ドライブ) 間での移動をサポートします。 この操作は非同期です。 checkOperationStatusを使用して進行状況を監視します。

[Required parameters]\(必須のパラメーター\):

  • sourcedoclibid: ソースドキュメントライブラリ(ドライブ)のID(ドライブ)
  • sourcefileID: 移動するソースファイルまたはフォルダのID
  • destdoclibid: 宛先ドキュメントライブラリ(ドライブ)のID
  • destfolderid: 宛先フォルダのID(存在している必要があります)

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

  • newfilename: 移動したアイテムの新しい名前

ファイルまたはフォルダをコピー

ファイルまたはフォルダー (DriveItem) をコピー先フォルダーにコピーします。 SharePoint 内のさまざまなドキュメント ライブラリ間でのコピーをサポートします。 この操作は非同期です。 checkOperationStatusを使用して進行状況を監視します。

[Required parameters]\(必須のパラメーター\):

  • sourcedoclibid: ソースドキュメントライブラリ(ドライブ)のID
  • sourcefileid: コピーするソースファイルまたはフォルダのID
  • destdoclibid: 宛先ドキュメントライブラリ(ドライブ)のID
  • destfolderID: 宛先フォルダのID(存在必須)

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

  • newfilename: コピーされたアイテムの新しい名前

操作状況の確認

元の操作から返された操作トークンを使用して、コピーや移動などの非同期操作の状態を確認します。

[Required parameters]\(必須のパラメーター\):

  • operationToken:copyFileOrFolder や moveFileOrFolder のような非同期操作から返される操作トークン

URLからファイルをアップロードする

SharePointまたはOneDrive URL からドキュメント ライブラリ (ドライブ) 内の宛先フォルダーにファイルをアップロードします。 ファイルはソース URL からコピーされるため、元のファイルは変更されません。

[Required parameters]\(必須のパラメーター\):

  • sourceUrl:ソースURL(有効なSharePointまたはOneDrive URLでなければなりません)
  • destinationDocumentLibraryId: 宛先ドキュメントライブラリのID。 ユーザーの OneDrive には me を使用する

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

  • destinationFolderId: 宛先フォルダのID(デフォルト: root)
  • ファイル名: 新しいファイル名; デフォルトでは元のファイル名になります

ファイルまたはフォルダーを共有

指定したドキュメント ライブラリ (ドライブ) 内のファイルまたはフォルダー (DriveItem) に対する読み取りまたは書き込みアクセス許可を付与するための共有の招待を送信します。

[Required parameters]\(必須のパラメーター\):

  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID
  • fileOrFolderId: 共有するファイルまたはフォルダのID
  • 受信者メール: 受信者のメールアドレスの配列
  • 役割: 役割の配列:『read』、『write』(writeは読み取りと書き込みの両方を付与します)

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

  • メッセージ: 招待メール用のカスタムメッセージ(デフォルト: こちらが共同作業中のファイルです。)
  • sendInvitation: 共有招待を送るかどうか(デフォルト:true)

ファイルに機密ラベルを設定する

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

[Required parameters]\(必須のパラメーター\):

  • documentLibraryId: ドキュメントライブラリ(ドライブ)のID
  • fileId: ファイルのID(DriveItem)
  • センシティブラベルId: センシティブラベルのIDか、それを削除するための空文字列

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

  • 割り当てメソッド: 割り当てメソッド:'standard', 'privileged', 'auto', または 'unknownFutureValue'(デフォルト: 'privileged')
  • 正当化テキスト: 監査目的の正当化テキスト; ラベルをダウングレードまたは削除する場合に必須 (デフォルト: 'MCPServer によって変更')

listLists

特定のサイトで使用可能なすべてのSharePointリストを取得します。 サイト内に存在するリストを検出するために使用します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID(フォーマット:'hostname, siteCollectionId, webId')

リストを作成する

サイト内に新しいSharePoint listを作成します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • displayName: 新しいリストのディスプレイ名

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

  • 列: キー-値ペアとしての列の集合: [{ Key: 'JobTitle', Value: 'text' }]。 有効な型: テキスト、複数行テキスト、数値、ブール値、日付時刻、選択、参照、人物またはグループ、ハイパーリンク、通貨、計算式
  • テンプレート: リストテンプレートタイプ(デフォルト:'genericList')。 オプション: genericList、documentLibrary、イベント、タスク、お知らせ、連絡先、リンク、アンケート、issueTracking、discussionBoard

削除リスト

サイトからSharePoint listを削除します。 リスト コンテナー全体とその中のすべての項目を削除します。 この操作を元に戻すことはできません。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId: 削除すべきリストのID

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

  • etag: 並行制御のためのETag

リストへの招待を送信

SharePoint リストに対するアクセス許可を付与するための共有の招待を送信します。

[Required parameters]\(必須のパラメーター\):

  • listId:共有するSharePoint listのID
  • recipientEmails: 受信者のメールアドレスの配列
  • 役割: 役割: 'read' (閲覧のみ)、'contribute' (アイテムの閲覧、追加、更新、削除)、'edit' (リスト構造を含む完全な編集)

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

  • siteUrl:リストを含むSharePointサイトのサイトURL
  • sendEmail: メール通知を送るかどうか(デフォルト:true)

listListItems

特定のSharePoint listから項目 (行/レコード) を取得します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID

getListItem

IDでSharePoint listから単一のアイテム(行またはレコード)を取得します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • itemId: 特定のリスト項目のID

リストアイテムを作成

SharePoint listに新しい項目 (行またはレコード) を作成します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • フィールド: フィールド値のキー-値ペア、例えば [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]。 「タイトル」欄は通常必須です。

リスト項目を更新

SharePoint list内の既存の項目 (行またはレコード) を更新します。 指定されたフィールドのみが更新されます。省略されたフィールドの値は保持されます。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • itemId: 更新対象のアイテムID
  • フィールド: 更新すべきフィールドのキー・値ペア

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

  • etag: 並行制御のためのETag

リスト項目を削除

SharePoint listからアイテム (行またはレコード) を削除します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • itemId: 削除すべきアイテムのID

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

  • etag: 並行制御のためのETag

listColumns

SharePoint listからすべての列を取得します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID

列を作成する

SharePoint listに新しい列を作成します。 テキスト、数値、選択肢、dateTime、ブール値、ユーザー、参照、計算など、多くの列の種類をサポートします。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • 名前: 内部カラム名(プログラム上の識別子)
  • columnType: 列の種類:テキスト、メモ、数字、整数、ブールリアン、dateTime、choice、multichoice、currency、lookup、user、url、calated、term、multiterm、location、geolocation、サムネイル、counter、計算済み、contentTypeId、file、attachment、guid、outcomeChoice、approvalStatus

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

  • columnProperties: 型固有の設定(例:テキストは { "maxLength": 255 } 、選択は { "choices": ["A","B","C"] } )
  • 説明: 列の説明
  • displayName: UIに表示される表示名(デフォルトは「name」)
  • 必須: 列を必須にする(デフォルト:false)
  • 非表示: ビューから列を非表示(デフォルト:false)

列を更新

SharePoint list内の既存の列を更新します。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • columnId: 更新する列のID

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

  • columnType: 列の種類(「columnProperties」を指定する場合は必須)
  • columnProperties: 更新する型固有のプロパティ
  • description: 新しい説明
  • displayName: 新しいディスプレイネーム
  • 非表示: 隠すか表示する列
  • 必須: 欄を必須または任意にする

列を削除

SharePoint listから列を削除します。 警告: この操作により、その列に保存されているすべてのアイテムのデータが削除されます。

[Required parameters]\(必須のパラメーター\):

  • siteId:SharePointサイトのID
  • listId:SharePoint listのID
  • columnId: 削除する列のID

主要な機能

サイト管理

  • 名前でサイトを検索するか、アクセス可能なサイトを参照します。
  • 正確な URL パスでサイトを取得します。
  • 子サイトとサブサイトを一覧表示します。
  • 包括的なサイト階層ナビゲーション。

ドキュメント ライブラリの管理

  • サイト内のすべてのドキュメント ライブラリを一覧表示します。
  • 既定のドキュメント ライブラリを取得します。
  • フォルダの内容(最大20項目)を閲覧できます。
  • フォルダー構造を作成および管理します。

ファイル操作

  • テキストファイルとバイナリファイル(5MB以下)を作成しましょう。
  • テキストとバイナリファイル(5MB以下)を読みます。
  • ファイルとフォルダーを削除、名前変更、移動します。
  • ドキュメント ライブラリ間でファイルとフォルダーをコピーします。
  • SharePointまたはOneDrive URL からファイルをアップロードします。
  • アクセス可能なすべてのサイトのファイルとフォルダーを検索します。
  • ファイルとフォルダーのメタデータを取得します。

非同期操作

  • ドキュメント ライブラリ間でファイルとフォルダーを非同期的にコピーおよび移動します。
  • 操作トークンを使用して非同期操作の状態を確認します。

リスト操作

  • リストの作成、読み取り、および削除。
  • 汎用、ドキュメント ライブラリ、イベント、タスクなど、複数のリスト テンプレートのサポート。
  • ロールベースのアクセス許可を持つリストを共有します。
  • リスト アイテムの作成、読み取り、更新、削除を行って、リスト アイテムを管理します。

列の管理

  • テキスト、メモ、数値、ブール値、dateTime、選択肢、検索、ユーザー、URL、計算など、さまざまな種類の列を作成します。
  • 列のプロパティとメタデータを更新します。
  • 列の要件と可視性を構成します。
  • 型固有の列プロパティを設定します。

共有とアクセス許可

  • ファイル、フォルダー、リストをユーザーと共有します。
  • ロールベースのアクセス制御は、読み取り、書き込み、投稿、編集の各ロールで使用します。
  • 共有用のメール通知。
  • 招待状にカスタムメッセージを入れること。

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

  • 秘密度ラベルを適用および削除します。
  • 標準、特権、自動など、複数の割り当て方法を使用します。
  • 監査の正当な理由をサポートします。
  • eTag でコンカレンシー制御を使用します。

Notes

  • ファイル操作は、アップロードおよびダウンロード用に 5 MB 以下のファイルに制限されます。
  • コピー操作と移動操作は非同期です。 checkOperationStatusを使用して進行状況を監視します。
  • コピー操作と移動操作では、SharePoint内のクロスライブラリ操作がサポートされます。
  • uploadFileFromUrlには有効なSharePointまたはOneDriveの送信元URLが必要です。
  • eTag は、更新と削除のコンカレンシー制御を提供します。
  • 重複するフォルダー名に自動で数字の接尾辞を付与。
  • リストの削除を元に戻すことはできません。
  • 列の削除では、その列に格納されているすべてのデータが削除されます。
  • 検索操作では、既定で上位 20 件の結果が返されます。