Elastic Email MCP

Observação! O vídeo acima mostra apenas um método de autorização com chave de API.

O endereço do servidor MCP, https://mcp.elasticemail.com, é usado apenas para conectar agentes de IA. Ele não é o endereço da API REST do Elastic Email e não pode ser usado como host de API em outras integrações. Para o endereço da API, consulte o artigo "API Settings".

Ao implementar o MCP, o Elastic Email permite que agentes de IA acessem e controlem suas operações de e-mail, mantendo segurança e autenticação adequadas.

Ações disponíveis que nosso MCP poderá fazer por você

• Adicionar contato a uma lista
• Enviar e adicionar contatos
• Criar uma lista
• Criar um segmento
• Criar uma campanha
• Obter campanhas
• Atualizar uma campanha
• Pausar uma campanha
• Listar campanhas
• Enviar e-mails: tanto transacionais quanto em massa
• Buscar contato, contatos, contato de lista
• Buscar listas
• Buscar modelos
• Buscar segmentos
• Está pronto (verificação de saúde, conexão e prontidão)
• Excluir contato de lista
• Excluir contato da conta

Observe que nem todos os endpoints listados estão disponíveis para todos os planos de preços do Elastic Email. Por exemplo, os endpoints de campanhas e contatos não estão disponíveis para planos de Email API. Aqui está a lista completa de nossos artigos disponíveis sobre os recursos listados acima:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

Configuração

Para se conectar ao nosso servidor MCP, você pode usar qualquer agente de IA que suporte MCP. O requisito principal para qualquer configuração é o suporte ao "modo agente", que permite que o agente de IA interaja programaticamente com serviços externos de forma segura.

Preparamos um exemplo de configuração passo a passo usando as ferramentas VS Code e Github Copilot.

• https://github.com você precisará criar uma conta gratuita no Github
• https://code.visualstudio.com/ baixe o VS Code deste site

Em seguida, você precisará conectar sua conta do Github ao VS Code

• Autorize o Visual Studio Code no Github Copilot

• Permita executar o VS Code na próxima etapa

• Para exibir a janela de chat, vá para View → Chat no menu superior do VS Code. O chat deve ser exibido no lado direito.

• Alterne o chat para o Modo Agente

• Agora você pode usar uma das duas formas disponíveis de autorização:

1. Crie uma chave de API no Elastic Email. As permissões necessárias para visualizar e modificar são as seguintes: Account, Templates, Campaigns, Contacts, Files, Send HTTP. Além disso, é necessário pelo menos acesso de "visualização" aos Access Tokens. Lembre-se de **nunca** compartilhar sua chave de API com terceiros não autorizados!

2. Use o método de autorização OAuth. Basta seguir os próximos passos da instrução e pular a seção de adição de cabeçalhos com X-Auth-Token. Quando estiver pronto, inicie a conexão com o servidor MCP: clique em Start acima de elasticemail.mcp no arquivo de configuração e permita que o VS Code autentique via oidc.elasticemail.com.

Você será redirecionado para a página de login. Após um login bem-sucedido, você será redirecionado automaticamente de volta ao VS Code. Se isso não acontecer, siga a instrução exibida na página:

• Na barra superior do VS Code, use a função de pesquisa para encontrar: Show and run commands
• Você pode escrever "MCP" no campo de pesquisa para restringir as opções disponíveis e escolher "MCP: Open user configuration".
• Cole o texto de configuração como abaixo (se você já tiver algum servidor, apenas os dados de elasticemail.mcp serão suficientes)
• Use a seção de cabeçalhos com sua chave de API somente se quiser usar o método de chave para autorização. Remova-a se estiver usando o método OAuth.

{
    "servers": {
        "elasticemail.mcp": {
            "url": "https://mcp.elasticemail.com",
            "headers": {
                "X-Auth-Token": "your_api_key"
            }
        }
    }
}

Observe que o passo mais importante aqui é inserir sua chave de API real com as permissões mencionadas acima. Além disso, certifique-se de que, após modificar este campo, você salve as alterações antes de continuar. Sem salvar as alterações, a opção de "iniciar" a integração não aparecerá.

• Agora você pode iniciar a conexão com o servidor MCP: clique em Start acima de elasticemail.mcp no arquivo de configuração.

A partir de agora, você pode usar as ações fornecidas pelo servidor MCP do Elastic Email dentro da janela de chat. Essas ações foram descritas no início deste artigo.

Você pode tentar seu primeiro comando para garantir que a integração funcione. Você pode inserir o prompt "Is MCP working" como exemplo e, se tudo funcionar, você deverá receber uma confirmação como resposta.

Para entender melhor como esse tipo de integração funciona no lado do Elastic Email, sinta-se à vontade para revisar também nossa Documentação da API:

https://elasticemail.com/developers/api-documentation/rest-api

Dicas

1. Agentes de IA podem ficar presos lembrando instruções anteriores e tentando repeti-las. É útil iniciar uma nova sessão de chat para resolver esses problemas. Além disso, você pode instruir o Agente a buscar novamente as ferramentas e informar que houve mudanças no servidor para garantir que ele realmente busque novos dados.
2. Quanto mais preciso for o prompt, menos espaço para interpretação você deixa para o LLM, reduzindo problemas relacionados a alucinações.
3. É útil revisar as solicitações antes de enviá-las, pois você pode notar possíveis inconsistências na forma como o LLM traduziu sua solicitação em chamadas de API.

Conectando MCP em outros agentes de IA

A configuração acima usa VS Code e GitHub Copilot, mas o mesmo endereço de servidor funciona com qualquer agente de IA que suporte MCP e possa operar em modo agente. Para um exemplo passo a passo baseado em Claude, consulte How to connect the Elastic Email MCP server to Claude.