Postmark über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Postmark klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Postmark + Gemini

Transaktions- und Broadcast-E-Mails mit Postmark für einen Server: einzelne, Batch- und Vorlagen-E-Mails senden, Vorlagen pflegen, gesendete und eingehende Nachrichten mit Öffnungen, Klicks und Bounces durchsuchen, Versandstatistiken lesen sowie Suppressions, Message Streams und Webhooks verwalten. Mit optionalem Account-Token liest er auch Server, Domains und Absendersignaturen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

POSTMARK_SERVER_TOKEN (optional: POSTMARK_ACCOUNT_TOKEN)

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Postmark-Konto mit einem Server.

1. Öffne in Postmark den Server, dann API Tokens, und kopiere ein Server API token in POSTMARK_SERVER_TOKEN. Es wird als Header X-Postmark-Server-Token gesendet und erreicht nur diesen einen Server.
2. Optional: Für die Account-Tools (postmark_list_servers, postmark_get_server_by_id, postmark_list_domains, postmark_get_domain, postmark_verify_domain_dkim, postmark_verify_domain_return_path, postmark_list_sender_signatures, postmark_get_sender_signature) kopiert ein Account-Owner oder Admin das Account API token aus Account, API Tokens in POSTMARK_ACCOUNT_TOKEN. Es wird nur bei diesen Tools als X-Postmark-Account-Token gesendet. Ohne dieses Token antworten sie mit 401; alle anderen Tools funktionieren.
3. Installiere den Connector und führe postmark_get_server aus: Es zeigt die Einstellungen des Servers und bestätigt das Token.

Beide Tokens sehen aus wie eine UUID (8-4-4-4-12 Hexadezimalzeichen).

Senden: postmark_send_email schickt eine E-Mail an bis zu 50 Empfänger mit Betreff, HTML- und/oder Text-Body, Tag, Metadaten, Tracking und Anhängen. postmark_send_batch schickt bis zu 500 verschiedene E-Mails in einem Aufruf. postmark_send_email_with_template und postmark_send_batch_with_templates nutzen eine gespeicherte Vorlage (TemplateId oder TemplateAlias) mit einem TemplateModel aus Variablen. From muss eine bestätigte Absendersignatur oder eine Adresse auf einer verifizierten Domain sein. Neue Konten bleiben im Testmodus, bis Postmark sie freigibt, und können nur an Adressen der eigenen Domain senden. Transaktions-E-Mails laufen über den Stream outbound (Standard); Massen- oder Marketing-E-Mails müssen einen Broadcasts-Stream (MessageStream) nutzen, der die Abmeldung übernimmt. Jeder Versand landet in echten Postfächern, deshalb zeigt dir die KI Empfänger, Betreff und Inhalt und wartet auf dein Ja. Batch-Aufrufe antworten auch dann mit 200, wenn einzelne Nachrichten scheitern: Die KI prüft ErrorCode (0 = angenommen) und Message jedes Ergebnisses.

Vorlagen: postmark_list_templates, postmark_get_template, postmark_validate_template (prüft die Syntax und rendert eine Vorschau mit einem Testmodell, ohne zu speichern), postmark_create_template und postmark_update_template. Variablen nutzen Mustachio, zum Beispiel {{name}}; ein Layout umschließt Standardvorlagen mit {{{@content}}}.

Herausfinden, was mit einer E-Mail passiert ist:

• Gesendete Mails suchst du mit postmark_search_outbound_messages nach Empfänger, Absender, Tag, Betreff, Status, Stream, Datum oder einem Metadatenfeld, empfangene mit postmark_search_inbound_messages. postmark_retry_inbound_message schickt eine fehlgeschlagene eingehende Nachricht erneut an den Inbound-Webhook.
• postmark_get_outbound_message oder postmark_get_inbound_message zeigt die Details und bei gesendeten Mails die Zeitleiste MessageEvents (Delivered, Bounced, Opened, LinkClicked, SubscriptionChanged).
• Öffnungen und Klicks: postmark_list_message_opens, postmark_get_message_opens, postmark_list_message_clicks, postmark_get_message_clicks, mit E-Mail-Client, Browser, Betriebssystem, Plattform und Standort.
• Bounces: postmark_get_delivery_stats, postmark_list_bounces, postmark_get_bounce und postmark_get_bounce_dump (die rohe SMTP-Antwort, 30 Tage aufbewahrt). postmark_activate_bounce aktiviert eine Adresse wieder, wenn CanActivate true ist.
• Suppressions pro Stream: postmark_list_suppressions und postmark_create_suppressions (bis zu 50 Adressen pro Aufruf).

