Elastic Email MCP

Hinweis! Das obige Video zeigt nur eine Methode der Autorisierung mit dem API-Schlüssel.

Die MCP-Server-Adresse https://mcp.elasticemail.com wird ausschließlich zur Verbindung von KI-Agenten verwendet. Sie ist nicht die Adresse der Elastic Email REST API und kann nicht als API-Host in anderen Integrationen verwendet werden. Die API-Adresse finden Sie im Artikel „API-Einstellungen“.

Durch die Implementierung von MCP ermöglicht Elastic Email KI-Agenten den Zugriff auf und die Steuerung Ihrer E-Mail-Vorgänge unter Beibehaltung von Sicherheit und ordnungsgemäßer Authentifizierung.

Verfügbare Aktionen, die unser MCP für Sie ausführen kann

• Kontakt zu einer Liste hinzufügen
• Kontakte hochladen und hinzufügen
• Eine Liste erstellen
• Ein Segment erstellen
• Eine Kampagne erstellen
• Kampagnen abrufen
• Eine Kampagne aktualisieren
• Eine Kampagne pausieren
• Kampagnen auflisten
• E-Mails versenden: sowohl transaktional als auch im Massenversand
• Kontakt, Kontakte, Kontakt aus Liste abrufen
• Listen abrufen
• Vorlagen abrufen
• Segmente abrufen
• Is ready (Integritätsprüfung, Verbindungs- und Bereitschaftsprüfung)
• Kontakt aus Liste löschen
• Kontakt aus Konto löschen

Bitte beachten Sie, dass nicht alle der aufgeführten Endpunkte für alle Elastic Email-Preistarife verfügbar sind. Beispielsweise sind die Endpunkte für Kampagnen und Kontakte für Email API-Tarife nicht verfügbar. Hier ist die vollständige Liste unserer verfügbaren Artikel zu den oben aufgeführten Funktionen:

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

Einrichtung

Um eine Verbindung zu unserem MCP-Server herzustellen, können Sie jeden KI-Agenten verwenden, der MCP unterstützt. Die wichtigste Voraussetzung für jede Einrichtung ist die Unterstützung des „Agentenmodus“, der es dem KI-Agenten ermöglicht, sicher und programmatisch mit externen Diensten zu interagieren.

Wir haben eine beispielhafte Schritt-für-Schritt-Einrichtung mit VS Code und GitHub Copilot-Tools vorbereitet.

• https://github.com müssen Sie ein kostenloses Konto bei GitHub erstellen
• https://code.visualstudio.com/ laden Sie VS Code von dieser Website herunter

Als Nächstes müssen Sie Ihr GitHub-Konto mit VS Code verbinden

• Autorisieren Sie Visual Studio Code in GitHub Copilot

• Erlauben Sie im nächsten Schritt die Ausführung von VS Code

• Um das Chat-Fenster anzuzeigen, gehen Sie im oberen Menü von VS Code zu Ansicht → Chat. Der Chat sollte auf der rechten Seite angezeigt werden.

• Wechseln Sie den Chat in den Agentenmodus

• Nun können Sie eine der beiden verfügbaren Autorisierungsmethoden verwenden:

1. Erstellen Sie einen API-Schlüssel in Elastic Email. Die erforderlichen Berechtigungen zum Anzeigen und Ändern sind wie folgt: Konto, Vorlagen, Kampagnen, Kontakte, Dateien, HTTP senden. Darüber hinaus ist mindestens „Anzeige“-Zugriff auf Zugriffstoken erforderlich. Bitte denken Sie daran, Ihren API-Schlüssel **niemals** an unbefugte Dritte weiterzugeben!

