Compartilhar via


Referência ao servidor MCP do Microsoft Mail

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

Visão geral

ID de servidor Display name Description
mcp_MailTools Servidor MCP de Microsoft Outlook Mail Servidor MCP fornecendo ferramentas Microsoft Graph Mail.

Ferramentas disponíveis

1. mcp_MailTools_graph_mail_createMessage

Crie um rascunho de e-mail. Suporta HTML definindo body.body.contentType = "HTML".

Parâmetros obrigatórios

  • assunto: Assunto da mensagem
  • toRecipients: Array de destinatários com endereços de e-mail
  • corpo: Corpo da mensagem com contentType (Texto/HTML) e conteúdo

Parâmetros opcionais:

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

mcp_MailTools_graph_mail_deleteMessage

Exclua uma mensagem da caixa de correio do usuário logado.

Parâmetros obrigatórios

  • id: ID da mensagem

Parâmetros opcionais:

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

mcp_MailTools_graph_mail_getMessage

Receba uma mensagem por ID da caixa de correio do usuário logado. Use preferHtml para solicitar o corpo do HTML.

Parâmetros obrigatórios

  • id: ID da mensagem

Parâmetros opcionais:

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

mcp_MailTools_graph_mail_listSent

Liste mensagens em Itens Enviados.

Parâmetros opcionais:

  • filtro: filtro OData
  • Busca: Consulta de busca
  • orderby: Ordenar expressão
  • topo: Número de itens a serem devolvidos
  • Selecione os campos a serem retornados.

mcp_MailTools_graph_mail_reply

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

Parâmetros obrigatórios

  • id: ID da mensagem para responder

Parâmetros opcionais:

  • comentário: Texto de resposta
  • mensagem: Substituições opcionais de mensagens
  • preferHtml: Habilitar a formatação HTML
  • cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_replyAll

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

Parâmetros obrigatórios

  • id: ID da mensagem para responder a todos

Parâmetros opcionais:

  • comentário: Texto de resposta
  • mensagem: Substituições opcionais de mensagens
  • preferHtml: Habilitar a 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 no estilo KQL.

Parâmetros obrigatórios

  • solicitações: Array de requisições de busca com entityTypes, query, from, parâmetros size

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

mcp_MailTools_graph_mail_sendDraft

Envie uma mensagem de rascunho existente por ID.

Parâmetros obrigatórios

  • id: Rascunho do ID da mensagem para enviar

mcp_MailTools_graph_mail_sendMail

Ele deve enviar um email como o usuário conectado.

Parâmetros obrigatórios

  • mensagem: Objeto mensagem com assunto, paraDestinatários e corpo
  • assunto: Assunto do e-mail
  • para Recipientes: Principais recipientes
  • corpo: Corpo do e-mail com contentType (Texto/HTML) e conteúdo

Parâmetros opcionais:

  • ccRecipientes: Recipientes cópias carbono
  • bccRecipientes: Recipientes cegos com cópias carbono
  • saveToSentItems: Salvar para Itens Enviados (padrão: 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 obrigatórios

  • id: ID da mensagem

Parâmetros opcionais:

  • assunto: Novo sujeito
  • corpo: Corpo da nova mensagem
  • categorias: Categorias de mensagens
  • importância: Baixo, Normal ou Alto
  • If-Match: ETag para controle de concorrência

Recursos principais

Composição do e-mail

  • Crie rascunho e envie e-mails
  • Suporte a HTML e texto simples
  • Destinatários Cc e Cco
  • Opções de Formatação do .NET

Gerenciamento de e-mails

  • Receber, atualizar e excluir mensagens
  • Funcionalidade de responder e responder a todos
  • Gestão do draft
  • Categorias e configurações de importância

Pesquisa e filtragem

  • Busca de mensagens no estilo KQL
  • Suporte a consultas OData
  • Busca por sujeito, corpo, anexos
  • Paginação e filtragem

Itens de envio

  • Editar mensagens enviadas
  • Salvamento opcional para Itens Enviados
  • Filtrar e pesquisar itens enviados

Notes

  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 busca utiliza a API Microsoft Graph Search com consultas KQL
  5. Mensagens de rascunho podem ser criadas, atualizadas e enviadas separadamente
  6. Suporte ETag para controle de concorrência em atualizações