Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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:
ETagopcional 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:
ETagpara 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. -
preferHtmlo 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.
-
ETagSuporte para controlo de concorrência em atualizações.