Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
ETagpara 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:
ETagpara 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. -
preferHtmlo 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.
-
ETagsuporte para controle de concorrência nas atualizações.