Was ist der Mailjet MCP-Server

Der Mailjet MCP liest als KI-Assistent Claude Desktop Mailjet-Daten von Ihrem Konto über Ihren API-Schlüssel aus. Sobald er eingerichtet ist, können Sie Claude nach Kampagnenleistungen, Kontaktlisten oder Statistiken fragen, und er ruft die Informationen über die Mailjet API ab.

MCP (Model Context Protocol) ist eine Möglichkeit für KI-Tools, sich mit externen Diensten zu verbinden. Der Mailjet MCP-Server ist ein kleiner Dienst, der auf Ihrem Computer läuft und Mailjet-APIs für Claude bereitstellt. Dadurch kann Claude Fragen mit Live-Daten aus Ihrem Mailjet-Konto beantworten.

Was Sie vor dem Start benötigen

Dieses Setup verlangt von einem nicht-technischen Nutzer einige technische Schritte. Um es einfacher zu machen, zeigen wir die benötigten Werkzeuge und wie man sie installiert.

• Mailjet-Konto mit einem aktiven API-Schlüssel und Geheimschlüssel
• Claude Desktop installiert 
• Git, um den Mailjet MCP-Server von GitHub herunterzuladen
• Node.js, um den MCP-Server auszuführen
• pnpm, um die MCP-Server-Dateien zu installieren
• Berechtigung, die Claude Desktop-Konfiguration zu bearbeiten

Schritt 1. Projekt herunterladen

Sie laden den Mailjet MCP-Server aus dem offiziellen GitHub-Repository herunter und wechseln in diesen Ordner.

1. Öffnen Sie Terminal (Mac) oder Eingabeaufforderung (Windows).

2. Führen Sie aus:

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

Der erste Befehl lädt den MCP-Server in einen neuen Ordner herunter. Der zweite Befehl wechselt in diesen Ordner, damit die nächsten Befehle funktionieren.

Schritt 2. Abhängigkeiten installieren

Installieren Sie als Nächstes die Pakete, die der Server benötigt.

pnpm install

Schritt 3. MCP-Server starten (einschalten)

Dieser Schritt startet das Mailjet MCP-Programm, damit Claude eine Verbindung herstellen kann.

1. Stellen Sie sicher, dass Sie sich noch im Ordner mailjet-mcp-server befinden.

2. Führen Sie aus:

   node src/mailjet-mcp.js
   

Dies startet den Mailjet MCP-Server auf Ihrem Computer. Sie sehen möglicherweise einige Textzeilen. Das bedeutet, dass er läuft.

Schritt 4. Claude Desktop verbinden

Claude Desktop verwendet eine JSON-Konfigurationsdatei, um zu wissen, welche MCP-Server geladen werden sollen. Fügen Sie dort den Mailjet MCP-Server hinzu, damit Claude ihn finden kann.

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

Umgebungsvariablen

Der Mailjet MCP-Server unterstützt folgende Umgebungsvariablen.

Sie können diese in Ihrem System oder direkt in der Claude-Konfiguration im env-Abschnitt definieren.

Setup testen

Das Projekt enthält eine lokale Testsuite. Um sie auszuführen:

NODE_ENV=test pnpm test

Wenn die Tests ohne Fehler bestehen, funktioniert Ihre Installation.

Fehlerbehebung

• Claude zeigt keine Mailjet-Werkzeuge an
  Prüfen Sie, ob der Pfad in claude_desktop_config.json auf Ihre echte mailjet-mcp-server/src/mailjet-mcp.js-Datei zeigt. Starten Sie Claude neu.
• Authentifizierungsfehler
  Stellen Sie sicher, dass der API-Wert das Format PUBLIC_KEY:PRIVATE_KEY verwendet. Wenn der Doppelpunkt fehlt, schlägt die Authentifizierung fehl.
• Server schließt sofort
  Führen Sie node src/mailjet-mcp.js aus dem Ordner mailjet-mcp-server aus.
• EU-Konto wird nicht geladen
  Setzen Sie MAILJET_API_REGION=eu in Ihrer Umgebung oder im env-Abschnitt des Claude-Konfigurationseintrags.

Mailjet MCP in Claude Desktop verwenden

Sobald der MCP-Server läuft und Claude Desktop neu gestartet wurde, können Sie ihn verwenden.

1. Öffnen Sie Claude Desktop.
2. Stellen Sie eine Mailjet-bezogene Frage, z. B.: Welche meiner Kontaktlisten hat die meisten Abonnenten.
3. Claude erkennt, dass es Mailjet kontaktieren muss und zeigt ein Feld ähnlich wie: Claude möchte Get v3 liststatistics von mailjet verwenden.

4. Sie sehen Schaltflächen wie Verweigern, Einmal erlauben und Immer erlauben.

   • Einmal erlauben lässt Claude diese einzelne Anfrage jetzt an Mailjet stellen.
   • Immer erlauben sagt Claude, dass es den Mailjet MCP-Server für zukünftige Anfragen ohne weitere Nachfrage verwenden darf.
   • Verweigern blockiert die Anfrage und Claude erhält keine Mailjet-Daten.

   

   1. Wählen Sie Einmal erlauben, wenn Sie die Konfiguration nur testen möchten.
   2. Wählen Sie Immer erlauben, wenn Claude die Anfrage jedes Mal ohne erneute Erlaubnis ausführen darf.

5. Nachdem Sie die Anfrage erlaubt haben, ruft Claude den Mailjet MCP-Server auf, holt die Daten und antwortet mit dem Ergebnis, z. B. einer Liste Ihrer Kontaktlisten und deren Abonnentenzahlen.