Microsoft SharePoint
Microsoft SharePointのサイト、ドキュメントライブラリ、リスト、ページを照会・管理できます。組織のSharePointに保存されたドキュメントをAIエージェントが直接検索して活用できます。
主要機能
- SharePointサイトおよびドキュメントライブラリの参照
- ファイル/フォルダの読み取り、作成、移動、コピー、削除
- 共有リンクの生成および招待の送信
- リストの作成およびアイテムのCRUD
- サイトページの照会および作成
- KQL構文によるコンテンツ検索
- ごみ箱アイテムの照会および復元
基本情報
認証方式
OAuth 2.0 (Microsoft Entra ID)
読み取り専用アクセス
SharePoint接続を作成または編集する際にRead-only Accessを選択すると、閲覧専用の権限で接続できます。読み取り専用アクセスでは、ファイル、フォルダ、リスト、サイトページの確認と検索はできますが、新規作成、変更、削除はできません。
- Read-only Accessを選択すると、接続に表示されるツール一覧も閲覧ツールに更新されます。
- ファイルの作成・変更・削除、共有、リスト・ページの作成、ごみ箱からの復元が必要な場合は、読み取り専用アクセスをオフにして再認証してください。
権限について
接続したMicrosoft 365アカウントには、使用するSharePointリソースへの権限が必要です。読み取り専用アクセスでは閲覧権限のみ、ファイルやリストを変更するには該当する書き込み権限が必要です。
SharePointに接続するにはMicrosoft 365アカウントが必要です。権限設定については、組織のMicrosoft 365管理者にお問い合わせください。
サポートするMCPツール
読み取り専用アクセスで使用できるツール
読み取り専用アクセスを選択すると、次の閲覧ツールのみ使用できます。
findSite、getSite: サイトの検索と詳細情報の確認listDocumentLibraries: ドキュメントライブラリ一覧の確認listFolderContents、getItemInfo、readFile: ファイルとフォルダの確認、ファイル内容の読み取りlistLists、queryListItems: リストとリストアイテムの確認getPages: サイトページの確認searchContent: サイト、リストアイテム、ファイルの検索
ファイルの作成・変更・削除や共有など、データを変更するツールは読み取り専用アクセスでは表示されません。
サイト管理
findSite
ユーザーがアクセス可能なSharePointサイトを検索します。検索クエリなしで呼び出すと、アクセス可能な上位サイト一覧を返します。
getSite
サイトID、特殊パス(例:root)、またはhostname:path形式でサイトの詳細情報を照会します。includeSubsitesを使用するとサブサイト一覧も返します。
ドキュメントライブラリ
listDocumentLibraries
SharePointサイトのドキュメントライブラリ一覧を照会します。defaultOnlyをtrueに設定するとデフォルトのドキュメントライブラリのみ返します。
ファイルおよびフォルダ
listFolderContents
ドキュメントライブラリ内のフォルダのファイルおよびサブフォルダ一覧を照会します。最大20件返します。
getItemInfo
ファイルまたはフォルダのメタデータを照会します。includeVersionsでバージョン履歴、includePermissionsで共有権限情報を含めて照会できます。
readFile
ドキュメントライブラリからファイル内容を読み取ります。テキストとバイナリコンテンツを自動的に検出します。バイナリ/画像ファイルはsaveToTempを使用してaip-temp:// URIとして保存できます。
createFileOrFolder
ドキュメントライブラリにファイルまたはフォルダを作成します。isFolder=trueでフォルダを作成し、ファイルはencodingをtext(デフォルト)またはbase64で指定してコンテンツをアップロードします。
manageItem
ファイルまたはフォルダを管理します。サポートするアクション:
rename: 名前変更(newNameが必要)move: 移動(newParentFolderIdが必要)copy: コピー(newParentFolderIdが必要)delete: 削除
shareItem
ファイルまたはフォルダの共有リンクを生成するか、メールで招待を送信します。
- 共有リンク:
type(view/edit)とscope(organization/anonymous)を指定 - メール招待:
emailアドレスを入力
リスト
createList
サイトに新しいSharePointリストを作成します。表示名とリストテンプレートタイプを指定します。
listLists
サイトのSharePointリスト一覧を照会します。listIdとincludeColumns/includeContentTypesを指定すると特定リストのスキーマ詳細を照会できます。
queryListItems
リストアイテムを照会します。itemIdで単一アイテムを照会するか、ODataフィルター/select/expandを使用して複数アイテムをクエリできます。
saveListItem
リストアイテムを作成または更新します。itemIdを省略すると新しいアイテムを作成し、入力すると既存アイテムを更新します。Key/Valueフィールド形式を使用します。
deleteListItem
リストアイテムを削除します。
manageItemComments
リストアイテムのコメントを照会または追加します。commentを省略すると既存コメント一覧を返し、入力すると新しいコメントを追加します。
ページ
createPage
サイトに新しいSharePointモダンページを作成します。タイトルとオプションの説明を指定できます。
getPages
サイトページ一覧を照会します。pageIdを指定すると該当ページのウェブパーツ内容を含む詳細情報を返します。
検索
searchContent
KQL(Keyword Query Language)構文を使用してサイト、リストアイテム、ドライブアイテム全体でコンテンツを検索します。
ごみ箱
manageRecycleBin
サイトのごみ箱の削除されたアイテムを照会または復元します。recycleBinItemIdとaction='restore'を指定すると特定アイテムを復元できます。
使用例
例えば、
プロンプトで「SharePoint営業チームサイトで2025年の売上レポートを見つけて」と入力すると、
LLMはMCPを通じてsearchContentツールを呼び出し、KQL検索を実行します。
ツール呼び出し結果をもとにチャットで回答します。
その他の使用例:
「ドキュメントライブラリにある契約書ファイルの内容を読んで」
「プロジェクトフォルダに『議事録.docx』ファイルを作成して」
「最近削除されたファイル一覧を見せて」
注意事項
- Microsoft 365アカウントと適切なSharePoint権限が必要です。
- ファイル削除時はごみ箱に移動され、
manageRecycleBinで復元できます。