Workflow Transactional EmailWorkflow Transactional Email
Einen KI-Assistenten (MCP) verbinden

Einen KI-Assistenten (MCP) verbinden

Seite kopieren

Verbinden Sie Claude, Cursor oder VS Code per MCP mit Workflow Transactional Email, um Layouts und Sendungen per KI zu prüfen.

Die App betreibt einen MCP-Server, sodass ein KI-Assistent Ihre Konfiguration überprüfen, E-Mail-Layouts erstellen und übersetzen, Ihre HTTP-Anfragen verwalten und Ihre Medienbibliothek direkt aufräumen kann, anstatt dass Sie die Konfiguration hin und her kopieren müssen.

Nützliche Funktionen: Erstellen Sie ein Marketing-Layout mit Ihren Fußzeilentexten, übersetzen Sie ein Layout in alle Sprachen, in denen Sie Ihre Produkte verkaufen, überprüfen Sie, welche E-Mail-Layouts auf ein Geheimnis verweisen, das bald ausgewechselt wird, finden Sie alle hochgeladenen Bilder, die nicht mehr verwendet werden, erklären Sie, warum die gestrigen Sendungen fehlgeschlagen sind, oder erstellen Sie eine neue HTTP-Anfrage anhand der Dokumentation einer Drittanbieter-API.

Endpunkt

text
POST https://shopify.workflow-transactional-email.app/api/mcp

Als Transportprotokoll wird Streamable HTTP verwendet. Die Authentifizierung erfolgt über denselben Bearer-Schlüssel wie bei der REST-API - siehe Authentifizierung und API-Schlüssel.

Verbinden

Auf der Registerkarte „MCP“ auf der Entwicklerseite der App wird ein kopierfertiger Befehl generiert, in dem Ihre URL und Ihr Schlüssel bereits ausgefüllt sind - für Claude, Claude Desktop, Cursor, VS Code und Gemini CLI. Verwenden Sie diesen, anstatt ihn von Hand einzugeben.

Für Claude Code sieht der Befehl wie folgt aus:

bash
claude mcp add --transport http flow-transactional-email \
  https://shopify.workflow-transactional-email.app/api/mcp \
  --header "Authorization: Bearer fak_your_key_here"

Bei Editoren, die eine JSON-Konfiguration verwenden, sieht die Struktur wie folgt aus:

~/.cursor/mcp.jsonjson
{
  "mcpServers": {
    "flow-transactional-email": {
      "url": "https://shopify.workflow-transactional-email.app/api/mcp",
      "headers": {
        "Authorization": "Bearer fak_your_key_here"
      }
    }
  }
}

Verfügbare Werkzeuge

Der Werkzeugsatz spiegelt die Berechtigungsstufe Ihres Schlüssels wider. Ein schreibgeschützter Schlüssel wird nicht lediglich abgelehnt, wenn er ein Schreibwerkzeug aufruft - er sieht dieses Werkzeug überhaupt nicht in der Liste, sodass ein Assistent nicht dazu überredet werden kann, den Versuch zu unternehmen.

Lesen (15 Tools)

E-Mail-Layouts: list_email_templates, get_email_template, get_layout_schema, list_template_translations, list_template_versions, get_template_version. list_email_templates akzeptiert q, category (transactional oder marketing), page und limit.

Absender der E-Mails: list_smtp_configs, list_senders

Geheimnisse: list_secret_keys (nur Namen)

HTTP-Anfragen: list_http_requests, get_http_request

Medien: list_files (Geben Sie usage: true ein, um zu sehen, welche Dateien noch auf die jeweilige Datei verweisen)

Historie: list_history (Filtern Sie nach status, einschließlich SKIPPED für Marketing-E-Mails, deren Empfänger sich alle abgemeldet haben), get_history_entry, get_stats

Lesen und Schreiben (Addition mit der Zahl 12)

E-Mail-Vorlagen: create_email_template, update_email_template, delete_email_template

Sprachen: set_template_translation, delete_template_translation, promote_template_translation

Versionen: restore_template_version, restore_template_github_version

HTTP-Anfragen: create_http_request, update_http_request, delete_http_request

Medien: delete_file

Lesen, Schreiben und Ausführen (addiert 1)

test_http_request - führt eine konfigurierte HTTP-Anfrage an das tatsächliche Ziel aus.

Grundrisse mit einem Assistenten erstellen

