Cos'è il server MCP Mailjet

Il MCP Mailjet è l'assistente AI di Claude Desktop che legge i dati Mailjet dal tuo account usando la tua chiave API. Una volta configurato, puoi chiedere a Claude informazioni sulle prestazioni delle campagne, liste di contatti o statistiche e lui recupererà le informazioni tramite l'API Mailjet.

MCP (Model Context Protocol) è un modo per gli strumenti AI di connettersi a servizi esterni. Il server MCP Mailjet è un piccolo servizio che gira sul tuo computer ed espone le API Mailjet a Claude. Questo permette a Claude di rispondere a domande usando dati live dal tuo account Mailjet.

Cosa ti serve prima di iniziare

Questa configurazione richiede a un utente non tecnico di fare alcune operazioni tecniche. Per facilitarlo, mostreremo gli strumenti necessari e come installarli.

• Account Mailjet con una chiave API attiva e una chiave segreta
• Claude Desktop installato 
• Git per scaricare il server MCP Mailjet da GitHub
• Node.js per eseguire il server MCP
• pnpm per installare i file del server MCP
• Permessi per modificare la configurazione di Claude Desktop

Passo 1. Scarica il progetto

Scaricherai il server MCP Mailjet dal repository ufficiale GitHub e ti sposterai in quella cartella.

1. Apri Terminale (Mac) o Prompt dei comandi (Windows).

2. Esegui:

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

Il primo comando scarica il server MCP in una nuova cartella. Il secondo comando ti sposta in quella cartella così i comandi successivi funzionano.

Passo 2. Installa le dipendenze

Poi, installa i pacchetti necessari al server.

pnpm install

Passo 3. Avvia (accendi) il server MCP

Questo passo avvia il programma MCP Mailjet così Claude può connettersi ad esso.

1. Assicurati di essere ancora dentro la cartella mailjet-mcp-server.

2. Esegui:

   node src/mailjet-mcp.js
   

Questo avvia il server MCP Mailjet sul tuo computer. Potresti vedere alcune righe di testo. Significa che è in esecuzione.

Passo 4. Connetti Claude Desktop

Claude Desktop usa un file di configurazione JSON per sapere quali server MCP caricare. Aggiungi lì il server MCP Mailjet così Claude può trovarlo.

~/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"
      }
    }
  }
}

Variabili d'ambiente

Il server MCP Mailjet supporta le seguenti variabili d'ambiente.

Puoi definirle nel tuo sistema o direttamente nella configurazione di Claude nella sezione env.

Testare la configurazione

Il progetto include una suite di test locale. Per eseguirla:

NODE_ENV=test pnpm test

Se i test passano senza errori, l'installazione funziona.

Risoluzione dei problemi

• Claude non mostra gli strumenti Mailjet
  Verifica che il percorso in claude_desktop_config.json punti al tuo vero file mailjet-mcp-server/src/mailjet-mcp.js. Riavvia Claude.
• Errore di autenticazione
  Assicurati che il valore API usi il formato PUBLIC_KEY:PRIVATE_KEY. Se manca il due punti, l'autenticazione fallisce.
• Il server si chiude immediatamente
  Esegui node src/mailjet-mcp.js dall'interno della cartella mailjet-mcp-server.
• Account EU non si carica
  Imposta MAILJET_API_REGION=eu nel tuo ambiente o nella sezione env della configurazione di Claude.

Usare MCP Mailjet in Claude Desktop

Una volta che il server MCP è in esecuzione e Claude Desktop è stato riavviato, puoi iniziare a usarlo.

1. Apri Claude Desktop.
2. Fai una domanda relativa a Mailjet, per esempio: Quale delle mie liste di contatti ha più iscritti.
3. Claude rileverà che deve contattare Mailjet e mostrerà una finestra simile a: Claude vuole usare Get v3 liststatistics da mailjet.

4. Vedrai pulsanti come Nega, Consenti una volta e Consenti sempre.

   • Consenti una volta permette a Claude di fare questa singola richiesta a Mailjet ora.
   • Consenti sempre dice a Claude che può usare il server MCP Mailjet per richieste future senza chiedere di nuovo.
   • Nega blocca la richiesta e Claude non otterrà dati Mailjet.

   

   1. Scegli Consenti una volta se vuoi solo testare la configurazione
   2. Scegli Consenti sempre se vuoi permettere a Claude di eseguire la richiesta ogni volta senza dover richiedere il permesso.

5. Dopo aver concesso il permesso, Claude chiamerà il server MCP Mailjet, prenderà i dati e risponderà con il risultato, per esempio una lista delle tue liste di contatti e il numero di iscritti.