Referência do Work IQ Mail (pré-visualização)

Importante

Esta é uma funcionalidade de pré-visualização.

  • A Microsoft lança funcionalidades de pré-visualização antes do lançamento oficial para que os clientes possam obter acesso antecipado e fornecer feedback.
  • As funcionalidades de pré-visualização têm funcionalidades restritas e não são feitas para uso em produção.
  • A Microsoft pode alterar os nomes e parâmetros das ferramentas MCP de pré-visualização. Evite dependências codificadas de forma rígida. A Microsoft mantém suporte a cenários.
  • As funcionalidades de pré-visualização estão sujeitas a Microsoft termos suplementares de utilização.

Overview

ID do servidor URL ao nível do inquilino Nome de exibição Descrição
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools
Work IQ Mail Servidor MCP que fornece ferramentas de correio Microsoft Graph.

Ferramentas disponíveis

mcp_MailTools_graph_mail_createMessage

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

Parâmetros necessários:

  • Assunto: Assunto da mensagem
  • aos Destinatá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 como verdadeiro para conteúdo HTML
  • Cabeçalhos: Cabeçalhos adicionais opcionais

mcp_MailTools_graph_mail_deleteMessage

Apaga 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 simultaneidade

mcp_MailTools_graph_mail_getMessage

Recebe uma mensagem por ID da caixa de correio do utilizador com sessão iniciada. Utilize preferHtml para solicitar o corpo em HTML.

Parâmetros necessários:

  • ID: ID da Mensagem

Parâmetros opcionais:

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

mcp_MailTools_graph_mail_listSent

Liste mensagens nos Itens Enviados.

Parâmetros opcionais:

  • Filtro: Filtro OData
  • Pesquisa: Consulta de pesquisa
  • Orderby: Expressão de ordenação
  • Máximo: Número de itens a devolver
  • selecionar: 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: Texto de resposta
  • 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 os destinatários

Parâmetros opcionais:

  • Comentário: Texto de resposta
  • 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 linguagem de consulta por palavras-chave (KQL).

Parâmetros necessários:

  • pedidos: matriz de pedidos de pesquisa com os parâmetros entityTypes, consulta, de, tamanho

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

mcp_MailTools_graph_mail_sendDraft

Enviar uma mensagem de rascunho existente por ID.

Parâmetros necessários:

  • ID: Rascunho do ID da mensagem para enviar

mcp_MailTools_graph_mail_sendMail

Enviar um e-mail como o utilizador com sessão iniciada.

Parâmetros necessários:

  • Mensagem: Objeto da mensagem com sujeito, toRecipients, e corpo
  • Assunto: Assunto do correio eletrónico
  • aos Destinatários: Principais recipientes
  • Corpo: Corpo de e-mail com contentType (Texto/HTML) e conteúdo

Parâmetros opcionais:

  • ccRecipients: destinatários em cópia
  • bccRecipients: destinatários em cópia oculta
  • saveToSentItems: Guardar nos itens enviados (por defeito: true)
  • preferHtml: Forçar renderização HTML
  • Cabeçalhos: Cabeçalhos HTTP adicionais opcionais

10. mcp_MailTools_graph_mail_updateMessage

Atualiza as propriedades mutáveis de uma mensagem, como o assunto, corpo e categorias.

Parâmetros necessários:

  • ID: ID da Mensagem

Parâmetros opcionais:

  • Assunto: Novo tema
  • Corpo: Novo corpo da mensagem
  • Categorias: Categorias de mensagens
  • Importância: Baixo, Normal ou Alto
  • If-Match:ETag para controlo da concorrência

Principais características

Composição do e-mail

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

Gestão de email

  • Receber, atualizar e apagar mensagens.
  • Funcionalidade Responder e Responder a Todos.
  • Gestão de rascunhos.
  • Categorias e definições de importância.

Pesquisa e filtragem

  • Pesquisa de mensagens ao estilo KQL.
  • Suporte de consultas OData.
  • Pesquisar no assunto, corpo e anexos.
  • Paginação e filtragem.

Sentitems

  • Lista mensagens enviadas.
  • Guardar opcionalmente nos itens enviados.
  • Filtrar e pesquisar os itens enviados.

Notes

  • Todas as operações utilizam a API Microsoft Graph Mail.
  • O conteúdo HTML requer contentType = "HTML" no corpo.
  • preferHtml o cabeçalho pede formato de corpo HTML.
  • A Search utiliza a API Microsoft Graph Search com consultas KQL.
  • As mensagens de rascunho podem ser criadas, atualizadas e enviadas separadamente.
  • ETag Suporte para controlo de concorrência em atualizações.