Udostępnij przez

Dokumentacja serwera MICROSOFT Mail 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_MailTools Microsoft Outlook Mail MCP Server Serwer MCP dostarczający narzędzia Microsoft Graph Mail.

Dostępne narzędzia

1. mcp_MailTools_graph_mail_createMessage

Utwórz roboczą wiadomość e-mail. Obsługuje kod HTML przez ustawienie body.body.contentType = "HTML".

Parametry wymagane

  • temat: Temat wiadomości
  • toRecipients: Tablica adresatów z adresami e-mail
  • treść: treść wiadomości z elementem contentType (Tekst/HTML) i zawartością

Parametry opcjonalne

  • preferHtml: ustaw wartość true dla zawartości HTML
  • nagłówki: opcjonalne dodatkowe nagłówki

mcp_MailTools_graph_mail_deleteMessage

Usuń wiadomość ze skrzynki pocztowej zalogowanego użytkownika.

Parametry wymagane

  • id: Identyfikator komunikatu

Parametry opcjonalne

  • Dopasowanie warunkowe: opcjonalny element ETag dla kontrolki współbieżności

mcp_MailTools_graph_mail_getMessage

Pobierz wiadomość według identyfikatora ze skrzynki pocztowej zalogowanego użytkownika. Użyj metody preferHtml, aby zażądać treści HTML.

Parametry wymagane

  • id: Identyfikator komunikatu

Parametry opcjonalne

  • select: OData select, klauzula
  • expand: OData expand, klauzula
  • preferHtml: żądanie formatu treści HTML
  • nagłówki: opcjonalne nagłówki HTTP

mcp_MailTools_graph_mail_listSent

Wyświetlanie listy komunikatów w elementach wysłanych.

Parametry opcjonalne

  • filter: filtr OData
  • wyszukiwanie: zapytanie wyszukiwania
  • orderby: wyrażenie sortowania
  • top: liczba elementów do zwrócenia
  • select: Pola do zwrócenia

mcp_MailTools_graph_mail_reply

Wyślij odpowiedź na istniejącą wiadomość. Obsługuje kod HTML za pośrednictwem metody preferHtml lub headers.

Parametry wymagane

  • id: Identyfikator wiadomości, na który ma odpowiadać

Parametry opcjonalne

  • komentarz: Tekst odpowiedzi
  • komunikat: opcjonalne przesłonięcia komunikatów
  • preferHtml: włączanie formatowania HTML
  • nagłówki: opcjonalne nagłówki HTTP

mcp_MailTools_graph_mail_replyAll

Wyślij odpowiedź do istniejącej wiadomości. Obsługuje kod HTML za pośrednictwem metody preferHtml lub headers.

Parametry wymagane

  • id: Identyfikator wiadomości do odpowiedzi na wszystko

Parametry opcjonalne

  • komentarz: Tekst odpowiedzi
  • komunikat: opcjonalne przesłonięcia komunikatów
  • preferHtml: włączanie formatowania HTML
  • nagłówki: opcjonalne nagłówki HTTP

mcp_MailTools_graph_mail_searchMessages

Wyszukiwanie komunikatów programu Outlook przy użyciu interfejsu API wyszukiwania programu Microsoft Graph za pomocą zapytań w stylu KQL.

Parametry wymagane

  • requests: Tablica żądań wyszukiwania z parametrami entityTypes, query, from, size

Obsługuje wyszukiwanie zawartości wiadomości, tematu, treści i załączników

mcp_MailTools_graph_mail_sendDraft

Wyślij istniejącą wersję roboczą wiadomości według identyfikatora.

Parametry wymagane

  • id: Identyfikator komunikatu roboczego do wysłania

mcp_MailTools_graph_mail_sendMail

Wyślij wiadomość e-mail jako zalogowanego użytkownika.

Parametry wymagane

  • message: Obiekt komunikatu z tematem, toRecipients i treścią
  • temat: Temat wiadomości e-mail
  • toRecipients: Adresaci podstawowi
  • treść: Treść wiadomości e-mail z elementem contentType (Tekst/HTML) i zawartością

Parametry opcjonalne

  • ccRecipients: Odbiorcy kopii dwutlenku węgla
  • bccRecipients: Niewidomi odbiorcy kopii węgla
  • saveToSentItems: Zapisz w pozycji Elementy wysłane (wartość domyślna: true)
  • preferHtml: Wymuszanie renderowania HTML
  • nagłówki: opcjonalne dodatkowe nagłówki HTTP

10. mcp_MailTools_graph_mail_updateMessage

Zaktualizuj właściwości modyfikowalne wiadomości (na przykład temat, treść, kategorie).

Parametry wymagane

  • id: Identyfikator komunikatu

Parametry opcjonalne

  • temat: Nowy temat
  • treść: Nowa treść wiadomości
  • kategorie: Kategorie wiadomości
  • ważność: Niska, Normalna lub Wysoka
  • Dopasowanie warunkowe: ETag dla kontrolki współbieżności

Kluczowe cechy i funkcje

Kompozycja wiadomości e-mail

  • Tworzenie wersji roboczej i wysyłanie wiadomości e-mail
  • Obsługa kodu HTML i zwykłego tekstu
  • Adresaci do, DW i BCC
  • Opcje formatowania

Zarządzanie pocztą e-mail

  • Pobieranie, aktualizowanie i usuwanie komunikatów
  • Funkcje odpowiedz i odpowiedz wszystkim
  • Zarządzanie składnikami majątku
  • Ustawienia kategorii i ważności

Filtrowanie wyszukiwania

  • Wyszukiwanie komunikatów w stylu KQL
  • Obsługa zapytań OData
  • Wyszukiwanie między tematem, treścią, załącznikami
  • Stronicowanie i filtrowanie

Sentitems

  • Lista wysłanych wiadomości
  • Opcjonalne zapisywanie elementów wysłanych
  • Filtrowanie i wyszukiwanie wysłanych elementów

Uwagi

  1. Wszystkie operacje używają interfejsu API poczty programu Microsoft Graph
  2. Zawartość HTML wymaga właściwości contentType = "HTML" w treści
  3. Format treści nagłówka preferHtml żąda kodu HTML
  4. Wyszukiwanie używa interfejsu API wyszukiwania programu Microsoft Graph z zapytaniami KQL
  5. Wersje robocze wiadomości można tworzyć, aktualizować i wysyłać oddzielnie
  6. Obsługa elementu ETag na potrzeby kontroli współbieżności aktualizacji
  • Last updated on