Referencia de Work IQ Mail (versión preliminar)

Importante

Esta es una característica en vista previa.

• Microsoft publica versiones preliminares de las características antes de un lanzamiento oficial para que los clientes puedan tener acceso anticipado y enviar comentarios.
• Las características en versión preliminar tienen funcionalidad restringida y no están pensadas para su uso en producción.
• Microsoft podría cambiar los nombres y parámetros de la herramienta MCP en versión preliminar. Evite las dependencias codificadas de forma rígida. Microsoft mantiene la compatibilidad con escenarios.
• Las características en versión preliminar se rigen por los términos de uso adicionales de Microsoft.

Overview

Id. de servidor	Dirección URL a nivel de arrendatario	Nombre para mostrar	Description
mcp_MailTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MailTools	Correo de Trabajo IQ	Servidor MCP que proporciona herramientas de correo Microsoft Graph.

Herramientas disponibles

mcp_MailTools_graph_mail_createMessage

Crear un borrador de correo electrónico. Soporta HTML configurando body.body.contentType = "HTML".

Parámetros requeridos:

• subject: asunto del mensaje
• toRecipients: matriz de destinatarios con direcciones de correo electrónico
• body: cuerpo del mensaje con contentType (Texto/HTML) y contenido

Parámetros opcionales:

• preferHtml: establézcalo en true para el contenido HTML
• headers: encabezados adicionales opcionales

mcp_MailTools_graph_mail_deleteMessage

Elimina un mensaje del buzón del usuario que ha iniciado sesión.

Parámetros requeridos:

• id: Id. de mensaje

Parámetros opcionales:

• If-Match: Opcional para controlar la concurrencia

mcp_MailTools_graph_mail_getMessage

Obtiene un mensaje por Id. del buzón del usuario que ha iniciado sesión. Utiliza preferHtml para solicitar el cuerpo HTML.

Parámetros requeridos:

• id: Id. de mensaje

Parámetros opcionales:

• select: Cláusula select de OData
• expand: cláusula "expand" de OData
• preferHtml: formato de cuerpo HTML de solicitud
• encabezados: encabezados HTTP opcionales

mcp_MailTools_graph_mail_listSent

Haz una lista de mensajes en los elementos enviados.

Parámetros opcionales:

• filter: filtro OData
• search: consulta de búsqueda
• orderby: Expresión de ordenación
• top: Número de elementos que se deben devolver
• select: Campos que devolver

mcp_MailTools_graph_mail_reply

Envía una respuesta a un mensaje existente. Admite HTML a través de preferHtml o headers.

Parámetros requeridos:

• id: Id. de mensaje al que responder

Parámetros opcionales:

• comment: Texto de respuesta
• message: invalidaciones de mensajes opcionales
• preferHtml: Habilitar el formato HTML
• encabezados: encabezados HTTP opcionales

mcp_MailTools_graph_mail_replyAll

Envía una respuesta a todos a un mensaje existente. Admite HTML a través de preferHtml o headers.

Parámetros requeridos:

• id: ID de mensaje para responder a todos

Parámetros opcionales:

• comment: Texto de respuesta
• message: invalidaciones de mensajes opcionales
• preferHtml: Habilitar el formato HTML
• encabezados: encabezados HTTP opcionales

mcp_MailTools_graph_mail_searchMessages

Buscar mensajes de Outlook mediante la API de búsqueda de Microsoft Graph con consultas en estilo de lenguaje de consulta de palabras clave (KQL).

Parámetros requeridos:

• requests: matriz de solicitudes de búsqueda conentityTypes, query, from, size parameters

Admite la búsqueda de contenido de mensajes, asunto, cuerpo y datos adjuntos

mcp_MailTools_graph_mail_sendDraft

Envíe un mensaje de borrador existente por identificador.

Parámetros requeridos:

• id: Borrador del identificador de mensaje que se va a enviar

mcp_MailTools_graph_mail_sendMail

Enviar un correo electrónico como usuario que ha iniciado sesión.

Parámetros requeridos:

• Mensaje: Objeto mensaje con asunto, toRecipients, y cuerpo
• subject: Asunto del correo electrónico
• toRecipients: destinatarios principales
• body: Cuerpo del correo electrónico con contentType (Texto/HTML) y contenido

Parámetros opcionales:

• ccRecipients: destinatarios de copia de carbono
• bccRecipients: destinatarios de copia de carbono ciega
• saveToSentItems: Guardar en los elementos enviados (valor predeterminado: verdadero)
• preferHtml: Forzar representación HTML
• headers: encabezados HTTP adicionales opcionales

10. mcp_MailTools_graph_mail_updateMessage

Actualiza las propiedades mutables de un mensaje, como el asunto, el cuerpo y las categorías.

Parámetros requeridos:

• id: Id. de mensaje

Parámetros opcionales:

• subject: Nuevo asunto
• body: nuevo cuerpo del mensaje
• categories: categorías de mensajes
• importance: Baja, Normal o Alta
• If-Match:ETag para el control de concurrencia

Características clave

Composición del correo electrónico

• Crear borradores y enviar correos electrónicos
• Soporte para HTML y texto plano
• Destinatarios Para, CC y BCC
• Opciones de formato enriquecido

Administración de correo electrónico

• Obtener, actualizar y eliminar mensajes.
• Funcionalidad de respuesta y respuesta a todos.
• Gestión de borradores.
• Configuración de categoría e importancia.

Búsqueda y filtrado

• Búsqueda de mensajes con sintaxis KQL.
• Compatibilidad con consultas de OData.
• Buscar en el asunto, el cuerpo del mensaje y los archivos adjuntos.
• Paginación y filtrado.

Sentitems

• Enumerar mensajes enviados.
• Guardado opcional en elementos enviados.
• Filtre y busque elementos enviados.

Notas

• Todas las operaciones usan Microsoft Graph Mail API.
• El contenido HTML requiere contentType = "HTML" en el cuerpo.
• preferHtml El encabezado solicita el formato HTML para el cuerpo.
• La búsqueda usa Microsoft Graph Search API con consultas KQL.
• Los borradores de mensajes se pueden crear, actualizar y enviar por separado.
• ETag soporte para el control de concurrencia en las actualizaciones.