次の方法で共有

SharePoint Lists Tools MCP サーバー リファレンス

重要

Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

概要

サーバー ID 表示名称 プロパティ
mcp_SharePointListsTools Microsoft SharePoint リスト MCP サーバー リスト用の Microsoft Graph SharePoint ツールを提供する MCP サーバー。 リスト用の Microsoft Graph SharePoint ツールを提供する MCP サーバー。

使用可能なツール

sharepoint_createList

サイトに新しい SharePoint リストを作成します。

必須パラメーター

  • siteId: サイトの一意の ID
  • displayName: リストの表示名
  • list: テンプレートなどのリスト情報 (genericList、documentLibrary、issueTracking など)

sharepoint_createListColumn

特定の SharePoint リストに新しい列 (columnDefinition) を作成します。 対象の siteId と listId、列の名前、表示名、および正確に 1 つの列タイプ (text、number、choice、dateTime、personOrGroup、lookup、boolean、または 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_deleteListColumn

特定の SharePoint リストから既存の columnDefinition を削除します。 siteId、listId、columnId を指定します。 この操作により、列がリスト スキーマから完全に削除されます。

必須のパラメーター:

  • siteId: サイトの一意の ID
  • listId: リストの一意の ID
  • columnId: 削除する列の一意の ID

sharepoint_deleteListItem

リスト項目を削除します。

必須のパラメーター:

  • siteId: サイトの一意の ID
  • listId: リストの一意の ID です
  • itemId: リスト項目の一意の ID

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

  • ifMatch: 並行制御のためのオプションの ETag (例: "*")

sharepoint_editListColumn

特定の SharePoint リストから既存の columnDefinition を更新します。 siteId、listId、columnId を指定します。 本文は部分的なものです - 変更するプロパティのみを含めてください (displayName、description、hidden、required、またはファセット設定など)。

必須のパラメーター:

  • 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

Microsoft Graph Search API 使用して、entityTypes=[「site」] で SharePoint を検索します。

必須のパラメーター:

  • requests: searchRequest オブジェクトの配列

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

  • entityTypes: SharePoint サイト検索では ["site"] である必要があります
  • query: KQL スタイルの検索文字列を持つクエリ オブジェクト
  • from: 最初の結果の 0 から始まるオフセット
  • size: 返す結果の数 (1 ～ 50)
  • fields: 応答で選択するフィールドのオプションのリスト

13. sharepoint_searchSitesByName

表示名または部分的 URL (自然言語) で SharePoint サイトを検索します。

必須のパラメーター:

  • search: 検索対象の SharePoint サイトの表示名または部分的な名前/URL

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

  • consistencyLevel: Microsoft Graph で必須 (既定値: 最終的)

14. sharepoint_updateListItem

既存のリスト アイテムのフィールドを更新します。

必須のパラメーター:

  • siteId: サイトの一意の ID
  • listId: リストの一意の ID です
  • itemId: リスト項目の一意の ID
  • fields: 更新するフィールドの値 (部分)

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

  • ifMatch: コンカレンシー制御の省略可能な ETag (強制する場合の "*" など)

主な機能

リストの管理

  • テンプレートを使用して新しい SharePoint リストを作成する
  • サイト上のすべてのリストを表示する
  • さまざまなリスト テンプレート (genericList、documentLibrary、issueTracking) のサポート

列の操作

  • 複数のデータ型 (テキスト、数値、選択肢、dateTime、personOrGroup、lookup、boolean、hyperlinkOrPicture) を含む列を作成する
  • 既存の列の編集
  • 列の削除
  • リスト内のすべての列を一覧表示する
  • 列の検証と一意性の制約

項目の操作

  • フィールド値でリスト項目を作成する
  • 既存のリスト項目を更新する (部分的な更新)
  • リスト項目の削除
  • フィルターと改ページ付きのリスト項目
  • ETag によるコンカレンシー制御

サイトの検出

  • 名前または URL でサイトを検索する
  • ホスト名とパスでサイトを解決する
  • サブサイトの一覧表示
  • Microsoft Graph Search API を使用した KQL スタイルの検索

OData クエリのサポート

  • $select を使用してプロパティを選択します。
  • $filter を使用して結果をフィルター処理します。
  • $expand を 使用して関連エンティティを含めます。
  • $orderby を使用して結果を並べ替えます。
  • 改ページに $top を使用します。
  • $skiptoken を使用して、大きな結果セットをページングします。

列タイプのサポート

  • テキスト列 (単一行または複数行、プレーンテキスト、リッチ テキスト)。
  • 数値列 (小数点以下の桁数、最小値、最大値を含む)。
  • 選択肢列 (チェックボックス、ドロップダウン、またはラジオ ボタン)。
  • ブール値の列。
  • DateTime 列 (日付のみ、または日時)。
  • ユーザーまたはグループの列 (1 つまたは複数の選択)。
  • 列の参照 (他のリストを参照)。
  • ハイパーリンクまたは写真列。

ノート

  1. すべての操作は Microsoft Graph API v1.0 を使用します
  2. 列名は、スペースのない 1 ～ 64 文字にする必要があります。
  3. 各列には、1 つの列タイプを指定する必要があります。
  4. コンカレンシー制御は、If-Match ヘッダーを使用して利用できます。
  5. サイト検索には、consistencyLevel を eventual に設定する必要があります。
  6. 検索結果は、1 ページあたり 50 項目に制限されます。
  7. 列とリスト項目に対して部分更新がサポートされています。
  • Last updated on