Dokumentacja serwera MICROSOFT Kalendarz Outlook MCP

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_CalendarTools	Microsoft Kalendarz Outlook MCP Server	Serwer MCP dla narzędzi kalendarza. Ten serwer MCP umożliwia wykonywanie operacji kalendarza, takich jak tworzenie, aktualizowanie, pobieranie zdarzeń, zarządzanie zaproszeniami i sprawdzanie dostępności.

Dostępne narzędzia

mcp_CalendarTools_graph_acceptEvent

Zaakceptuj określone zaproszenie zdarzeń w kalendarzu użytkownika.

Parametry wymagane

• eventId: identyfikator zdarzenia do zaakceptowania

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• komentarz: opcjonalny tekst uwzględniony w odpowiedzi
• sendResponse: czy wysłać odpowiedź do organizatora

mcp_CalendarTools_graph_cancelEvent

Anuluj wydarzenie w kalendarzu określonego użytkownika i powiadamiaj uczestników.

Parametry wymagane

• eventId: unikatowy identyfikator zdarzenia do anulowania

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• komentarz: Opcjonalna wiadomość o anulowaniu

mcp_CalendarTools_graph_createEvent

Utwórz nowe zdarzenie kalendarza w kalendarzu określonego użytkownika. Obsługuje zdarzenia cykliczne i spotkania online.

Parametry wymagane

• temat: Temat zdarzenia/tytuł (niepusty)
• start: znacznik czasu rozpoczęcia z datą/godziną i strefą czasową
• koniec: znacznik czasu zakończenia z datą/godziną i strefą czasową
• attendees_addresses: tablica adresów e-mail uczestników

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• treść: Treść zdarzenia z elementem contentType (Tekst/HTML) i zawartością
• location: Lokalizacja z displayName
• attendees_types: Role uczestników (wymagane, opcjonalne, zasób)
• attendees_names: nazwy wyświetlane uczestników
• cykl: wzorzec cyklu i zakres
• isOnlineMeeting: ustaw wartość true dla spotkania online
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Zezwalaj na propozycje czasu (wartość domyślna: true)
• transactionId: identyfikator idempotencji

mcp_CalendarTools_graph_declineEvent

Odrzuć określone zaproszenie zdarzeń w kalendarzu użytkownika.

Parametry wymagane

• eventId: identyfikator zdarzenia do odrzucenia

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName

• komentarz: Opcjonalny tekst w odpowiedzi

• sendResponse: czy wysłać odpowiedź

mcp_CalendarTools_graph_deleteEvent

Usuń zdarzenie z kalendarza określonego użytkownika.

Parametry wymagane

• eventId: unikatowy identyfikator zdarzenia do usunięcia

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugeruj czasy spotkań i lokalizacje na podstawie dostępności organizatora i uczestnika.

Parametry wymagane

• meetingDuration: Czas trwania spotkania (na przykład "PT1H")

Parametry opcjonalne

• userId: identyfikator organizatora lub userPrincipalName
• attendees_addresses: adresy e-mail uczestników
• attendees_types: Typy uczestników
• attendees_names: nazwy wyświetlane uczestników
• timeConstraint: dostępność czasu z przedziałami czasu i aktywnościDomain
• locationConstraint: Opcje lokalizacji
• maxCandidates: Maksymalna sugestia
• isOrganizerOptional: flaga opcjonalna organizatora
• returnSuggestionReasons: uwzględnij przyczyny
• minimumAttendeePercentage: Próg minimalnej frekwencji

mcp_CalendarTools_graph_getEvent

Pobierz jedno zdarzenie kalendarza z kalendarza określonego użytkownika.

Parametry wymagane

• eventId: unikatowy identyfikator zdarzenia

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• select: OData $select parametr zapytania
• rozwiń: $expand OData dla właściwości nawigacji

mcp_CalendarTools_graph_getSchedule

Pobierz harmonogram wolny/zajęty dla użytkownika, listy dystrybucyjnej lub zasobu.

