Referenční informace k serveru Microsoft Outlook Kalendář MCP

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_CalendarTools	Microsoft Outlook Kalendář MCP Server	Server MCP pro nástroje kalendáře. Tento server MCP můžete použít pro operace kalendáře, jako je vytváření, aktualizace, načítání událostí, správa pozvánek a kontrola dostupnosti.

Dostupné nástroje

mcp_CalendarTools_graph_acceptEvent

Přijměte zadanou pozvánku na událost v kalendáři uživatele.

Povinné parametry

• eventId: ID události, která se má přijmout

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• komentář: Volitelný text zahrnutý v odpovědi
• sendResponse: Zda odeslat odpověď organizátorovi

mcp_CalendarTools_graph_cancelEvent

Zrušení události v kalendáři zadaného uživatele a upozorňovat účastníky.

Povinné parametry

• eventId: Jedinečný identifikátor události, která se má zrušit

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• komentář: Nepovinná zpráva o zrušení

mcp_CalendarTools_graph_createEvent

Vytvořte novou událost kalendáře v kalendáři zadaného uživatele. Podporuje opakované události a online schůzky.

Povinné parametry

• předmět: Předmět/název události (neprázdné)
• start: Počáteční časové razítko s dateTime a časovým pásmem
• end: Koncové časové razítko s dateTime a časovým pásmem
• attendees_addresses: Pole e-mailových adres účastníků

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• text: Text události s contentType (Text/HTML) a obsahem
• location: Location with displayName
• attendees_types: Role účastníka (povinné, volitelné, prostředek)
• attendees_names: Zobrazovaná jména účastníků
• recurrence: Způsob opakování a rozsah
• isOnlineMeeting: Nastavení na hodnotu true pro online schůzku
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Povolit návrhy času (výchozí hodnota: true)
• transactionId: Idempotentní identifikátor

mcp_CalendarTools_graph_declineEvent

Odmítne zadanou pozvánku na událost v kalendáři uživatele.

Povinné parametry

• eventId: ID události, která se má odmítnout

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName

• komentář: Volitelný text v odpovědi

• sendResponse: Zda odeslat odpověď

mcp_CalendarTools_graph_deleteEvent

Odstraňte událost z kalendáře zadaného uživatele.

Povinné parametry

• eventId: Jedinečný identifikátor události k odstranění

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Navrhněte časy a místa schůzky na základě dostupnosti organizátora a účastníka.

Povinné parametry

• meetingDuration: Doba trvání schůzky (například PT1H)

Volitelné parametry

• userId: ID organizátora nebo userPrincipalName
• attendees_addresses: E-mailové adresy účastníků
• attendees_types: Typy účastníků
• attendees_names: Zobrazovaná jména účastníků
• timeConstraint: Dostupnost času s timeslots a activityDomain
• locationConstraint: Možnosti umístění
• maxCandidates: Maximální počet návrhů
• isOrganizerOptional: Organizátor volitelný příznak
• returnSuggestionReasons: Include reasons
• minimumAttendeePercentage: Minimální prahová hodnota docházky

mcp_CalendarTools_graph_getEvent

Získá jednu událost kalendáře z kalendáře zadaného uživatele.

Povinné parametry

• eventId: Jedinečný identifikátor události

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• select: OData $select parametr dotazu
• expand: $expand OData pro navigační vlastnosti

mcp_CalendarTools_graph_getSchedule

Získejte plán informací o volném čase pro uživatele, distribuční seznam nebo prostředek.

Povinné parametry

• plány: Adresy SMTP uživatelů nebo prostředků
• startTime: Počáteční čas s dateTime a časovým pásmem
• endTime: Koncový čas s dateTime a timeZone

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• availabilityViewInterval: Délka časového úseku v minutách

mcp_CalendarTools_graph_listCalendarView

Umožňuje načíst výskyty kalendáře v zadaném časovém rozsahu pro uživatele.

Povinné parametry

• startDateTime: Začátek časového rozsahu (ISO 8601)
• endDateTime: Konec časového rozsahu (ISO 8601)

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• top: Maximální počet událostí
• orderby: Order by – klauzule

mcp_CalendarTools_graph_listEvents

Načte seznam událostí z kalendáře zadaného uživatele.

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• startDateTime: Začátek časového rozsahu (ISO 8601)
• endDateTime: Konec časového rozsahu (ISO 8601)
• top: Maximální počet událostí
• filter: Dotaz filtru OData
• orderby: OData order by query

mcp_CalendarTools_graph_updateEvent

Aktualizujte existující událost kalendáře v kalendáři zadaného uživatele.

Povinné parametry

• eventId: Jedinečný identifikátor události

Volitelné parametry

• userId: ID uživatele nebo userPrincipalName
• předmět: Aktualizovaný předmět
• body: Aktualizovaný obsah textu
• start: Aktualizovaný čas zahájení
• end: Aktualizovaný čas ukončení
• umístění: Aktualizované umístění
• attendees_addresses: Aktualizace e-mailů účastníků
• attendees_types: Aktualizované typy účastníků
• attendees_names: Aktualizace jmen účastníků
• isCancelled: Nastavit na hodnotu true pro zrušení
• recurrence: Aktualizovaný způsob opakování

Klíčové funkce

Správa akcí

• Vytvoření, čtení, aktualizace a odstranění
• Přijetí, odmítnutí a zrušení pozvánek
• Podpora opakovaných událostí
• Integrace s online schůzkami (Teams, Skype)

Dostupnost a plánování

• Získání plánů informací o volném čase
• Vyhledání časů schůzek s kontrolou dostupnosti
• Zobrazení kalendáře s filtrováním časového rozsahu
• Analýza dostupnosti účastníků

Správa účastníků

• Správa povinných, nepovinných účastníků a účastníků prostředků
• Podpora návrhů času
• Sledování odpovědí
• Podpora distribučních seznamů

Způsob opakování

• Denní, týdenní, měsíční a roční vzory
• Absolutní a relativní opakování
• Koncové datum nebo počet výskytů
• Specifikace dne v týdnu a měsíci

Online schůzka

• Integrace s Teams pro firmy
• Podpora pro Skype pro firmy
• Podpora Skypu pro spotřebitele
• Generování odkazu na automatickou schůzku

Poznámky

1. Všechna časová razítka používají formát UTC/ISO 8601 s časovým pásmem.
2. Kalendář MCP spoléhá na UserprofileMCP k vyhledání uživatelů v organizaci.
3. E-mail musí mít platný formát.
4. Pole účastníků (adresy, typy, jména) musí být ve stejném pořadí.
5. Online schůzky vyžadují isOnlineMeeting=true a onlineMeetingProvider
6. Opakování vyžaduje objekty vzoru i rozsahu.
7. Časová pásma by měla být konzistentní napříč počátečními a koncovými časy.
8. TransactionId umožňuje vytvoření idempotentní události.