Sommario
- Cos'è il server MCP Mailjet
- Cosa ti serve prima di iniziare
- Passo 1. Scarica il progetto
- Passo 2. Installa le dipendenze
- Passo 3. Avvia il server MCP
- Passo 4. Connetti Claude Desktop
- Variabili d'ambiente
- Testare la configurazione
- Usare MCP Mailjet in Claude Desktop
- Risoluzione dei problemi
- Articoli correlati
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
Come verificare o installare Git
Il MCP Mailjet usa Git per scaricare i file del progetto dal nostro repository ufficiale su GitHub. Git è comune sui computer degli sviluppatori ma molti computer ce l'hanno già. Controlla prima di installare nulla.
Verifica se Git è installato
Mac
- Apri il Terminale (Command + Spazio, digita “Terminale”, premi Invio).
- Digita
git --versione premi Invio. - Se vedi qualcosa come
git version 2.39.3, Git è installato. Puoi passare al Passo 1: Scarica il progetto. -
Se macOS chiede di installare Command Line Tools, clicca su Installa e segui i passaggi.
Windows
- Apri il Prompt dei comandi (Start, digita “cmd”, premi Invio).
- Digita
git --versione premi Invio. - Se vedi un numero di versione, Git è installato.
- Se ricevi un errore che il comando non è riconosciuto, installa Git seguendo i passaggi sottostanti.
Installa Git
- Vai su https://git-scm.com/downloads.
- Scarica la versione per il tuo sistema operativo.
- Esegui il programma di installazione e mantieni le impostazioni predefinite.
- Apri di nuovo Terminale o Prompt dei comandi ed esegui
git --versionper confermare che ha funzionato.
Come installare Node.js e pnpm
Il server MCP Mailjet è un piccolo programma JavaScript. Il tuo computer ha bisogno di Node.js per poter eseguire questo programma. Ti serve anche pnpm, uno strumento di supporto che scarica i file extra necessari al programma.
Installa Node.js (Mac e Windows)
- Vai su https://nodejs.org/.
-
Scegli la versione LTS (Long-Term Support).
LTS è la versione stabile con cui la maggior parte dei progetti viene testata. Usare LTS riduce la possibilità di errori quando esegui il server MCP Mailjet. - Scarica il programma di installazione per il tuo sistema ed eseguilo.
- Mantieni le impostazioni predefinite e completa l'installazione.
- Apri Terminale (Mac) o Prompt dei comandi (Windows).
-
Digita:
node -v
Dovresti vedere un numero di versione, come
v20.x.x.Vedere un numero di versione significa che Node.js è installato correttamente. Non devi fare altro con esso.
Installa pnpm
-
Nella stessa finestra di Terminale o Prompt dei comandi, digita:
npm install -g pnpm
-
Poi verifica:
pnpm -v
Un numero di versione qui significa che pnpm è pronto per installare il server MCP Mailjet nel passo successivo.
Passo 1. Scarica il progetto
Scaricherai il server MCP Mailjet dal repository ufficiale GitHub e ti sposterai in quella cartella.
- Apri Terminale (Mac) o Prompt dei comandi (Windows).
-
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.
- Assicurati di essere ancora dentro la cartella
mailjet-mcp-server. -
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.
Configurazione Mac
1. Apri questo file:
~/Library/Application Support/Claude/claude_desktop_config.json
2. Aggiungi questo blocco al file (uniscilo alla tua sezione mcpServers attuale se esiste):
{
"mcpServers": {
"mailjet": {
"command": "node",
"args": ["/YOUR/PATH/mailjet-mcp-server/src/mailjet-mcp.js"],
"env": {
"MAILJET_API_KEY": "YOUR_public_key:YOUR_private_key"
}
}
}
}
3. Sostituisci /YOUR/PATH/... con il percorso reale sul tuo Mac a mailjet-mcp-server/src/mailjet-mcp.js.
4. Sostituisci YOUR_public_key:YOUR_private_key con la tua chiave API e chiave segreta Mailjet separate da due punti.
1234567890abcdef:abcdef1234567890
5. Salva il file e riavvia Claude Desktop.
Configurazione Windows
1. Apri questo file:
%APPDATA%/Claude/claude_desktop_config.json
2. Aggiungi questo blocco:
{
"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"
}
}
}
}
3. Sostituisci C:\PATH\TO\... con la cartella dove hai clonato il progetto.
4. Mantieni le barre rovesciate nei percorsi Windows. Se il tuo editor si lamenta, esegui l'escape come \\.
5. Salva il file e riavvia Claude Desktop.
Variabili d'ambiente
Il server MCP Mailjet supporta le seguenti variabili d'ambiente.
| Variabile | Obbligatoria | Descrizione | Esempio |
|---|---|---|---|
MAILJET_API_KEY |
Sì | Chiavi pubblica e privata Mailjet unite da due punti | publickey123:secretkey456 |
MAILJET_API_REGION |
No | Usa i server Mailjet EU | eu |
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 inclaude_desktop_config.jsonpunti al tuo vero filemailjet-mcp-server/src/mailjet-mcp.js. Riavvia Claude. -
Errore di autenticazione
Assicurati che il valore API usi il formatoPUBLIC_KEY:PRIVATE_KEY. Se manca il due punti, l'autenticazione fallisce. -
Il server si chiude immediatamente
Eseguinode src/mailjet-mcp.jsdall'interno della cartellamailjet-mcp-server. -
Account EU non si carica
ImpostaMAILJET_API_REGION=eunel tuo ambiente o nella sezioneenvdella 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.
- Apri Claude Desktop.
- Fai una domanda relativa a Mailjet, per esempio: Quale delle mie liste di contatti ha più iscritti.
- Claude rileverà che deve contattare Mailjet e mostrerà una finestra simile a: Claude vuole usare Get v3 liststatistics da mailjet.
-
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.
- Scegli Consenti una volta se vuoi solo testare la configurazione
- Scegli Consenti sempre se vuoi permettere a Claude di eseguire la richiesta ogni volta senza dover richiedere il permesso.
-
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.