Compartilhar via


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

Importante

  • Este é um recurso em versão preliminar.
  • As versões prévias do recurso não foram criadas para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos estão sujeitos a termos de uso suplementares e são disponibilizados antes de um lançamento oficial, de maneira que os clientes possam ter acesso antecipado e fazer comentários.

Visão geral

ID de servidor Nome de exibição Descrição
mcp_MailTools Email do IQ do Trabalho Servidor MCP fornecendo ferramentas de email do Microsoft Graph.

Observação

  • As conexões existentes que usam versões anteriores de servidores MCP da Microsoft, como o servidor MCP do Microsoft Teams, permanecem com suporte.
  • Para todas as novas conexões, use os servidores MCP mais recentes do Work IQ, como o Work IQ Teams.

Ferramentas disponíveis

mcp_MailTools_graph_mail_createMessage

Crie um rascunho de e-mail. Suporta HTML configurando 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: Opcional ETag 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 de seleção de OData
  • expandir: cláusula de expansão 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 obrigatórios

  • id: ID da mensagem para responder

Parâmetros opcionais:

  • comentário: Texto de resposta
  • mensagem: Sobrescrições opcionais de mensagem
  • 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: Sobrescrições opcionais de mensagem
  • 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 da linguagem de consulta de palavra-chave (KQL).

Parâmetros obrigatórios

  • Pedidos: Array de solicitações de busca com entityTypesparâmetros de , consulta, from, 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 obrigatórios

  • id: Rascunho do ID da mensagem para enviar

mcp_MailTools_graph_mail_sendMail

Envie um email como o usuário conectado.

Parâmetros obrigatórios

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

  • ccDestinatários: Destinatários de cópia conforme
  • bccRecipientes: Recipientes cegos com cópias carbono
  • 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

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 Para, Cc e Cco
  • Opções Avançadas de Formatação

Gerenciamento de e-mails

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

Pesquisa e filtragem

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

Itens enviados

  • Listar mensagens enviadas
  • Opcionalmente salvar em itens enviados
  • Filtrar e pesquisar itens enviados

Notas

  • Todas as operações usam a API de Email do Microsoft Graph
  • Conteúdo HTML requer contentType = "HTML" no corpo
  • preferHtml cabeçalho solicita formato do corpo HTML
  • A pesquisa utiliza a API de Pesquisa Microsoft Graph com consultas KQL.
  • Mensagens de rascunho podem ser criadas, atualizadas e enviadas separadamente
  • ETag Suporte para controle de concorrência em atualizações