2. Verwenden Sie die OAuth-Autorisierungsmethode. Folgen Sie einfach den nächsten Anweisungsschritten und überspringen Sie das Hinzufügen des Headers-Abschnitts mit X-Auth-Token. Wenn Sie bereit sind, initiieren Sie die Verbindung zum MCP-Server: Klicken Sie in der Konfigurationsdatei auf Start über elasticemail.mcp und erlauben Sie VS Code, sich über oidc.elasticemail.com zu authentifizieren.

Sie werden zur Anmeldeseite weitergeleitet. Nach einer erfolgreichen Anmeldung werden Sie automatisch zu VS Code zurückgeleitet. Sollte dies nicht geschehen, folgen Sie der auf der Seite angezeigten Anweisung:

• Verwenden Sie in der oberen Leiste von VS Code die Suchfunktion, um Folgendes zu finden: Befehle anzeigen und ausführen
• Sie können „MCP“ in das Suchfeld eingeben, um die verfügbaren Optionen einzugrenzen, und „MCP: Benutzerkonfiguration öffnen“ auswählen.
• Fügen Sie den Konfigurationstext wie unten ein (falls Sie bereits Server haben, reichen die Daten von elasticemail.mcp aus)
• Verwenden Sie den Headers-Abschnitt mit Ihrem API-Schlüssel nur, wenn Sie die Schlüsselmethode zur Autorisierung verwenden möchten. Entfernen Sie ihn, wenn Sie die OAuth-Methode verwenden.

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

Bitte beachten Sie, dass der wichtigste Schritt hier darin besteht, Ihren tatsächlichen API-Schlüssel mit den oben genannten Berechtigungen einzugeben. Stellen Sie außerdem sicher, dass Sie nach der Änderung dieses Feldes die Änderungen speichern, bevor Sie fortfahren. Ohne das Speichern der Änderungen wird die Option zum „Starten“ der Integration nicht angezeigt.

• Nun können Sie die Verbindung zum MCP-Server initiieren: Klicken Sie in der Konfigurationsdatei auf Start über elasticemail.mcp.

Von nun an können Sie die vom Elastic Email MCP-Server bereitgestellten Aktionen im Chat-Fenster verwenden. Diese Aktionen wurden zu Beginn dieses Artikels beschrieben.

Sie können Ihren ersten Befehl ausprobieren, um sicherzustellen, dass die Integration funktioniert. Sie können beispielsweise die Eingabeaufforderung „Funktioniert MCP“ eingeben, und wenn alles funktioniert, sollten Sie eine Bestätigung als Antwort erhalten.

Um besser zu verstehen, wie diese Art der Integration auf Seiten von Elastic Email funktioniert, können Sie gerne auch unsere API-Dokumentation einsehen:

https://elasticemail.com/developers/api-documentation/rest-api

Tipps

1. KI-Agenten können sich manchmal an frühere Anweisungen „erinnern“ und diese wiederholt ausführen. Es ist hilfreich, eine neue Chat-Sitzung zu starten, um solche Probleme zu beheben. Außerdem können Sie den Agenten anweisen, die Tools erneut abzurufen, und ihm mitteilen, dass es Änderungen auf dem Server gab, um sicherzustellen, dass er tatsächlich neue Daten abruft.
2. Je präziser die Eingabeaufforderung ist, desto weniger Interpretationsspielraum lassen Sie dem LLM, wodurch halluzinationsbedingte Probleme reduziert werden.
3. Es ist hilfreich, die Anfragen vor dem Senden zu überprüfen, da Ihnen möglicherweise Unstimmigkeiten dabei auffallen, wie das LLM Ihre Anfrage in API-Aufrufe übersetzt hat.

MCP in anderen KI-Agenten verbinden

Die obige Einrichtung verwendet VS Code und GitHub Copilot, aber dieselbe Serveradresse funktioniert mit jedem KI-Agenten, der MCP unterstützt und im Agentenmodus ausgeführt werden kann. Ein Schritt-für-Schritt-Beispiel basierend auf Claude finden Sie unter So verbinden Sie den Elastic Email MCP-Server mit Claude.