Was macht E-Mail-Countdowns?
Email Countdowns (https://emailcountdowns.com) hostet ein Countdown-GIF für jede Kampagnenfrist. Das Bild wird beim Öffnen der E-Mail gezeichnet und zeigt die zu diesem Zeitpunkt verbleibende Zeit an. Sie erstellen den Timer, nehmen den zurückgegebenen embed_html auf und fügen ihn in die E-Mail ein.
Basis-URL: https://emailcountdowns.com
1. Wählen Sie, wie Sie den Dienst erreichen möchten
Prüfen Sie, was Sie verwenden können, in dieser Reihenfolge:
- MCP-Tools sind verbunden. Ihre Werkzeugliste enthält
create-countdownundget-countdown-stats(der Server wird oft als "Email Countdowns" oder "Countdown Automation" angezeigt). Verwenden Sie diese und fahren Sie mit Schritt 3 fort. - Ein API-Key ist verfügbar. Der Benutzer hat Ihnen einen Workspace-Key gegeben, oder
COUNTDOWN_API_KEYist in der Umgebung gesetzt. Verwenden Sie die REST-API in references/rest-api.md. - Keines von beidem. Der Benutzer benötigt einen Arbeitsbereich und eine Verbindung. Fahren Sie mit Schritt 2 fort.
Bitten Sie den Benutzer nicht, ein Passwort in den Chat einzufügen. Geben Sie niemals ein Passwort für sie ein.
2. Einen Arbeitsbereich einrichten (nur bei Bedarf)
Fragen Sie einmal: "Hast du bereits ein Email-Countdowns-Konto?"
Kein Konto. Senden Sie den Benutzer an https://emailcountdowns.com/register. Jedes neue Konto erhält einmalig 1.000 kostenlose Countdown-Ansichten, ohne Karte und ohne Abonnement, sodass Sie Timer erstellen und testen können, ohne Geld auszugeben. Sie geben einen Namen, einen optionalen Arbeitsbereichsnamen, eine E-Mail-Adresse und ein Passwort ein. Wenn Sie einen Browser steuern, können Sie diese Seite öffnen und den Namen, den Arbeitsbereich und die E-Mail ausfüllen, die der Benutzer Ihnen gegeben hat; der Benutzer gibt das Passwort selbst ein und drückt auf Registrieren.
Verbinden Sie es. Wählen Sie den Weg, der zu dem Client passt, in dem Sie arbeiten:
| Client | Wie verbinden |
|---|---|
| Claude (Web, Desktop) | Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen. Name Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Wählen Sie Verbinden, anmelden, genehmigen. Aktivieren Sie ihn im Chat. |
| Claude Code | claude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, dann /mcp ausführen und authentifizieren. Die Installation dieses Repositorys als Plugin fügt den Server für Sie hinzu. |
| ChatGPT | Einstellungen → Apps → Erweiterte Einstellungen → Entwicklermodus aktivieren. App erstellen, Name Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, Authentifizierung OAuth. Verbinden, dann die App im Menü "Werkzeuge" in einem neuen Chat auswählen. Plan- und Arbeitsbereichseinstellungen entscheiden, ob dies verfügbar ist. |
| Codex CLI | codex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, dann codex mcp login email-countdowns. |
| Gemini CLI | gemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, dann /mcp auth countdowns. |
| Scripts, benutzerdefinierte GPT-Aktionen, alles ohne MCP | Der Arbeitsbereichsbesitzer erstellt einen Schlüssel unter Team-API-Key unter https://emailcountdowns.com/workspace. Speichern Sie ihn als COUNTDOWN_API_KEY. Siehe references/rest-api.md. |
Die OAuth-Anmeldung erfolgt im Browser des Benutzers. Wenn sie noch nicht registriert sind, können sie sich zuerst registrieren und dann die Verbindung erneut ausführen. Der Zustimmungsbildschirm gewährt Zugriff auf den Arbeitsbereich, der zum Zeitpunkt der Genehmigung aktiv ist.
Nach der Verbindung rufen Sie get-countdown-stats mit {"days": 7} auf, um zu bestätigen, dass die Verbindung funktioniert. Teilen Sie dem Benutzer mit, welcher Arbeitsbereichsname zurückgegeben wurde.
3. Die Frist festlegen
Sie benötigen vier Fakten, bevor Sie etwas erstellen:
| Feld | Format | Hinweise |
|---|---|---|
name | Text, max. 255 | Internes Label, auch als Alternativtext des Bildes verwendet. Machen Sie es lesbar: "Black-Friday-Angebot endet". |
date | YYYY-MM-DD | Muss eine zukünftige Frist sein. |
time | HH:MM, 24-Stunden | Der Zeitpunkt, zu dem der Timer Null erreicht. |
timezone | IANA-Name | Europe/London, America/New_York, Australia/Sydney. |
Senden Sie auch campaign_key: einen kurzen stabilen Slug für diese Frist, z. B. black-friday-2026. Ein erneuter Versuch mit demselben Schlüssel und denselben Einstellungen gibt den vorhandenen Timer zurück, anstatt ein Duplikat zu erstellen. Eine andere Frist erfordert einen anderen Schlüssel.
Beseitigen Sie Mehrdeutigkeiten, bevor Sie das Werkzeug aufrufen:
- "Endet Freitag um Mitternacht" kann 00:00 zu Beginn des Freitags oder 23:59 an seinem Ende bedeuten. Fragen Sie nach oder geben Sie Ihre Interpretation an: "Ich setze 23:59 am Freitag, den 27. November, Europe/London."
- Konvertieren Sie Abkürzungen in IANA-Zonen: EST/EDT →
America/New_York, PST/PDT →America/Los_Angeles, GMT/BST →Europe/London, CET →Europe/Paris, AEST →Australia/Sydney. Wenn die Zielgruppe über mehrere Regionen verteilt ist, verwenden Sie die Zone, in der das Angebot definiert ist. - Kein Jahr angegeben: Verwenden Sie das nächste Vorkommen dieses Datums.
- Lesen Sie das Datum aus dem E-Mail-Text, wenn der Benutzer einen Entwurf erstellt. Der Timer und der Text müssen übereinstimmen.
Bestätigen Sie die Frist dem Benutzer gegenüber in einer Zeile, bevor Sie den Timer erstellen, es sei denn, der Benutzer hat bereits alle vier Fakten unmissverständlich angegeben.
Optionale Erscheinungsfelder:
text_colour: hex,#RRGGBB. Standard#000000.background_colour: hex odertransparent. Standard#ffffff. Passen Sie es an den Hintergrund der E-Mail an, in der der Timer sitzt.style_id,font_id: Ganzzahlen. Senden Sie nur IDs, die der Benutzer Ihnen gegeben hat oder die Sie aus seinem Dashboard-Editor gelesen haben. Raten Sie nicht; eine unbekannte ID führt zu einem Validierungsfehler. Lassen Sie beide für den Standardstil weg.description: Freitext, max. 1.000.
4. Den Countdown erstellen
MCP:
{
"name": "create-countdown",
"arguments": {
"name": "Winterausverkauf endet",
"campaign_key": "winter-sale-2026",
"date": "2026-12-18",
"time": "17:00",
"timezone": "Europe/London",
"background_colour": "#ffffff",
"text_colour": "#1a1a1a"
}
}
Das Ergebnis enthält id, name, expires_at, gif_url und embed_html. Die REST-API gibt dieselben Felder unter data zurück (siehe references/rest-api.md).
Fehler, die Sie beheben können:
Choose a future deadline.Das Datum und die Uhrzeit liegen in dieser Zeitzone in der Vergangenheit. Überprüfen Sie das Jahr und die Zone.This campaign key already has different settings.Der Schlüssel wurde für eine andere Frist verwendet. Verwenden Sie einen neuen Schlüssel oder verwenden Sie die ursprünglichen Einstellungen erneut.- Ungültiges
timezone-,date- odertime-Format. Korrigieren Sie das Format und wiederholen Sie den Vorgang mit demselben Schlüssel.
5. In die E-Mail einfügen
embed_html sieht so aus:
<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Winterausverkauf endet" width="300" style="max-width:100%;border:0;display:block;" />
Regeln:
- Verwenden Sie die gehostete URL genau wie zurückgegeben. Laden Sie das GIF nicht herunter, laden Sie es nicht in die Bildbibliothek der E-Mail-Plattform hoch und hängen Sie es nicht an. Ein kopiertes GIF ist im Moment des Kopierens eingefroren.
- Fügen Sie dem
srckeine Abfragezeichenfolgen, Größenänderungsparameter oder Proxys hinzu. - Sie können die
widthändern (bis zur Inhaltsbreite, normalerweise 600) und das Tag in einen Link zum Angebot einbinden. Behalten Siemax-width:100%bei, damit es auf Telefonen schrumpft. - Um es zu zentrieren, umschließen Sie es:
<table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>. - Fügen Sie die Frist in Klartext in der Nähe des Timers ein, für Leser, deren Client Bilder blockiert: "Angebot endet am 18. Dezember um 17:00 Uhr britischer Zeit."
- Platzieren Sie ihn in der Nähe des Calls-to-Action, den er unterstützt, normalerweise direkt über oder unter der Hauptschaltfläche.
Plattformspezifische Schritte (Klaviyo, Mailchimp, Resend, HubSpot und andere) finden Sie in references/email-platforms.md. Wenn Sie den Entwurf über ein anderes verbundenes Tool bearbeiten können, fügen Sie das HTML dort ein, lesen Sie den Entwurf dann erneut und überprüfen Sie, ob die src unverändert ist. Wenn Sie den Entwurf nicht bearbeiten können, geben Sie dem Benutzer das HTML und die Bild-URL mit einem Satz, wo er sie einfügen soll.
Senden oder planen Sie die Kampagne nicht. Das bleibt dem Benutzer überlassen.
Überprüfen Sie vor einem großen Versand, ob der Arbeitsbereich genügend Ansichten hat. Sobald die 1.000 kostenlosen Ansichten aufgebraucht sind, zeigen Timer ein leeres Bild, bis der Arbeitsbereichsbesitzer die kostenpflichtige Nutzung unter Nutzung und Abrechnung unter https://emailcountdowns.com/dashboard/account aktiviert. Wenn die Liste größer ist als die verbleibenden kostenlosen Ansichten, teilen Sie dem Benutzer mit, dass er zuerst die Abrechnung aktivieren soll.
6. Rückmeldung geben
Geben Sie dem Benutzer:
- die erstellte Frist mit Zeitzone
- die Bild-URL
- das Einbettungs-HTML in einem Codeblock
- wo Sie es platziert haben oder wo er es einfügen soll
- die Klartext-Fallback-Zeile, die Sie hinzugefügt oder empfohlen haben
Statistiken
get-countdown-stats benötigt days (1–90, Standard 30) und gibt für den aktiven Arbeitsbereich zurück: Gesamtzahl und aktive Countdowns, Ansichten insgesamt, Ansichten im Zeitraum und eine tägliche Serie. Eine Ansicht ist eine Anfrage für das Bild. E-Mail-Clients und Proxy-Dienste für den Datenschutz (Apple Mail Privacy Protection, Gmail-Bildproxy) können Bilder vorab abrufen oder zwischenspeichern, sodass Ansichten keine eindeutigen menschlichen Öffnungen sind. Sagen Sie dies, wenn Sie sie melden.
Ändern oder Löschen eines Timers
MCP-Tools erstellen nur Timer und lesen Statistiken. Um die Frist oder Farben zu ändern oder einen Timer zu löschen, verwenden Sie die REST-API mit einem Arbeitsbereichsschlüssel oder das Dashboard unter https://emailcountdowns.com/dashboard.
Das Löschen eines Timers zerstört das Bild in jeder E-Mail, die bereits damit gesendet wurde. Bestätigen Sie dies mit dem Benutzer, bevor Sie löschen, und ziehen Sie es vor, abgeschlossene Timer an Ort und Stelle zu belassen; nach Ablauf der Frist zeigt das Bild Null an.
Mehr
- Agenten- und API-Anleitung: https://emailcountdowns.com/docs/api (Markdown: https://emailcountdowns.com/ai.md)
- Preise: https://emailcountdowns.com/pricing
