O que é o servidor MCP do Mailjet

O MCP do Mailjet é o assistente de IA do Claude Desktop que lê dados do Mailjet da sua conta usando sua chave API. Uma vez configurado, você pode pedir ao Claude informações sobre desempenho de campanhas, listas de contatos ou estatísticas, e ele buscará essas informações através da API do Mailjet.

MCP (Model Context Protocol) é uma forma de ferramentas de IA se conectarem a serviços externos. O servidor MCP do Mailjet é um pequeno serviço que roda no seu computador e expõe as APIs do Mailjet para o Claude. Isso permite que o Claude responda perguntas usando dados ao vivo da sua conta do Mailjet.

O que você precisa antes de começar

Esta configuração pede que um usuário não técnico faça algumas tarefas técnicas. Para facilitar, mostraremos as ferramentas necessárias e como instalá-las.

• Conta do Mailjet com uma chave API e chave secreta ativas
• Claude Desktop instalado 
• Git para baixar o servidor MCP do Mailjet do GitHub
• Node.js para rodar o servidor MCP
• pnpm para instalar os arquivos do servidor MCP
• Permissão para editar a configuração do Claude Desktop

Passo 1. Baixe o projeto

Você vai baixar o servidor MCP do Mailjet do repositório oficial do GitHub e entrar nessa pasta.

1. Abra o Terminal (Mac) ou Prompt de Comando (Windows).

2. Execute:

   git clone https://github.com/mailgun/mailjet-mcp-server.git
   cd mailjet-mcp-server
   

O primeiro comando baixa o servidor MCP em uma nova pasta. O segundo comando te leva para essa pasta para que os próximos comandos funcionem.

Passo 2. Instale as dependências

Agora, instale os pacotes que o servidor precisa.

pnpm install

Passo 3. Inicie (ligue) o servidor MCP

Este passo inicia o programa MCP do Mailjet para que o Claude possa se conectar a ele.

1. Certifique-se de que você ainda está dentro da pasta mailjet-mcp-server.

2. Execute:

   node src/mailjet-mcp.js
   

Isso inicia o servidor MCP do Mailjet no seu computador. Você pode ver algumas linhas de texto. Isso significa que ele está rodando.

Passo 4. Conecte o Claude Desktop

O Claude Desktop usa um arquivo de configuração JSON para saber quais servidores MCP carregar. Adicione o servidor MCP do Mailjet nele para que o Claude possa encontrá-lo.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailjet": {
      "command": "node",
      "args": ["/YOUR/PATH/mailjet-mcp-server/src/mailjet-mcp.js"],
      "env": {
        "MAILJET_API_KEY": "YOUR_public_key:YOUR_private_key"
      }
    }
  }
}

%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailjet": {
      "command": "node",
      "args": ["C:\\PATH\\TO\\mailjet-mcp-server\\src\\mailjet-mcp.js"],
      "env": {
        "MAILJET_API_KEY": "YOUR_public_key:YOUR_private_key"
      }
    }
  }
}

Variáveis de ambiente

O servidor MCP do Mailjet suporta as seguintes variáveis de ambiente.

Você pode definir essas variáveis no seu sistema ou diretamente na configuração do Claude na seção env.

Testando a configuração

O projeto inclui uma suíte de testes local. Para executá-la:

NODE_ENV=test pnpm test

Se os testes passarem sem erros, sua instalação está funcionando.

Solução de problemas

• Claude não mostra as ferramentas do Mailjet
  Verifique se o caminho no claude_desktop_config.json aponta para o seu arquivo real mailjet-mcp-server/src/mailjet-mcp.js. Reinicie o Claude.
• Erro de autenticação
  Certifique-se de que o valor da API está no formato PUBLIC_KEY:PRIVATE_KEY. Se faltar o dois pontos, a autenticação falha.
• Servidor fecha imediatamente
  Execute node src/mailjet-mcp.js dentro da pasta mailjet-mcp-server.
• Conta EU não carrega
  Defina MAILJET_API_REGION=eu no seu ambiente ou na seção env da entrada de configuração do Claude.

Usando o MCP do Mailjet no Claude Desktop

Uma vez que o servidor MCP esteja rodando e o Claude Desktop tenha sido reiniciado, você pode começar a usá-lo.

1. Abra o Claude Desktop.
2. Faça uma pergunta relacionada ao Mailjet, por exemplo: Qual das minhas listas de contatos tem mais inscritos.
3. O Claude detectará que precisa contatar o Mailjet e mostrará uma caixa semelhante a: Claude quer usar Get v3 liststatistics do mailjet.

4. Você verá botões como Negar, Permitir uma vez e Sempre permitir.

   • Permitir uma vez permite que o Claude faça esta única requisição ao Mailjet agora.
   • Sempre permitir indica ao Claude que ele pode usar o servidor MCP do Mailjet para requisições futuras sem pedir novamente.
   • Negar bloqueia a requisição e o Claude não obterá dados do Mailjet.

   

   1. Escolha Permitir uma vez se quiser apenas testar a configuração
   2. Escolha Sempre permitir se quiser que o Claude execute a requisição sempre sem precisar pedir permissão novamente.

5. Depois de permitir a requisição, o Claude chamará o servidor MCP do Mailjet, obterá os dados e responderá com o resultado, por exemplo, uma lista das suas listas de contatos e suas contagens de inscritos.