Informazioni di riferimento su IQ Mail di lavoro (anteprima)

Importante

Si tratta di una funzionalità di anteprima.

  • Microsoft rilascia funzionalità di anteprima prima di una versione ufficiale, in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.
  • Le funzionalità di anteprima hanno funzionalità limitate e non sono destinate all'uso in produzione.
  • Microsoft potrebbero modificare i nomi e i parametri degli strumenti MCP in anteprima. Evitare le dipendenze codificate in modo rigido. Microsoft mantiene il supporto per questo scenario.
  • Le funzionalità di anteprima sono soggette a Microsoft condizioni supplementari per l'utilizzo.

Overview

ID del server URL a livello di tenant Nome visualizzato Description
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools		 Work IQ Mail Server MCP che fornisce Microsoft Graph strumenti di posta elettronica.

Strumenti disponibili

mcp_MailTools_graph_mail_createMessage

Crea una bozza di messaggio e-mail. Supporta l'HTML impostando body.body.contentType = "HTML".

Parametri obbligatori:

  • subject: oggetto del messaggio
  • toRecipients: matrice di destinatari con indirizzi e-mail
  • body: corpo del messaggio con contentType (Testo/HTML) e contenuto

Parametri facoltativi:

  • preferHtml: imposta su true per il contenuto HTML
  • headers: intestazioni aggiuntive facoltative

mcp_MailTools_graph_mail_deleteMessage

Elimina un messaggio dalla cassetta postale dell'utente connesso.

Parametri obbligatori:

  • id: ID messaggio

Parametri facoltativi:

  • If-Match: Opzionale ETag per il controllo della concorrenza

mcp_MailTools_graph_mail_getMessage

Ottiene un messaggio in base all'ID dalla cassetta postale dell'utente connesso. Usare preferHtml per richiedere il corpo di HTML.

Parametri obbligatori:

  • id: ID messaggio

Parametri facoltativi:

  • select: clausola di selezione OData
  • expand: clausola di espansione OData
  • preferHtml: formato del corpo HTML della richiesta
  • headers: intestazioni HTTP facoltative

mcp_MailTools_graph_mail_listaInviati

Elenca i messaggi negli elementi inviati.

Parametri facoltativi:

  • filter: filtro OData
  • search: query di ricerca
  • orderby: espressione di ordinamento
  • top: numero di elementi da restituire
  • select: campi da restituire

mcp_MailTools_graph_mail_reply

Invia una risposta a un messaggio esistente. Supporta HTML tramite preferHtml o headers.

Parametri obbligatori:

  • id: ID messaggio a cui rispondere

Parametri facoltativi:

  • comment: testo della risposta
  • message: sovrascrittura facoltativa del messaggio
  • preferHtml: abilita la formattazione HTML
  • headers: intestazioni HTTP facoltative

mcp_StrumentiDiPosta_grafico_posta_rispondiATutti

Invia a tutti una risposta a un messaggio esistente. Supporta HTML tramite preferHtml o headers.

Parametri obbligatori:

  • id: ID messaggio per 'rispondi a tutti'

Parametri facoltativi:

  • comment: testo della risposta
  • message: sovrascrittura facoltativa del messaggio
  • preferHtml: abilita la formattazione HTML
  • headers: intestazioni HTTP facoltative

mcp_MailTools_graph_mail_searchMessages

Eseguire ricerche nei messaggi di Outlook usando l'API di ricerca di Microsoft Graph con query nello stile di Keyword Query Language (KQL).

Parametri obbligatori:

  • Richieste: Array di richieste di ricerca con entityTypesparametri di dimensione , query, from

Supporta la ricerca di contenuto, oggetto, corpo e allegati dei messaggi

mcp_MailTools_graph_mail_sendDraft

Invia una bozza di messaggio esistente tramite ID.

Parametri obbligatori:

  • id: ID della bozza del messaggio da inviare

mcp_MailTools_graph_mail_sendMail

Invia un messaggio di posta elettronica come utente connesso.

Parametri obbligatori:

  • Messaggio: Messaggio con oggetto, toRecipients, e corpo
  • subject: Oggetto del messaggio e-mail
  • toRecipients: destinatari principali
  • body: corpo dell'e-mail con contentType (Testo/HTML) e contenuto

Parametri facoltativi:

  • ccRecipients: destinatari in copia per conoscenza
  • bccRecipients: destinatari in copia nascosta
  • saveToSentItems: Salva sugli oggetti inviati (predefinito: vero)
  • preferHtml: forza il rendering HTML
  • headers: intestazioni HTTP aggiuntive facoltative

10. mcp_MailTools_graph_mail_updateMessage

Aggiorna le proprietà modificabili di un messaggio, ad esempio l'oggetto, il corpo e le categorie.

Parametri obbligatori:

  • id: ID messaggio

Parametri facoltativi:

  • subject: nuovo oggetto
  • body: nuovo corpo del messaggio
  • categorie: categorie di messaggi
  • importance: Bassa, Normale o Alta
  • If-Match:ETag per il controllo della concorrenza

Funzionalità principali

Scrivere posta elettronica

  • Creare bozze e inviare messaggi di posta elettronica
  • Supporto HTML e testo normale
  • Destinatari A, CC e CCN
  • Opzioni di formattazione avanzata

Gestione e-mail

  • Ottenere, aggiornare ed eliminare messaggi.
  • Funzionalità di rispondi e rispondi a tutti.
  • Gestione delle bozze
  • Impostazioni di categoria e importanza.

Ricerca e filtro

  • Ricerca di messaggi in stile KQL.
  • Supporto delle query OData.
  • Cerca nell'oggetto, nel corpo e negli allegati.
  • Impaginazione e filtro.

Sentitems

  • Elencare i messaggi inviati.
  • Salvataggio facoltativo per gli elementi inviati.
  • Filtrare e cercare gli elementi inviati.

Notes

  • Tutte le operazioni utilizzano l'API di posta di Microsoft Graph.
  • Il contenuto HTML richiede contentType = "HTML" nel corpo.
  • preferHtml l'intestazione richiede il formato HTML per il corpo del messaggio.
  • La ricerca usa l'API di ricerca di Microsoft Graph con query KQL.
  • I messaggi bozza possono essere creati, aggiornati e inviati separatamente.
  • ETag supporta il controllo della concorrenza negli aggiornamenti.
  • Last updated on