E-Mail-Referenz (Vorschau)

Note

In diesem Artikel werden Funktionen beschrieben, die in Agents oder Agent-Flows verwendet werden, die von der Standardumgebung unterstützt werden.

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.

Note

Anwendungsspezifische Microsoft 365 MCP-Tools (Copilot, Kalender, Mail, SharePoint, OneDrive, Teams, User und Word) sind ausschließlich für Abwärtskompatibilität gedacht und sollten nicht in Produktionsumgebungen oder neuen Projekten verwendet werden. Für neue Projekte, die Zugriff auf Microsoft 365-Ressourcen benötigen, verwenden Sie Work IQ MCP mit dem GitHub Copilot-Harness. Weitere Informationen finden Sie unter Work IQ MCP in Copilot Studio.

Overview

Server-ID	URL auf Mandantenebene	Anzeigename	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Mail	Werkzeuge für Microsoft Graph-Mail-Operationen, einschließlich des Erstellens, Sendens, Antwortens und Verwaltens von E-Mail-Nachrichten.

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 die Parallelitätssteuerung

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überschreibungen
• 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überschreibungen
• 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 den Parametern entityTypes, query, from, size

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.
• Funktionen „Antworten“ und „Allen antworten“.
• 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.