Referência ao servidor Microsoft Mail MCP

Importante

É necessário fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Descrição geral

ID do servidor	Nome a apresentar	Descrição
mcp_MailTools	Microsoft Outlook Mail MCP Server	Servidor MCP que fornece ferramentas Microsoft Graph Mail.

Ferramentas disponíveis

1. mcp_MailTools_graph_mail_createMessage

Crie um rascunho de email. Suporta HTML definindo body.body.contentType = "HTML".

Parâmetros necessários

• assunto: Assunto da mensagem
• toDestinatários: Conjunto de destinatários com endereços de email
• corpo: Corpo da mensagem com contentType (Texto/HTML) e conteúdo

Parâmetros opcionais

• preferHtml: Definido para true para conteúdo HTML
• cabeçalhos: Cabeçalhos adicionais opcionais

mcp_MailTools_graph_mail_deleteMessage

Apague uma mensagem da caixa de correio do utilizador iniciado sessão.

Parâmetros necessários

• id: ID da mensagem

Parâmetros opcionais

• If-Match: ETag opcional para controlo de concorrência

mcp_MailTools_graph_mail_getMessage

Receba uma mensagem por ID da caixa de correio do utilizador iniciado. Use preferHtml para solicitar o corpo do HTML.

Parâmetros necessários

• id: ID da mensagem

Parâmetros opcionais

• select: cláusula select de OData
• expandir: cláusula OData expandir
• preferHtml: Formato do corpo do Request HTML
• cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_listSent

Lista mensagens em Itens Enviados.

Parâmetros opcionais

• filtro: filtro OData
• Pesquisa: Consulta de pesquisa
• orderby: Ordenar expressão
• topo: Número de itens a devolver
• select: Campos a devolver

mcp_MailTools_graph_mail_reply

Envie uma resposta a uma mensagem existente. Suporta HTML via preferHtml ou headers.

Parâmetros necessários

• id: ID da mensagem para responder

Parâmetros opcionais

• comentário: Responder texto
• mensagem: Substituições opcionais de mensagens
• preferHtml: Ativar formatação HTML
• cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_replyAll

Envie uma resposta geral a uma mensagem existente. Suporta HTML via preferHtml ou headers.

Parâmetros necessários

• id: ID da mensagem para responder a todos

Parâmetros opcionais

• comentário: Responder texto
• mensagem: Substituições opcionais de mensagens
• preferHtml: Ativar formatação HTML
• cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_searchMessages

Pesquise mensagens do Outlook usando a API Microsoft Graph Search com consultas ao estilo KQL.

Parâmetros necessários

• pedidos: Array de pedidos de pesquisa com parâmetros entityTypes, query, from, size

Suporta pesquisa no conteúdo, assunto, corpo e anexos da mensagem.

mcp_MailTools_graph_mail_sendDraft

Envie uma mensagem de rascunho existente por ID.

Parâmetros necessários

• id: Rascunhar o ID da mensagem a enviar

mcp_MailTools_graph_mail_sendMail

Envie um email como utilizador iniciado sessão.

Parâmetros necessários

• mensagem: Objeto mensagem com assunto, paraDestinatários e corpo
• assunto: Assunto do email
• a Destinatários: Principais recipientes
• corpo: Corpo do email com contentType (Texto/HTML) e conteúdo

Parâmetros opcionais

• ccDestinatários: Recipientes de cópias carbono
• BCCRecipientes: Destinatários cegos em cópias carbono
• saveToSentItems: Guardar para Itens Enviados (por defeito: true)
• preferHtml: Forçar a renderização HTML
• cabeçalhos: Cabeçalhos HTTP adicionais opcionais

10. mcp_MailTools_graph_mail_updateMessage

Atualize as propriedades mutáveis de uma mensagem (por exemplo, assunto, corpo, categorias).

Parâmetros necessários

• id: ID da mensagem

Parâmetros opcionais

• assunto: Novo sujeito
• corpo: Corpo da nova mensagem
• categorias: Categorias de mensagens
• Importância: Baixa, Normal ou Alta
• If-Match: ETag para controlo de concorrência

Funcionalidades principais

Composição do e-mail

• Crie rascunho e envie emails
• Suporte a HTML e texto simples
• Destinatários do To, CC e BCC
• Opções de formatação

Gestão de email

• Receber, atualizar e eliminar mensagens
• Funcionalidade de responder e responder a todos
• Gestão de ativos
• Categorias e definições de importância

Filtragem de pesquisa

• Pesquisa de mensagens ao estilo KQL
• Suporte para consultas OData
• Pesquisa por sujeito, corpo, anexos
• Paginação e filtragem

Sentitems

• Lista de mensagens enviadas
• Gravação opcional para Itens Enviados
• Filtrar e pesquisar itens enviados

Notas

1. Todas as operações utilizam a API Microsoft Graph Mail
2. Conteúdo HTML requer contentType = "HTML" no corpo
3. Cabeçalho preferHtml solicita formato do corpo HTML
4. A pesquisa utiliza a API Microsoft Graph Search com consultas KQL
5. As mensagens de rascunho podem ser criadas, atualizadas e enviadas separadamente
6. Suporte ETag para controlo de concorrência em atualizações