Descrição do serviço MCP do Direct Mail - Direct Mail: Central de Documentação do Alibaba Cloud

Nota

O desempenho do serviço MCP do Direct Mail depende das capacidades do seu agente de IA. Otimize o prompt e a base de conhecimento do agente para obter os melhores resultados.

Visão geral

O Model Context Protocol (MCP) é uma interface padronizada para modelos de linguagem grandes e assistentes de IA. Assim como uma porta USB, ele permite que a IA se conecte e opere ferramentas externas para executar tarefas complexas.

O Direct Mail oferece suporte ao MCP. Utilize este protocolo para autorizar um agente de IA a realizar operações e interagir com o Direct Mail por meio de chat.

Capacidades

O servidor STDIO do MCP do Direct Mail fornece ferramentas de consulta e fluxos de trabalho protegidos para envio de e-mails, gerenciamento de modelos, execução de tarefas em lote, gestão de tags e administração de listas de destinatários. Ele utiliza o SDK da Alibaba Cloud.

Nota

O serviço MCP do Direct Mail suporta apenas STDIO, não HTTP. Configure-o através de STDIO ou de um arquivo de configuração JSON.

Configuração

Pré-requisitos

Node.js >=20
Uma conta Alibaba Cloud com o Direct Mail ativado.
Um AccessKey ID e AccessKey Secret do RAM com as permissões necessárias para o Direct Mail.
Recursos do Direct Mail necessários para envio, como endereços de e-mail aprovados, modelos, tags e listas de destinatários.

Este serviço é um processo STDIO do MCP iniciado por um MCP Host. Ele não se destina ao uso interativo em shell.

Configuração do MCP Host

Configure o MCP Host para iniciar o pacote com npx e passe suas credenciais da Alibaba Cloud como variáveis de ambiente:

{
  "mcpServers": {
    "aliyun-direct-mail": {
      "command": "npx",
      "args": ["-y", "alibabacloud-direct-mail-mcp"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your-access-key-id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your-access-key-secret",
        "ALIYUN_DM_REGION_ID": "ap-southeast-1"
      }
    }
  }
}

Crie um AccessKey ID e um AccessKey Secret para um usuário RAM. Para mais informações, consulte Criar um AccessKey. O AccessKey Secret é exibido apenas no momento da criação. Armazene-o com segurança.

O ALIYUN_DM_REGION_ID tem como padrão ap-southeast-1. Os IDs de região e endpoints disponíveis estão listados em Endpoints de serviço.

Ferramentas

A tabela a seguir lista as ferramentas disponíveis. Para parâmetros precisos e campos de confirmação, verifique o esquema da ferramenta no MCP Host.

Ferramenta	Descrição	Nível de risco
`dm_get_account_summary`	Visualize a cota, o status e as contagens de recursos da sua conta do Direct Mail.	somente leitura
`dm_list_mail_addresses`	Liste ou filtre endereços de e-mail.	somente leitura
`dm_list_config_sets`	Liste conjuntos de configurações.	somente leitura
`dm_get_config_set`	Obtenha detalhes de um único conjunto de configurações.	somente leitura
`dm_list_templates`	Liste modelos do Direct Mail antes de uma tarefa em lote ou envio de teste.	somente leitura
`dm_get_template`	Obtenha o assunto, o status e o conteúdo de um modelo para revisão pré-envio.	somente leitura
`dm_create_template`	Visualize e crie um modelo de e-mail. Modelos criados exigem revisão.	escrita protegida
`dm_list_receivers`	Liste metadados da lista de destinatários.	somente leitura
`dm_list_receiver_details`	Obtenha detalhes de uma única lista de destinatários.	somente leitura
`dm_create_receiver_list`	Visualize e crie uma lista de destinatários vazia.	escrita protegida
`dm_add_receiver_records`	Adicione registros de destinatários a uma lista.	escrita protegida
`dm_list_tasks`	Liste tarefas em lote para verificar o progresso.	somente leitura
`dm_list_tags`	Liste tags usadas para classificação e rastreamento.	somente leitura
`dm_create_tag`	Visualize e crie uma tag.	escrita protegida
`dm_list_send_details`	Obtenha detalhes de entrega por destinatário ou e-mail.	somente leitura
`dm_get_send_statistics_summary`	Obtenha estatísticas agregadas de envio.	somente leitura
`dm_list_block_sending`	Obtenha registros de envio bloqueado, como endereços que cancelaram a inscrição.	somente leitura
`dm_get_track_list`	Obtenha dados de rastreamento de aberturas e cliques.	somente leitura
`dm_list_dedicated_ips`	Liste IPs dedicados adquiridos.	somente leitura
`dm_list_dedicated_ip_pools`	Liste pools de IPs dedicados.	somente leitura
`dm_get_ip_protection`	Obtenha o status da chave de Proteção de IP do Direct Mail.	somente leitura
`dm_send_direct_email`	Envie e-mails transacionais, como códigos de verificação (até 100 destinatários).	envio protegido
`dm_start_batch_send_task`	Inicie uma tarefa de envio em lote para e-mails de marketing (sem limite de destinatários).	envio protegido
`dm_send_template_test_email`	Visualize e envie um e-mail de teste usando um modelo. Não destinado a uso em produção.	envio protegido

As ferramentas de escrita protegida e de envio retornam uma visualização e uma ação de confirmação quando o parâmetro execute é omitido. O MCP Host deve exibir a visualização e prosseguir somente após a aprovação explícita do usuário.

Habilidade opcional do agente

O serviço MCP opera de forma independente. A habilidade opcional do agente auxilia o assistente de IA a selecionar ferramentas, verificar visualizações e gerenciar fluxos de confirmação conforme os processos de negócios do Direct Mail. Ela fornece orientação de fluxo de trabalho sem alterar o comportamento de tempo de execução do serviço MCP.

Baixe o alibabacloud-direct-mail-agent-skill.zip.

Prompts

Hosts que suportam listPrompts / getPrompt do MCP podem utilizar orientações de fluxo de trabalho baseadas em cenários. Os detalhes dos prompts correspondem à habilidade hospedada externamente. Para definições precisas de campos, verifique o esquema da ferramenta e o structuredContent retornado pelo serviço.

Prompt	Caso de uso
`dm_direct_email_send_assistant`	Envie um e-mail direto ou notificação transacional para destinatários específicos.
`dm_template_batch_send_assistant`	Execute uma tarefa em lote com um modelo e uma lista de destinatários, com opção de envio de teste.
`dm_delivery_investigation_assistant`	Investigue o progresso de tarefas, detalhes de entrega, estatísticas ou dados de rastreamento.