Work IQ Mail Reference (Vorschau)

Important

Dies ist eine Vorschaufunktion.

  • Microsoft veröffentlicht Vorschaufeatures vor einer offiziellen Version, sodass Kunden frühzeitig Zugriff erhalten und Feedback geben können.
  • Vorschaufeatures verfügen über eingeschränkte Funktionen und sind nicht für die Produktionsverwendung vorgesehen.
  • Microsoft könnte die Namen und Parameter von Vorschau-MCP-Tools ändern. Vermeiden Sie hartcodierte Abhängigkeiten. Microsoft behält die Szenariounterstützung bei.
  • Vorschaufunktionen unterliegen den ergänzenden Nutzungsbedingungen von Microsoft.

Übersicht

Server-ID URL auf Mandantenebene Anzeigename Description
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools		 Work IQ Mail MCP-Server, der Microsoft Graph E-Mail-Tools bereitstellt.

Verfügbare Tools

mcp_MailTools_graph_mail_createMessage

Einen E-Mail-Entwurf erstellen. Unterstützt HTML durch Einstellung body.body.contentType = "HTML".

Erforderliche Parameter:

  • Betreff: Nachrichtenbetreff
  • toRecipients: Array von Empfängern mit E-Mail-Adressen
  • body: Nachrichtentext mit contentType (Text/HTML) und Inhalt

Optionale Parameter:

  • preferHtml: Für HTML-Inhalt auf „true“ festgelegt
  • Kopfzeile: Optionale zusätzliche Kopfzeilen

mcp_MailTools_graph_mail_deleteMessage

Löscht eine Nachricht aus dem Postfach des angemeldeten Benutzers.

Erforderliche Parameter:

  • id: Nachrichten-ID

Optionale Parameter:

  • If-Match: Optional ETag für Nebenläufigkeitskontrolle

mcp_MailTools_graph_mail_getMessage

Ruft anhand der ID eine Nachricht aus dem Postfach des angemeldeten Benutzers ab. Verwenden Sie preferHtml, um den HTML-Body anzufordern.

Erforderliche Parameter:

  • id: Nachrichten-ID

Optionale Parameter:

  • Auswählen: OData-Auswahlklausel
  • Erweitern: OData-Erweiterungsklausel
  • preferHtml: HTML-Textkörperformat anfordern
  • Kopfzeilen: Optionale HTTP-Kopfzeilen

mcp_MailTools_graph_mail_listGesendet

Listen Sie Nachrichten in den gesendeten Einträgen auf.

Optionale Parameter:

  • Filter: OData-Filter
  • Suche: Suchabfrage
  • orderby: Sortierkriterium
  • Oberste: Anzahl der Elemente, die zurückgegeben werden sollen
  • Auswählen: Zurückzugebende Felder

mcp_MailTools_graph_mail_reply

Senden Sie eine Antwort auf eine bestehende Nachricht. Unterstützt HTML über preferHtml oder headers.

Erforderliche Parameter:

  • ID: Nachrichten-ID für die Antwort

Optionale Parameter:

  • Kommentar: Antworttext
  • Nachricht: Optionale Nachrichtenüberschreibung
  • preferHtml: Aktivieren der HTML-Formatierung
  • Kopfzeilen: Optionale HTTP-Kopfzeilen

mcp_MailTools_graph_mail_replyAll

Senden Sie allen eine Antwort auf eine bestehende Nachricht. Unterstützt HTML über preferHtml oder headers.

Erforderliche Parameter:

  • ID: Nachrichten-ID für die Antwort an alle

Optionale Parameter:

  • Kommentar: Antworttext
  • Nachricht: Optionale Nachrichtenüberschreibung
  • preferHtml: Aktivieren der HTML-Formatierung
  • Kopfzeilen: Optionale HTTP-Kopfzeilen

mcp_MailTools_graph_mail_searchMessages

Durchsuchen von Outlook-Nachrichten mithilfe Microsoft Graph Such-API mit KQL-Formatabfragen (Keyword Query Language).

Erforderliche Parameter:

  • Anfragen: Array von Suchanfragen mit entityTypes, Abfrage, from, Size-Parameter

Unterstützt das Durchsuchen von Nachrichteninhalten, Betreff, Textkörper und Anlagen

mcp_MailTools_graph_mail_sendDraft

Senden Sie einen vorhandenen Nachrichtenentwurf über die ID.

Erforderliche Parameter:

  • ID: Entwurf der zu sendenden Nachrichten-ID

mcp_MailTools_graph_mail_sendMail

Senden Sie eine E-Mail als angemeldeter Benutzer.

Erforderliche Parameter:

  • Nachricht: Nachrichtenobjekt mit Betreff, toRecipients und Inhalt
  • Betreff: E-Mail-Betreff
  • toRecipients: Primäre Empfänger
  • body: E-Mail-Text mit contentType (Text/HTML) und Inhalt

Optionale Parameter:

  • ccRecipients: Carbon-Copy-Empfänger
  • bccRecipients: Blindkopie-Empfänger
  • saveToSentItems: Speichere in gesendete Elemente (Standard: ja)
  • preferHtml: Erzwingen des HTML-Renderings
  • Kopfzeile: Optionale zusätzliche HTTP-Kopfzeilen

10. mcp_MailTools_graph_mail_updateMessage

Aktualisiert die veränderbaren Eigenschaften einer Nachricht, z. B. Betreff, Textkörper und Kategorien.

Erforderliche Parameter:

  • id: Nachrichten-ID

Optionale Parameter:

  • Betreff: Neuer Betreff
  • Textkörper: Neuer Nachrichtentext
  • Kategorien: Nachrichtenkategorien
  • Wichtigkeit: Niedrig, Normal oder Hoch
  • If-Match:ETag für Konkurrenzkontrolle

Wichtigste Funktionen

E-Mail-Komposition

  • Erstellen von Entwürfen und Senden von E-Mails
  • HTML- und Nur-Text-Unterstützung
  • An-, CC‑ und BCC-Empfänger
  • Umfangreiche Formatierungsoptionen

E-Mail-Verwaltung

  • Abrufen, Aktualisieren und Löschen von Nachrichten.
  • Antworten- und Allen-antworten-Funktion.
  • Entwurfsverwaltung.
  • Kategorie- und Wichtigkeitseinstellungen.

Suchen und Filtern

  • Nachrichtensuche im KQL-Stil.
  • OData-Abfrageunterstützung.
  • Suchen Sie nach Betreff, Textkörper und Anlagen.
  • Paginierung und Filterung.

Sentitems

  • Gesendete Nachrichten auflisten.
  • Optionales Speichern im Ordner „Gesendete Elemente“۔
  • Filtern und Durchsuchen von gesendeten Elementen

Hinweise

  • Alle Vorgänge verwenden Microsoft Graph Mail-API.
  • HTML-Inhalt erfordert contentType = "HTML" im Textkörper.
  • preferHtml Header fordert HTML-Textkörperformat an.
  • Suche verwendet Microsoft Graph Such-API mit KQL-Abfragen.
  • Entwurfsnachrichten können separat erstellt, aktualisiert und gesendet werden.
  • ETag Unterstützung für parallele Kontrolle über Updates.
  • Last updated on