Dokumentacja serwera MCP narzędzi list programu SharePoint

Ważne

Aby uzyskać wczesny dostęp do programu Microsoft Agent 365, musisz być częścią programu Frontier w wersji zapoznawczej. Usługa Frontier łączy Cię bezpośrednio z najnowszymi innowacjami firmy Microsoft dotyczącymi sztucznej inteligencji. Wersje zapoznawcze platformy Frontier podlegają istniejącym warunkom obowiązywania wersji zapoznawczej umów klienta. Ponieważ te funkcje są nadal opracowywane, ich dostępność i możliwości mogą ulec zmianie w miarę upływu czasu.

Omówienie

Identyfikator serwera	Display name	Podpis
mcp_SharePointListsTools	Program Microsoft SharePoint wyświetla listę programu MCP Server	Serwer MCP udostępniający narzędzia programu Microsoft Graph SharePoint dla list. Serwer MCP udostępniający narzędzia programu Microsoft Graph SharePoint dla list.

Dostępne narzędzia

sharepoint_createList

Utwórz nową listę programu SharePoint w witrynie.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• displayName: nazwa wyświetlana listy
• lista: informacje o liście, takie jak szablon (na przykład genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Utwórz nową kolumnę (columnDefinition) na określonej liście programu SharePoint. Należy podać docelowy identyfikator siteId i listId oraz prawidłową definicję kolumny, która określa nazwę kolumny, nazwę wyświetlaną i dokładnie jeden typ kolumny (taki jak tekst, liczba, wybór, dataTime, personOrGroup, wyszukiwanie, wartość logiczna lub hiperłączeOrPicture).

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy
• name: API/statyczna nazwa kolumny (bez spacji, 1–64 znaki)

Parametry opcjonalne

• displayName: nazwa wyświetlana dla użytkownika
• description: Opis kolumny
• enforceUniqueValues: jeśli wartość true, wartości muszą być unikatowe
• ukryte: jeśli prawda, kolumna jest ukryta
• indeksowane: jeśli wartość true, wartości są indeksowane
• wymagane: jeśli wartość true, wymagana jest wartość
• readOnly: jeśli wartość true, nie można zmienić wartości
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: ustawienia typu kolumny (jeden wymagany)

sharepoint_createListItem

Utwórz nowy element na liście programu SharePoint.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy
• pola: wartości pól dla elementu listy (mapa klucz/wartość)

sharepoint_deleteListColumn

Usuń istniejącą kolumnęDefinition z określonej listy programu SharePoint. Podaj identyfikator siteId, listId i columnId. Ta akcja trwale usuwa kolumnę ze schematu listy.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy
• columnId: unikatowy identyfikator kolumny do usunięcia

sharepoint_deleteListItem

Usuń element listy.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy
• itemId: unikatowy identyfikator elementu listy

Parametry opcjonalne

• ifMatch: opcjonalny element ETag dla kontrolki współbieżności (np. "*")

sharepoint_editListColumn

Zaktualizuj istniejącą kolumnęDefinition na określonej liście programu SharePoint. Podaj identyfikator siteId, listId i columnId. Treść jest częściowa — zawiera tylko właściwości, które chcesz zmienić (takie jak displayName, description, hidden, required lub facet settings).

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy
• columnId: unikatowy identyfikator kolumny do zaktualizowania

Parametry opcjonalne

• displayName: nazwa wyświetlana dla użytkownika
• description: Opis kolumny
• ukryte: jeśli prawda, kolumna jest ukryta
• wymagane: jeśli wartość true, wymagana jest wartość
• enforceUniqueValues: jeśli wartość true, wartości muszą być unikatowe
• indeksowane: jeśli wartość true, wartości są indeksowane
• readOnly: jeśli wartość true, nie można zmienić wartości
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Aktualizowanie ustawień typu kolumny

sharepoint_getSiteByPath

Rozwiąż witrynę programu SharePoint, używając jej nazwy hosta i ścieżki względnej serwera.

Parametry wymagane

• nazwa hosta: nazwa hosta dzierżawy programu SharePoint (na przykład contoso.sharepoint.com)
• serverRelativePath: ścieżka względna serwera do lokacji (na przykład witryny/marketing)

sharepoint_listListColumns

Lista definicji kolumn (columnDefinition resources) dla określonej listy programu SharePoint. Wymaga identyfikatora siteId i identyfikatora listId. Obsługuje parametry OData, takie jak $select, $top i $skiptoken.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy

Parametry opcjonalne

• select: Rozdzielona przecinkami lista właściwości do zwrócenia
• filter: wyrażenie filtru OData w celu ograniczenia wyników
• orderBy: rozdzielona przecinkami lista właściwości do zamówienia według
• top: Rozmiar strony (1–999)
• skiptoken: nieprzezroczystym tokenem stronicowania do następnego zestawu

sharepoint_listListItems

Wyświetlanie listy elementów z listy programu SharePoint.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy

Parametry opcjonalne

• rozwiń: Opcjonalne rozwinięcie OData (na przykład pola)
• góra: Opcjonalny rozmiar strony
• filter: Opcjonalne wyrażenie filtru OData
• select: Opcjonalna klauzula wyboru OData

sharepoint_listLists

Wyświetl listę wszystkich list programu SharePoint w witrynie.

Parametry wymagane

• siteId: unikatowy identyfikator witryny

sharepoint_listSubsites

Wyświetl listę witryn podrzędnych (podwitryn) dla danej witryny.

Parametry wymagane

• siteId: unikatowy identyfikator witryny

sharepoint_search

Wyszukaj program SharePoint przy użyciu interfejsu API wyszukiwania programu Microsoft Graph za pomocą entityTypes=["site"].

Parametry wymagane

• requests: Tablica obiektów searchRequest

Parametry opcjonalne

• entityTypes: musi być ["witryna"] dla wyszukiwania witryn programu SharePoint
• zapytanie: kwerenda obiektu z ciągiem wyszukiwania w stylu KQL
• from: Przesunięcie na podstawie zera pierwszego wyniku
• rozmiar: liczba wyników do zwrócenia (1–50)
• fields: Opcjonalna lista pól do wybrania w odpowiedzi

13. sharepoint_searchSitesByName

Wyszukaj witryny programu SharePoint według nazwy wyświetlanej lub częściowego adresu URL (języka naturalnego).

Parametry wymagane

• wyszukiwanie: nazwa wyświetlana lub nazwa częściowa/adres URL witryny programu SharePoint do wyszukania

Parametry opcjonalne

• consistencyLevel: wymagane przez program Microsoft Graph (ustawienie domyślne: ostateczne)

14. sharepoint_updateListItem

Aktualizowanie pól istniejącego elementu listy.

Parametry wymagane

• siteId: unikatowy identyfikator witryny
• listId: unikatowy identyfikator listy
• itemId: unikatowy identyfikator elementu listy
• fields: wartości pól do zaktualizowania (częściowe)

Parametry opcjonalne

• ifMatch: Opcjonalny element ETag dla kontrolki współbieżności (na przykład "*", aby wymusić)

Najważniejsze funkcje

Zarządzanie listami

• Tworzenie nowych list programu SharePoint przy użyciu szablonów
• Wyświetlanie listy wszystkich list w witrynie
• Obsługa różnych szablonów list (genericList, documentLibrary, issueTracking)

Kolumna C — Operacje

• Tworzenie kolumn z wieloma typami danych (tekst, liczba, wybór, dataTime, personOrGroup, wyszukiwanie, wartość logiczna, hiperlinkOrPicture)
• Edytowanie istniejących kolumn
• Usuwanie kolumn
• Wyświetlanie listy wszystkich kolumn
• Sprawdzanie poprawności kolumn i ograniczenia unikatowości

Operacje na elementach

• Tworzenie elementów listy z wartościami pól
• Aktualizowanie istniejących elementów listy (aktualizacje częściowe)
• Usuń element listy.
• Elementy listy z filtrowaniem i stronicowaniem
• Kontrolka współbieżności za pośrednictwem elementu ETag

Odnajdywanie witryn

• Wyszukaj witryny według nazwy lub adresu URL
• Rozpoznawanie witryn według nazwy hosta i ścieżki
• Wyświetl podwitryny
• Wyszukiwanie w stylu KQL za pomocą interfejsu API wyszukiwania programu Microsoft Graph

Obsługa zapytań OData

• Użyj $select, aby wybrać właściwości.
• Użyj $filter, aby filtrować wyniki.
• Użyj $expand, aby uwzględnić powiązane jednostki.
• Użyj $orderby, aby posortować wyniki.
• Użyj $top na potrzeby stronicowania.
• Użyj $skiptoken, aby stronicować duże zestawy wyników.

Obsługa typów kolumn

• Kolumny tekstowe (pojedynczy wiersz lub wielowierszowy, zwykły lub sformatowany tekst).
• Kolumny liczbowe (z miejscami dziesiętnymi, minimalnymi i maksymalnymi wartościami).
• Kolumny wyboru (pola wyboru, lista rozwijana lub przyciski radiowe).
• Kolumny logiczne.
• Data i godzina, data i godzina, tylko data
• Kolumny osoby lub grupy (wybór pojedynczy lub wielokrotny).
• Kolumny odnośników (odwołują się do innych list).
• Kolumny hiperłącza lub obrazu.

Uwagi

1. Wszystkie operacje używają interfejsu API programu Microsoft Graph w wersji 1.0.
2. Nazwy kolumn muszą zawierać od 1 do 64 znaków bez spacji.
3. Każda kolumna musi określać dokładnie jeden typ kolumny.
4. Kontrolka współbieżności jest dostępna za pośrednictwem nagłówka If-Match .
5. Wyszukiwanie witryn wymaga consistencyLevel ustawienia .eventual
6. Wyniki wyszukiwania są ograniczone do 50 elementów na stronę.
7. Aktualizacje częściowe są obsługiwane w przypadku kolumn i elementów listy.