Referência do Work IQ Mail (versão prévia)

Importante

Esta é uma versão preliminar do recurso.

  • Microsoft libera recursos de visualização antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer comentários.
  • Os recursos de visualização têm funcionalidade restrita e não são destinados ao uso de produção.
  • A Microsoft pode alterar os nomes e os parâmetros das ferramentas MCP em versão prévia. Evite dependências codificadas. A Microsoft mantém suporte a cenários.
  • Os recursos de visualização estão sujeitos a Microsoft termos de uso complementares.

Overview

ID de servidor URL no nível do locatário Nome de exibição Description
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools
Work IQ Mail Servidor MCP fornecendo ferramentas de email do Microsoft Graph.

Ferramentas disponíveis

mcp_MailTools_graph_mail_createMessage

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

Parâmetros requeridos:

  • 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

Exclui uma mensagem da caixa de correio do usuário conectado.

Parâmetros requeridos:

  • id: ID da mensagem

Parâmetros opcionais:

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

mcp_MailTools_graph_mail_getMessage

Recupera uma mensagem pelo ID da caixa de correio do usuário conectado. Use preferHtml para solicitar o corpo HTML.

Parâmetros requeridos:

  • id: ID da mensagem

Parâmetros opcionais:

  • select: cláusula de seleção de OData
  • expand: cláusula expand OData
  • preferHtml: Solicitar formato de corpo em HTML
  • cabeçalhos: Cabeçalhos HTTP opcionais

mcp_MailTools_graph_mail_listSent

Liste mensagens nos 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 requeridos:

  • id: ID da mensagem para responder

Parâmetros opcionais:

  • comentário: Texto de resposta
  • message: substituições de mensagem opcionais
  • 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 requeridos:

  • id: ID da mensagem para responder a todos

Parâmetros opcionais:

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

mcp_MailTools_graph_mail_searchMessages

Pesquise mensagens do Outlook usando a API de Pesquisa do Microsoft Graph com consultas no estilo KQL (linguagem de consulta de palavra-chave).

Parâmetros requeridos:

  • requests: matriz de solicitações de pesquisa com parâmetros de entityTypes, consulta, início, tamanho

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 requeridos:

  • id: Rascunho do ID da mensagem para enviar

mcp_MailTools_graph_mail_sendMail

Envie um email como o usuário conectado.

Parâmetros requeridos:

  • Mensagem: Objeto mensagem com assunto, toRecipients, e corpo
  • assunto: Assunto do e-mail
  • para destinatários: Principais destinatários
  • corpo: Corpo do e-mail com tipo de conteúdo (Texto/HTML) e conteúdo

Parâmetros opcionais:

  • ccRecipients: destinatários de cópia
  • bccRecipients: destinatários de cópia oculta
  • saveToSentItems: Salvar em 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

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

Parâmetros requeridos:

  • 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

Características principais

Composição do e-mail

  • Criar rascunhos e enviar emails
  • Suporte a HTML e texto simples
  • Destinatários Para, Cc e Cco
  • Opções Avançadas de Formatação

Gerenciamento de e-mails

  • Obter, atualizar e excluir mensagens.
  • Funcionalidade de responder e responder a todos.
  • Gerenciamento de rascunho.
  • Configurações de categoria e importância.

Pesquisa e filtragem

  • Pesquisa de mensagens no estilo KQL.
  • Suporte à consulta OData.
  • Pesquise entre assunto, corpo e anexos.
  • Paginação e filtragem.

Itens enviados

  • Listar mensagens enviadas.
  • Gravação opcional em itens enviados.
  • Filtrar e pesquisar itens enviados.

Notes

  • Todas as operações usam a API Mail do Microsoft Graph.
  • O conteúdo HTML requer contentType = "HTML" no corpo.
  • preferHtml o cabeçalho solicita o formato do corpo HTML.
  • A pesquisa usa a API de Pesquisa do Microsoft Graph com consultas KQL.
  • As mensagens de rascunho podem ser criadas, atualizadas e enviadas separadamente.
  • ETag suporte para controle de concorrência nas atualizações.