Referenční informace k serveru MCP nástroje seznamů SharePointu

Důležité

Abyste získali přednostní přístup k Microsoft Agentu 365, musíte být součástí programu Frontier Preview. Hranice vás spojuje přímo s nejnovějšími inovacemi umělé inteligence Microsoftu. Verze Preview hranice podléhají stávajícím podmínkám verze Preview vašich smluv se zákazníkem. Vzhledem k tomu, že tyto funkce jsou stále ve vývoji, jejich dostupnost a možnosti se můžou v průběhu času měnit.

Přehled

ID serveru	Zobrazovaný název	Popis
mcp_SharePointListsTools	Microsoft SharePoint Lists MCP Server	Server MCP, který poskytuje sharepointové nástroje Microsoft Graphu pro seznamy Server MCP, který poskytuje sharepointové nástroje Microsoft Graphu pro seznamy

Dostupné nástroje

sharepoint_createList

Vytvořte nový sharepointový seznam na webu.

Povinné parametry

• siteId: Jedinečné ID webu
• displayName: Zobrazovaný název seznamu
• list: Informace o seznamu, jako je šablona (například genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Vytvořte nový sloupec (columnDefinition) v konkrétním sharepointovém seznamu. Musíte zadat id cílového webu a id seznamu a platnou definici sloupce, která určuje název sloupce, zobrazovaný název a přesně jeden typ sloupce (například text, číslo, volba, dateTime, personOrGroup, vyhledávání, logická hodnota nebo hypertextový odkazOrPicture).

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu
• name: API/statický název sloupce (bez mezer, 1–64 znaků)

Volitelné parametry

• displayName: Zobrazované jméno zobrazené uživatelem
• description: Popis sloupce
• enforceUniqueValues: Pokud je true, hodnoty musí být jedinečné
• hidden: Pokud je true, sloupec je skrytý.
• indexováno: Pokud je hodnota true, hodnoty se indexují.
• required: Pokud je hodnota true, je požadována hodnota.
• ReadOnly: Pokud je true, hodnoty nelze změnit.
• text, číslo, volba, logická hodnota, dateTime, personOrGroup, vyhledávání, hypertextový odkazOrPicture: Nastavení typu sloupce (povinné)

sharepoint_createListItem

Umožňuje vytvořit novou položku v sharepointovém seznamu.

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu
• pole: Hodnoty polí pro položku seznamu (mapa klíč/hodnota)

sharepoint_deleteListColumn

Odstraňte existující sloupecDefinition z konkrétního sharepointového seznamu. Zadejte ID webu, listId a columnId. Tato akce trvale odebere sloupec ze schématu seznamu.

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu
• columnId: Jedinečné ID sloupce k odstranění

sharepoint_deleteListItem

Odstranit položku seznamu.

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu
• itemId: Jedinečné ID položky seznamu

Volitelné parametry

• ifMatch: Volitelná ETag pro řízení souběžnosti (např. "*")

sharepoint_editListColumn

Aktualizujte existující sloupecDefinition pro konkrétní sharepointový seznam. Zadejte ID webu, listId a columnId. Tělo je částečné – zahrnout pouze vlastnosti, které chcete změnit (například displayName, description, hidden, required nebo facet settings).

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu
• columnId: Jedinečné ID sloupce, který se má aktualizovat

Volitelné parametry

• displayName: Zobrazované jméno zobrazené uživatelem
• description: Popis sloupce
• hidden: Pokud je true, sloupec je skrytý.
• required: Pokud je hodnota true, je požadována hodnota.
• enforceUniqueValues: Pokud je true, hodnoty musí být jedinečné
• indexováno: Pokud je hodnota true, hodnoty se indexují.
• ReadOnly: Pokud je true, hodnoty nelze změnit.
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Update column type settings

sharepoint_getSiteByPath

Vyřešte sharepointový web pomocí názvu hostitele a relativní cesty k serveru.

Povinné parametry

• název hostitele: Název hostitele tenanta Služby SharePoint (například contoso.sharepoint.com)
• serverRelativePath: Cesta relativní vzhledem k serveru k webu (například weby/marketing)

sharepoint_listListColumns

Definice sloupců seznamu (prostředky columnDefinition) pro konkrétní sharepointový seznam Vyžaduje ID webu a id seznamu. Podporuje parametry OData, jako jsou $select, $top a $skiptoken.

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu

Volitelné parametry

• select: Seznam vlastností oddělených čárkami, které se mají vrátit
• filter: Výraz filtru OData pro omezení výsledků
• orderBy: Seznam vlastností oddělených čárkami, podle
• nahoře: Velikost stránky (1–999)
• skiptoken: Neprůhláskaný token pro stránkování do další sady

sharepoint_listListItems

Seznam položek ze sharepointového seznamu

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu

Volitelné parametry

• expand: Volitelné rozbalení OData (například pole)
• nahoře: Volitelná velikost stránky
• filter: Volitelný výraz filtru OData
• select: Volitelná klauzule OData select

sharepoint_listLists

Zobrazit seznam všech sharepointových seznamů na webu

Povinné parametry

• siteId: Jedinečné ID webu

sharepoint_listSubsites

Umožňuje zobrazit seznam podřízených webů (podřízených webů) pro daný web.

Povinné parametry

• siteId: Jedinečné ID webu

sharepoint_search

Vyhledávání na SharePointu pomocí rozhraní API služby Microsoft Graph Search s typem entityTypes=["web"].

Povinné parametry

• requests: Array of searchRequest objects

Volitelné parametry

• entityTypes: Musí být ["web"] pro vyhledávání na sharepointovém webu.
• dotaz: Dotazování objektu pomocí vyhledávacího řetězce ve stylu KQL
• from: Odsazení na základě nuly prvního výsledku
• size: Počet výsledků, které se mají vrátit (1–50)
• pole: Volitelný seznam polí, která se mají vybrat v odpovědi

13. sharepoint_searchSitesByName

Prohledat sharepointové weby podle zobrazovaného názvu nebo částečné adresy URL (přirozeného jazyka).

Povinné parametry

• search: Zobrazovaný název nebo částečný název nebo adresa URL sharepointového webu, který chcete vyhledat

Volitelné parametry

• consistencyLevel: Vyžaduje Se službou Microsoft Graph (výchozí hodnota: případná)

14. sharepoint_updateListItem

Aktualizujte pole existující položky seznamu.

Povinné parametry

• siteId: Jedinečné ID webu
• listId: Jedinečné ID seznamu
• itemId: Jedinečné ID položky seznamu
• pole: Hodnoty polí, které se mají aktualizovat (částečné)

Volitelné parametry

• ifMatch: Volitelná značka ETag pro řízení souběžnosti (například "*", která se má vynutit)

Klíčové funkce

Správa seznamů

• Vytváření nových sharepointových seznamů pomocí šablon
• Výpis všech seznamů na webu
• Podpora různých šablon seznamů (genericList, documentLibrary, issueTracking)

Sloupec C – Operace

• Vytváření sloupců s více datovými typy (text, číslo, volba, dateTime, personOrGroup, vyhledávání, logická hodnota, hypertextový odkazOrPicture)
• Úprava existujících sloupců
• Odstranění sloupců
• Výpis všech sloupců v seznamu
• Omezení ověřování sloupců a jedinečnosti

Operace s položkami

• Vytvoření položek seznamu s hodnotami polí
• Aktualizace existujících položek seznamu (částečné aktualizace)
• Odstranit položku seznamu.
• Výpis položek s filtrováním a stránkováním
• Řízení souběžnosti prostřednictvím značky ETag

Zjišťování webu

• Vyhledávání webů podle názvu nebo adresy URL
• Řešení webů podle názvu hostitele a cesty
• Výpis podřízených webů
• Vyhledávání ve stylu KQL pomocí rozhraní Microsoft Graph Search API

Podpora dotazů OData

• K výběru vlastností použijte $select.
• K filtrování výsledků použijte $filter.
• K zahrnutí souvisejících entit použijte $expand.
• Výsledky můžete seřadit pomocí $orderby.
• Pro stránkování použijte $top.
• Pomocí $skiptoken můžete procházet velké sady výsledků.

Podpora typu sloupce

• Textové sloupce (jednořádkový nebo víceřádkový, prostý nebo formátovaný text)
• Číselné sloupce (s desetinnými místy, minimálními a maximálními hodnotami)
• Sloupce voleb (zaškrtávací políčka, rozevírací seznam nebo přepínače)
• Logické sloupce.
• Datum / čas, Datum a čas, Pouze datum
• Sloupce osoby nebo skupiny (jeden nebo více výběrů)
• Vyhledávací sloupce (odkaz na jiné seznamy)
• Sloupce hypertextového odkazu nebo obrázku

Poznámky

1. Všechny operace používají rozhraní Microsoft Graph API v1.0.
2. Názvy sloupců musí být 1 až 64 znaků bez mezer.
3. Každý sloupec musí určovat přesně jeden typ sloupce.
4. Řízení souběžnosti je dostupné prostřednictvím hlavičky If-Match .
5. Vyhledávání na webu vyžadují consistencyLevel nastavenou hodnotu eventual.
6. Výsledky hledání jsou omezené na 50 položek na stránku.
7. U sloupců a položek seznamu se podporují částečné aktualizace.