Bitten Sie den Assistenten, zunächst get_layout_schema zu lesen: Dort wird das visuelle Designformat mit den Standardwerten für jeden Block, dem verwendbaren Liquid sowie den Einschränkungen beschrieben, die vom Builder selbst generiert werden. Anschließend nimmt create_email_template eine name, eine subject und eine bodyDesign (visuell, Standard) oder eine HTML-Datei body (Text) entgegen. Das Layout wird sofort in der App angezeigt, und jede Änderung wird im Versionsverlauf gespeichert, sodass alle von einem Assistenten vorgenommenen Änderungen rückgängig gemacht werden können.

Zwei Felder bestimmen, wie sich ein Layout in einer E-Mail verhält:

  • category: transactional (Standard) oder marketing. Bei einem Marketing-Layout werden abgemeldete Empfänger übersprungen, und es werden ein Abmeldelink sowie eine Fußzeile angezeigt; siehe Marketing-E-Mails und Abmeldungen.
  • marketingTexts: Die Fußzeilentexte eines Marketing-Layouts anstelle der Shop-Texte aus den Einstellungen unter { unsubscribeText, unsubscribeLinkLabel, companyDetails }; jedes Feld ist optional; null bedeutet, dass die Texte aus den Einstellungen verwendet werden. Der Satz zum Abbestellen muss {{ unsubscribe_link }} oder {{ unsubscribe_url }} enthalten.

set_template_translation erstellt eine Sprache oder ersetzt eine bestehende durch den vollständig übersetzten Inhalt. Bei einem Textlayout kann es zudem attachments enthalten (eine Liste = die sprachspezifischen Dateien, null = die des Layouts, weggelassen = unverändert), und bei einem Marketing-Layout marketingTexts für diese Sprache zusätzlich zu den Dateien des Layouts. promote_template_translation macht eine Sprache zur Hauptsprache des Layouts; die beiden tauschen ihre Plätze, sodass nichts verloren geht.

Eine gute erste Anfrage:

„Lesen Sie das Layout-Schema durch und übersetzen Sie anschließend mein Layout ‚Bestellung versandt‘ ins Deutsche und Französische. Behalten Sie alle Liquid-Tags und URLs genau so bei, wie sie sind.“

Jeder Schreibvorgang wird wie ein Speichervorgang in der App überprüft: Liquid muss die Daten analysieren, die Dateien müssen Ihnen gehören, und das Tool gibt das Feld an, bei dem ein Fehler aufgetreten ist.

Aufräumen in der Medienbibliothek

Eine sinnvolle Anwendung für einen Assistenten. Bitten Sie ihn, Ihre Dateien einschließlich ihrer Verwendungsstellen aufzulisten, und löschen Sie anschließend diejenigen, auf die kein Verweis besteht:

„Bitte listen Sie meine hochgeladenen Dateien mit ihren Verwendungszwecken auf und teilen Sie mir mit, welche davon nicht verwendet werden. Löschen Sie diese anschließend.“

delete_file wird mit einem 409-Fehler abgelehnt, wenn ein E-Mail-Layout oder eine Vorlage für Kopf- bzw. Fußzeile noch auf die Datei verweist, und bei der Ablehnung wird angegeben, wo diese Datei verwendet wird - daher kann der Assistent ein Logo, das eine aktive E-Mail noch benötigt, nicht entfernen, selbst wenn Sie ihn darum bitten.

Was der Assistent niemals sehen kann

Es gibt bewusst kein Tool, das einen geheimen Wert, einen SMTP-Benutzernamen oder ein Passwort oder ein Anmeldetoken für ein Postfach zurückgibt. Der Befehl list_secret_keys gibt ausschließlich Namen zurück.

Das ist der Sinn dieses Designs: Sie können einen Mitarbeiter bitten, eine HTTP-Anfrage zu erstellen, die sich bei Ihrem Zahlungsanbieter authentifiziert, und diese wird korrekt auf {{ secrets.stripeApiKey }} verweisen, ohne dass der Schlüssel selbst jemals in den Kontext des Modells gelangt.

Der über MCP zurückgegebene Verlauf wird genauso maskiert wie über REST. Es gilt derselbe Vorbehalt: Die Maskierung erfolgt anhand von Feldnamen und Wertmustern, und Freitextfelder können weiterhin personenbezogene Daten in den Dialog einbringen. Bitte bedenken Sie dies, bevor Sie einen Assistenten auf einen großen Verlaufsbereich anwenden.