Statistiken: postmark_get_outbound_overview liefert Summen und Quoten für einen Zeitraum (gesendet, Bounces, Spam-Beschwerden, Öffnungen, eindeutige Öffnungen, getrackte E-Mails, Link-Klicks). postmark_get_outbound_stats mit metric liefert Tageswerte für Versand, Bounces, Spam, Tracking, Öffnungen, Klicks, Plattformen, E-Mail-Clients, Browser oder Standorte.

Server-Einrichtung: postmark_get_server; Message Streams mit postmark_list_message_streams, postmark_get_message_stream, postmark_create_message_stream (höchstens 10 Streams pro Server, davon einer Inbound), postmark_update_message_stream und postmark_unarchive_message_stream; Webhooks mit postmark_list_webhooks, postmark_get_webhook, postmark_create_webhook und postmark_update_webhook. Mit dem Account-Token listet die KI auch Server, Domains und Absendersignaturen, zeigt die DNS-Einträge, die eine Domain braucht, und lässt Postmark DKIM und Return-Path prüfen, nachdem du sie eingetragen hast.

Bei der Installation deaktiviert: postmark_delete_template, postmark_delete_suppressions (damit erhalten unterdrückte Adressen wieder E-Mails), postmark_delete_webhook und postmark_archive_message_stream (ein archivierter Stream sendet nicht mehr und wird nach 45 Tagen samt Daten gelöscht, wenn er nicht wiederhergestellt wird). Ein Workspace-Admin schaltet sie ein, wenn das Team sie braucht.

Datenformate: Feldnamen sind PascalCase (MessageID, SubmittedAt, TotalCount). Suchdaten (fromdate, todate) sind US-Ostküstenzeit (US Eastern); zurückgegebene Zeitstempel tragen ihren Offset. Statistikdaten sind YYYY-MM-DD. Nachrichten und ihre Events werden für die Aufbewahrungsdauer des Servers gespeichert, standardmäßig 45 Tage.

Blättern: Listen- und Such-Tools nehmen count (Standard 50, höchstens 500) und offset; count plus offset darf 10.000 nicht übersteigen. Um weiter zurückzugehen, grenzt die KI den Zeitraum ein. Der Vergleich von TotalCount mit den erhaltenen Zeilen zeigt, ob es weitere Seiten gibt.

Häufige Fehler: 401 bedeutet ein fehlendes oder falsches Token oder das Server-Token bei einem Account-Tool. 422 bedeutet eine ungültige Anfrage; ErrorCode und Message nennen den Grund: 300 Versandvalidierung (etwa eine ungültige Adresse oder ein fehlender Body), 406 ein inaktiver oder unterdrückter Empfänger, 410 mehr als 500 Nachrichten in einem Batch, 412 Empfänger außerhalb der From-Domain, solange das Konto auf Freigabe wartet, 1101 Vorlage nicht gefunden, 1235 unbekannter Message Stream. 429 bedeutet zu viele Anfragen; 500 ist ein Problem bei Postmark, versuch es später erneut.

Der Connector legt keine Server, Domains oder Absendersignaturen an, entfernt keine Suppressions wegen Spam-Beschwerden und löscht keine gesendeten Nachrichten.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Postmark-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Ist unsere Passwort-Reset-Mail an [email protected] gestern angekommen? Zeig mir ihre Zustell-Events.“
• „Wie viele E-Mails haben wir letzte Woche verschickt, und wie hoch waren Bounce- und Spam-Beschwerdequote?“
• „Liste die Hard Bounces der letzten 7 Tage mit Empfänger und der Antwort des empfangenden Servers auf.“
• „Schick die Willkommensvorlage an [email protected] mit dem Vornamen Tom. Zeig mir die gerenderte E-Mail vor dem Senden.“
• „Ist der DKIM-Eintrag unserer Versanddomain schon verifiziert? Wenn nicht, zeig mir den DNS-Eintrag, den ich anlegen muss.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden