Elastic Email MCP Server

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

Ações disponíveis que nosso MCP poderá realizar para você_

• Adicionar contato a uma lista
• Fazer upload e adicionar contatos
• Criar uma lista
• Criar um segmento
• Criar uma campanha
• Obter campanhas
• Atualizar uma campanha
• Pausar uma campanha
• Listar campanhas
• Enviar emails: tanto transacionais quanto em massa
• Buscar contato, contatos, contato de uma lista
• Buscar listas
• Buscar modelos
• Buscar segmentos
• Está pronto (verificação de saúde, conexão e prontidão)
• Excluir contato de uma 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 ofereça suporte a 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

• Instale e execute o VS Code

• Abra as extensões no menu esquerdo e instale as extensões Github Copilot e Github Copilot Chat

• Faça login no Github usando a conta que você criou na etapa anterior

• Autorize o Visual Studio Code no Github Copilot

• Permita a execução do VS Code na próxima etapa

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

• Mude o chat para o Modo Agente

• Crie uma chave de API no Elastic Email. As permissões necessárias para visualizar e modificar são as seguintes: Conta, Modelos, Campanhas, Contatos, Arquivos, Enviar HTTP. Além disso, é necessário pelo menos acesso de "visualização" aos Tokens de Acesso. Lembre-se de nunca compartilhar sua Chave de API com terceiros não autorizados!

• Na barra superior do VS Code, use a função de pesquisa para encontrar: Mostrar e executar comandos

• Você pode escrever "MCP" no campo de pesquisa para restringir as opções disponíveis e escolher "MCP: Abrir configuração do usuário".

• Cole o texto de configuração como abaixo (se você já tiver outros servidores, apenas os dados do elasticemail.mcp serão suficientes)

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

Observe que a etapa 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 prosseguir. 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 Iniciar acima de elasticemail.mcp no arquivo de configuração.

• Forma alternativa: Escolha Extensões no menu esquerdo, selecione o servidor em MCP SERVERS INSTALLED na parte inferior, clique com o botão direito e escolha Iniciar servidor

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 testar seu primeiro comando para garantir que a integração funcione. Você pode inserir o prompt "O MCP está funcionando" como exemplo e, se tudo estiver certo, 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. Os 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. Você também pode instruir o Agente a buscar novamente as ferramentas e informar que houve alterações no servidor para garantir que ele realmente obtenha os novos dados.
2. Quanto mais preciso for o prompt, menos margem 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 para chamadas de API.