注
この MCP サーバーは、2026 年 3 月 13 日以降非推奨です。 新しい SharePoint MCP サーバーを使用してください。
重要
Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 Frontierはマイクロソフトの最新のAIイノベーションと直接つながります。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。
概要
| サーバー ID | 表示名称 | 説明 |
|---|---|---|
mcp_SharePointListsTools |
Microsoft SharePoint の MCP サーバーの一覧 | リスト用のMicrosoft Graph SharePointツールを提供する MCP サーバー。 |
使用可能なツール
SharePoint_リスト作成
サイトに新しいSharePointリストを作成します。
必須パラメーター
- siteId: サイトの一意の ID
- displayName: リストの表示名
-
リスト: テンプレートなどの情報リスト(例:
genericList、documentLibrary、issueTracking)
sharepoint_createListColumn
特定のSharePointリストに新しい列 (columnDefinition) を作成します。 ターゲットのsiteIdとlistIdを指定し、列名、表示名、そしてテキスト、数字、選択、 dateTime、 personOrGroup、ルックアップ、ブール値、 hyperlinkOrPictureのいずれか一つの列タイプを含む有効な列定義を提供しなければなりません。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID です
- name: API/列の静的名 (スペースなし、1 ~ 64 文字)
オプション パラメーター:
- displayName: ユーザー向けの表示名
- description: 列の説明
- enforceUniqueValues: true の場合、値は一意である必要があります
- hidden: true の場合、列は非表示になります
- indexed: true の場合、値はインデックス付けされます
- required: true の場合は値が必要です
- readOnly: true の場合、値を変更できません
- text、number、choice、boolean、dateTime、personOrGroup、lookup、hyperlinkOrPicture: 列タイプの設定 (いずれかが必須)
sharepoint_createListItem
SharePointリストに新しい項目を作成します。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID です
- fields: リスト項目のフィールド値 (キー/値マッピング)
SharePoint_リスト列削除
既存の columnDefinition を特定のSharePoint リストから削除します。
siteId、listId、columnIdを提供しましょう。 この操作により、列がリスト スキーマから完全に削除されます。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID
- columnId: 削除する列の一意の ID
sharepoint_deleteListItem (リストアイテムを削除)
リスト項目を削除します。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID です
- itemId: リスト項目の一意の ID
オプション パラメーター:
-
ifMatch: 並行制御のためのオプション
ETag(例:「*」)。
SharePoint_リスト列編集
特定のSharePointリストの既存のcolumnDefinitionを更新します。
siteId、listId、columnIdを提供しましょう。 ボディは部分的です。変更したいプロパティ( displayName、説明、非表示、必須設定、ファセット設定など)のみを含みます。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID
- columnId: 更新する列の一意の ID
オプション パラメーター:
- displayName: ユーザー向けの表示名
- description: 列の説明
- hidden: true の場合、列は非表示になります
- required: true の場合は値が必要です
- enforceUniqueValues: true の場合、値は一意である必要があります
- indexed: true の場合、値はインデックス付けされます
- readOnly: true の場合、値を変更できません
- text, number、choice、dateTime、personOrGroup、lookup、hyperlinkOrPicture: 列タイプの設定を更新します
sharepoint_getSiteByPath
ホスト名とサーバー相対パスを使用して、SharePoint サイトを解決します。
必須のパラメーター:
- hostname: SharePoint テナントのホスト名 (例: contoso.sharepoint。com)
- serverRelativePath: サイトへのサーバー相対パス (サイト/マーケティングなど)
sharepoint_listListColumns
特定のSharePoint リストの列定義 (columnDefinition リソース) を一覧表示します。
siteIdとlistIdが必要です。
$select、$top、$skiptokenなどの OData パラメーターをサポートします。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID です
オプション パラメーター:
- select: 返すプロパティのカンマ区切りのリスト
- filter: OData フィルター式を使用して結果を制限する
- orderBy: 並べ替え対象のプロパティのカンマ区切りのリスト
- top: ページ サイズ (1 ~ 999)
- skiptoken: 次のセットへ進むための不透明トークン
sharepoint_listListItems
SharePoint リストのアイテムを一覧表示します。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID です
オプション パラメーター:
- expand: 省略可能な OData 展開 (フィールドなど)
- top: 省略可能なページ サイズ
- filter: 省略可能な OData フィルター式
- select: OData のオプションの select 句
sharepoint_listLists
サイト上のすべてのSharePointリストを一覧表示します。
必須のパラメーター:
- siteId: サイトの一意の ID
sharepoint_listSubsites
特定のサイトの子サイト (サブサイト) を一覧表示します。
必須のパラメーター:
- siteId: サイトの一意の ID
sharepoint_search
entityTypes=["site"] で Microsoft Graph Search API を使用してSharePointを検索します。
必須のパラメーター:
- requests: searchRequest オブジェクトの配列
オプション パラメーター:
-
entityTypes: SharePoint サイト検索には [
site] にする必要があります - クエリ: キーワードクエリ言語(KQL)スタイルの検索文字列を持つクエリオブジェクト
- from: 最初の結果の 0 から始まるオフセット
- size: 返す結果の数 (1 ~ 50)
- fields: 応答で選択するフィールドのオプションのリスト
sharepoint_searchSitesByName(SharePoint サイトを名前で検索)
SharePointサイトを表示名または部分的な URL (自然言語) で検索します。
必須のパラメーター:
- search: 検索するSharePointサイトの表示名、名前の一部、またはURL
オプション パラメーター:
- consistencyLevel: Microsoft Graph で必須 (既定値: 最終的)
14. SharePoint_updateListItem
既存のリスト アイテムのフィールドを更新します。
必須のパラメーター:
- siteId: サイトの一意の ID
- listId: リストの一意の ID です
- itemId: リスト項目の一意の ID
- fields: 部分的に更新するフィールドの値
オプション パラメーター:
-
ifMatch: 並行制御に使用されるオプションの
ETag(例:「*」で強制)
主な機能
リスト管理
- テンプレートを使用して新しいSharePoint リストを作成する
- サイト上のすべてのリストを表示する
- さまざまなリストテンプレート(
genericList、documentLibrary、issueTracking)のサポート
列の操作
- 複数のデータタイプ(テキスト、数字、選択、
dateTime、personOrGroup、ルックアップ、ブール数、hyperlinkOrPicture)で列を作成します - 既存の列の編集
- 列の削除
- リスト内のすべての列を一覧表示する
- 列の検証と一意性の制約
アイテムの操作
- フィールド値でリスト項目を作成する
- 既存のリスト項目を更新する (部分的な更新)
- リスト項目の削除
- フィルターと改ページ付きのリスト項目
- 並行制御
ETag
遺跡発見
- 名前または URL でサイトを検索する
- ホスト名とパスでサイトを解決する
- サブサイトの一覧表示
- Microsoft Graph Search API を使用した KQL スタイルの検索
OData クエリのサポート
-
$selectを使用してプロパティを選択する -
$filterを使用して結果をフィルター処理する -
$expandを使用して関連テーブルを含める -
$orderbyを使用して結果を並べ替える - ページ分割には
$topを使用する -
$skiptokenを使用して大きな結果セットをページングする
カラムタイプのサポート
- テキストカラム(単行または多行、プレーンテキストまたはリッチテキスト)
- 数列(小数点、最小値、最大値を含む)
- 選択列(チェックボックス、ドロップダウン、またはラジオボタン)
- ブール列
-
DateTime列(日付のみまたは日付と時間) - 個人またはグループ列(単一または複数選択)
- 検索列(他のリストを参照)
- ハイパーリンクや画像コラム
ノート
- すべての操作で Microsoft Graph API v1.0 が使用されます
- 列名は1文字から64文字までで、スペースは入れません
- 各列は正確に1種類の列タイプを指定しなければなりません
- 並行制御は
If-Matchヘッダーを通じて可能です - サイト検索には
consistencyLevelがeventualに設定されている必要があります - 検索結果は1ページあたり50項目までに制限されています
- 列やリスト項目の部分的な更新もサポートされています