Referencia de correo (vista previa)

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Importante

Esta es una característica en vista previa.

• Microsoft publica características en versión preliminar antes de su lanzamiento oficial para que los clientes puedan obtener 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.

Note

Las herramientas MCP específicas de Microsoft 365 (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User y Word) solo están pensadas para fines de compatibilidad hacia atrás y no deben usarse en entornos de producción ni en proyectos nuevos. Para nuevos proyectos que requieren acceso a recursos de Microsoft 365, utiliza Work IQ MCP con el arnés Microsoft Copilot. Para más información, véase Work IQ MCP en Copilot Studio.

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	Mail	Herramientas para operaciones de correo de Microsoft Graph, incluyendo crear, enviar, responder y gestionar mensajes de correo electrónico.

Herramientas disponibles

mcp_MailTools_graph_mail_createMessage

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

Parámetros requeridos:

• asunto: Asunto del mensaje
• toRecipients: Array de destinatarios con direcciones de correo electrónico
• body: Cuerpo del mensaje con contentType (Texto/HTML) y contenido

Parámetros opcionales:

• preferHtml: Ajustado a verdadero para contenido HTML
• Cabeceras: Cabeceras 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 del mensaje

Parámetros opcionales:

• If-Match: Opcional ETag para el control de concurrencia

mcp_MailTools_graph_mail_getMessage

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

Parámetros requeridos:

• id: ID del mensaje

Parámetros opcionales:

• select: Cláusula select de OData
• expand: Cláusula de expansión OData
• preferHtml: Formato del cuerpo de la solicitud HTML
• Cabeceras: Cabeceras HTTP opcionales

mcp_MailTools_graph_mail_listSent

Haz una lista de mensajes en los elementos enviados.

Parámetros opcionales:

• filtro: Filtro OData
• search: Consulta de búsqueda
• orderby: expresión de ordenación
• top: Número de elementos por devolver
• seleccionar: Campos para 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 a responder

Parámetros opcionales:

• comentario: texto de respuesta
• Mensaje: anula el mensaje opcional
• preferHtml: Habilitar el formato HTML
• Cabeceras: Cabeceras 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:

• Comentario: texto de respuesta
• Mensaje: Mensaje opcional de sustitución
• preferHtml: Habilitar el formato HTML
• Cabeceras: Cabeceras 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:

• Solicitudes: Array de solicitudes de búsqueda con entityTypesparámetros query, from y size

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: ID del borrador del mensaje para 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
• Asunto: Asunto del correo electrónico
• toRecipients: Destinatarios principales
• Cuerpo: Cuerpo del correo electrónico con contentType (Texto/HTML) y contenido

Parámetros opcionales:

• ccRecipients: Destinatarios con copia
• bccRecipients: Destinatarios en copia oculta
• saveToSentItems: Guardar en objetos enviados (por defecto: true)
• preferHtml: Forzar el renderizado HTML
• Cabeceras: Cabeceras 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 del mensaje

Parámetros opcionales:

• Asunto: Nuevo asunto
• Cuerpo: Nuevo cuerpo del mensaje
• Categorías: Categorías de mensajes
• Importancia: Bajo, normal o alto
• If-Match:ETag para control de concurrencia

Funciones principales

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.
• La funcionalidad de responder y responder 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 de cuerpo HTML.
• 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 actualizaciones.