Parametry wymagane

• harmonogramy: adresy SMTP użytkowników lub zasobów
• startTime: godzina rozpoczęcia z datą/godziną i strefą czasową
• endTime: godzina zakończenia z datą/godziną i strefą czasową

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• availabilityViewInterval: długość przedziału czasu w minutach

mcp_CalendarTools_graph_listCalendarView

Pobieranie wystąpień kalendarza w określonym zakresie czasu dla użytkownika.

Parametry wymagane

• startDateTime: początek zakresu czasu (ISO 8601)
• endDateTime: koniec zakresu czasu (ISO 8601)

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• top: Maksymalna liczba zdarzeń
• orderby: Order by, klauzula

mcp_CalendarTools_graph_listEvents

Pobierz listę zdarzeń z kalendarza określonego użytkownika.

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• startDateTime: początek zakresu czasu (ISO 8601)
• endDateTime: koniec zakresu czasu (ISO 8601)
• top: Maksymalna liczba zdarzeń
• filter: zapytanie filtru OData
• orderby: Kolejność OData według zapytania

mcp_CalendarTools_graph_updateEvent

Zaktualizuj istniejące zdarzenie kalendarza w kalendarzu określonego użytkownika.

Parametry wymagane

• eventId: unikatowy identyfikator zdarzenia

Parametry opcjonalne

• userId: identyfikator użytkownika lub userPrincipalName
• temat: Zaktualizowany temat
• treść: Zaktualizowana zawartość treści
• start: zaktualizowany czas rozpoczęcia
• koniec: zaktualizowany czas zakończenia
• lokalizacja: Zaktualizowana lokalizacja
• attendees_addresses: Zaktualizowane wiadomości e-mail uczestników
• attendees_types: Zaktualizowane typy uczestników
• attendees_names: Zaktualizowano nazwy uczestników
• isCancelled: ustaw wartość true, aby anulować
• cykl: zaktualizowany wzorzec cyklu

Kluczowe cechy i funkcje

Zarządzanie wydarzeniami

• Tworzenie, odczyt, aktualizowanie i usuwanie
• Akceptowanie, odrzucanie i anulowanie zaproszeń
• Obsługa zdarzeń cyklicznych
• Integracja ze spotkaniami online (Teams, Skype)

Dostępność i planowanie

• Pobieranie wolnych/zajętych harmonogramów
• Znajdowanie terminów spotkań przy użyciu sprawdzania dostępności
• Widok kalendarza z filtrowaniem zakresu czasu
• Analiza dostępności uczestników

Zarządzanie uczestnikami

• Zarządzanie wymaganymi, opcjonalnymi i uczestnikami zasobów
• Obsługa propozycji czasowych
• Śledzenie odpowiedzi
• Obsługa list dystrybucyjnych

Wzorzec cyklu

• Wzorce dzienne, tygodniowe, miesięczne i roczne
• Cykl bezwzględny i względny
• Data zakończenia lub liczba wystąpień
• Specyfikacje dnia tygodnia i miesiąca

Spotkanie online

• Integracja z usługą Teams dla Firm
• Obsługa Skype dla firm
• Obsługa programu Skype dla konsumentów
• Automatyczne generowanie linku spotkania

Uwagi

1. Wszystkie znaczniki czasu używają formatu UTC/ISO 8601 ze strefą czasową
2. Kalendarz MCP opiera się na UserprofileMCP, aby znaleźć użytkowników w organizacji
3. Adres e-mail musi mieć poprawny format.
4. Tablice uczestników (adresy, typy, nazwy) muszą być w tej samej kolejności
5. Spotkania online wymagają wartości isOnlineMeeting=true i onlineMeetingProvider
6. Cykl wymaga obiektów wzorca i zakresu
7. Strefy czasowe powinny być spójne w godzinach rozpoczęcia i zakończenia
8. TransactionId umożliwia tworzenie zdarzeń idempotentnych