MCP Server für echte Postkarten

Was der EchtPost-MCP-Server konkret kann

Der Server stellt die wichtigsten Aktionen der EchtPost-API v2 als MCP-Tools bereit. Dein Agent kann damit zum Beispiel:

Vollständige Tool-Liste mit allen Parametern steht in der API-Doku (Englisch). Was die API kann, kann auch der MCP-Server – wir bauen keine Funktionen separat ein, sondern legen den Wrapper drumherum.

Was du damit tatsächlich machen kannst

Vier kurze Beispiele, wie der Tag mit dem MCP-Server in deinem KI-Tool aussehen kann:

„Schick Anna eine Geburtstagskarte zum 40. mit dem Blumenstrauß-Motiv und einem netten Spruch.“

Dein Agent zieht Annas Adresse aus deinem Adressbuch (list_contacts), wählt das Motiv (list_motives → get_motive), schreibt einen passenden Text und legt die Karte an (create_card). Du bekommst eine Vorschau zur Freigabe, danach geht sie raus.

„Schick eine Karte an Axel von Leitner, Herderstraße 70, 50931 Köln – such ein fröhliches Motiv zum Geburtstag aus und gratulier ihm herzlich.“

Hier brauchst du weder einen Kontakt im Adressbuch noch ein vorab gewähltes Motiv. Der Agent übergibt die komplette Anschrift direkt an create_card, sucht über list_motives ein passendes Geburtstagsmotiv aus deinem Sortiment und formuliert den Glückwunsch. Empfänger, Motiv, Text – alles in einem Rutsch.

„Welchen Trial-Kunden aus letzter Woche schicken wir eine Willkommens-Postkarte?“

Der Agent fragt dein CRM (anderer MCP-Server, gleicher Workflow), zieht die Liste, schreibt für jeden Kontakt einen kurzen personalisierten Text und schickt das Paket über create_card raus. Eine echte Karte pro Trial-Account, ohne dass du eine Tabelle anfasst.

„Bevor wir die Kampagne live schalten, sende mir eine Test-Karte mit Motiv X an meine eigene Adresse.“

Der Agent baut eine Test-Karte und schickt sie an dich. Du bekommst sie ein paar Tage später im Briefkasten und kannst Format und Druck prüfen, bevor 500 Karten an deine Kunden gehen.

„Wie viel Postkarten-Budget habe ich noch diesen Monat?“

list_credits antwortet in Sekunden. Praktisch, wenn du gerade keine Lust hast, dich im Konto einzuloggen, nur um auf eine Zahl zu schauen.

Setup-Daten auf einen Blick

Egal, welches KI-Tool du nutzt – du brauchst eigentlich nur zwei Dinge: einen Namen (frei wählbar) und unsere Server-URL. Den Rest erledigt der Server.

Beide Auth-Wege gehen gegen denselben Account und dieselben Tools – die Funktionalität ist identisch, nur der Weg zur Anmeldung unterscheidet sich.

Einrichten – Schritt für Schritt

Wer schon einmal einen MCP-Server in seinem KI-Tool angebunden hat, ist hier in drei Minuten durch. Wer noch nie – die Schritte unten sind alles, was du brauchst.

In Claude Code

Gleicher Weg wie in Claude Desktop: MCP-Server mit Name EchtPost und URL https://mcp.echtpost.de anlegen, beim ersten Aufruf läuft der OAuth-Flow im Browser.

Eigener Agent / Framework

Der Server spricht den offiziellen MCP-Standard. Wenn dein Framework (LangChain, Mastra, AutoGen, eigener Code) OAuth gegen einen MCP-Server kann, brauchst du nur unsere URL. Wenn nicht, nutz den API-Token aus deinen EchtPost-Einstellungen als Authorization: Bearer <token>. Beide Wege gehen gegen denselben Account.

Häufige Fragen

Brauche ich Programmierkenntnisse, um den MCP-Server zu nutzen?

Nein. Wenn du Claude Desktop, Claude Code oder Le Chat schon nutzt, weißt du, wie ein MCP-Server eingerichtet wird – Name eingeben, unsere URL eintragen, einmal anmelden (OAuth oder API-Key). Fertig. Wenn du noch nie einen MCP-Server angebunden hast: Die Schritte oben sind alles, was du brauchst, und sie unterscheiden sich nicht von anderen Servern (Stripe, GitHub, Linear). Kein Code, keine Doku-Wälzerei.

OAuth oder API-Key – wann was?

Beides ist im Server eingebaut, welcher Weg verfügbar ist, hängt vom KI-Tool ab: Claude Desktop und Claude Code laufen über OAuth – das KI-Tool schickt dich einmal durch unseren Login, das Token wird vom Tool selbst verwaltet. Mistral Le Chat verlangt heute einen API-Key aus deinen EchtPost-Einstellungen (OAuth ist in Le Chat noch nicht freigeschaltet). ChatGPT läuft ebenfalls über OAuth – dafür muss in ChatGPT einmalig der Entwicklermodus unter Einstellungen → Apps aktiviert werden. Eigene Agents / Frameworks können beides – nimm, was dein Setup besser kann. Beide Wege gehen gegen denselben Account und dieselben Tools.

Was ist der Unterschied zur EchtPost-API?

Die API ist das Backend – ein direkter REST-Zugang für eigenen Code oder Workflow-Tools wie n8n, Zapier und Make. Der MCP-Server sitzt darüber und macht dieselben Funktionen für KI-Tools wie Claude und Mistral Le Chat verfügbar. Du brauchst nicht beides – du wählst den Weg, der zu deinem Setup passt. Account und Abrechnung sind dieselben.

Kann der Agent meine eigenen Motive und gespeicherten Vorlagen nutzen?

Ja, beides – dein Agent arbeitet mit demselben Bestand, den du im EchtPost-Konto siehst.

Motive: list_motives gibt alle Kartenvorderseiten zurück, die für dein Konto auswählbar sind – unser Sortiment und die eigenen, die du hochgeladen hast. Der Agent kann nach Name, Beschreibung oder hinterlegtem Stichwort suchen und bekommt zu jedem Motiv eine Vorschau-URL. Die ID aus der Antwort setzt er direkt als motive_id in create_card ein. Du musst also keine ID abtippen – „nimm unser Sommermotiv“ reicht. Eine frisch hochgeladene eigene Vorderseite taucht auf, sobald wir sie freigegeben haben; das ist derselbe Schritt wie im Kartendesigner.

Vorlagen: list_templates listet die Vorlagen, die du in EchtPost gespeichert hast – mit Name, Motiv, Text und Schrift. create_card_from_template braucht danach nur noch template_id, Empfänger und Versanddatum, den Rest liefert die Vorlage. Praktisch, wenn das Layout im Marketing gepflegt wird und der Agent nur noch auslöst. Wenn du die ID lieber selbst nachschlägst: Sie steht in EchtPost unter Vorlagen an jedem Eintrag.

Wie viel Text passt auf eine Karte – und muss mein Agent das wissen?

Genug für eine Postkarte, zu wenig für einen Brief: In der Standardschrift landet eine Karte mit Anrede, zwei Absätzen und Grußformel bei rund 240 Zeichen. Eine harte Zeichengrenze gibt es nicht, weil Schriftart, Schriftgröße und die Absätze mitreden – jede Leerzeile kostet zwei Zeilen. Die Zahlen je Schrift und Größe stehen in der Tabelle auf der API-Seite.

Ausrechnen muss das niemand. Dafür gibt es preview_fit: Das Tool bekommt den Text und antwortet, ob er passt, wie viele Zeilen er belegt und – wenn es knapp wird – mit welcher kleineren Schriftgröße es doch klappt. In der Tool-Beschreibung steht ausdrücklich, dass der Agent vor create_card erst messen soll.

Überspringt er es trotzdem, lehnt create_card zu langen Text ab. Die Antwort nennt die belegten Zeilen und eine kleinere Schriftgröße, mit der es passen würde – einen gekürzten Text schicken wir nicht zurück, kürzen oder die Größe setzen muss der Agent selbst. Eine Karte mit abgeschnittenem Text kommt so nicht in den Druck.

Wenn der Text sowieso immer derselbe ist und nur die Anrede wechselt, dreh es um: Karte einmal im EchtPost-Editor bauen, als Vorlage speichern und den Agent nur noch create_card_from_template auslösen lassen. Dann hast du die Umbrüche vorher mit eigenen Augen gesehen.

Funktioniert das auch mit ChatGPT?

Ja – seit kurzem auch in ChatGPT. Einziger Unterschied zu Claude: Du musst in ChatGPT einmalig den Entwicklermodus aktivieren (Einstellungen → Apps → Toggle Entwicklermodus). Das ist eine ChatGPT-seitige Voraussetzung für jeden Connector, der nicht in deren offiziellem Verzeichnis steht – nicht spezifisch für uns. Danach Connector mit URL https://mcp.echtpost.de anlegen, OAuth-Flow läuft wie in Claude. Für jedes andere Tool, das den offiziellen MCP-Standard spricht (LangChain, Mastra, AutoGen, eigener Agent), reichen URL und Auth – alles aus der Setup-Tabelle weiter oben.

Wie sicher ist das? Was sieht der KI-Anbieter?

Der MCP-Server läuft bei uns, nicht beim KI-Anbieter. Die Authentifizierung läuft direkt zwischen dir und uns – entweder per OAuth (das KI-Tool bekommt ein Token, das du jederzeit in deinem EchtPost-Konto widerrufen kannst) oder per API-Key, den du selbst rotieren kannst. Deine EchtPost-Login-Daten sieht das KI-Tool nie. Dein Agent (Claude, Mistral Le Chat, ChatGPT) sieht nur die Antworten, die wir zurückgeben – Empfängerlisten, Vorschau-URLs, Status. Trotzdem: KI-Tools können Fehler machen – in den ersten Wochen lohnt es sich, die Vorschau-Antwort des Agents vor dem Auslösen einmal zu prüfen.

Kann ich den Postkartenversand komplett mit europäischer Infrastruktur machen?

Ja. Mistral Le Chat (Frankreich) ist als gleichberechtigter Client gelistet, der MCP-Server selbst läuft bei uns in Deutschland, gedruckt wird bei einem deutschen Druckpartner, versendet mit der Deutschen Post. Wenn du US-Anbieter aus deinem Workflow rausnehmen willst, ist das hier ohne Funktions-Abstriche möglich.

Welche MCP-Server für Postkarten gibt es?

In den MCP-Verzeichnissen findest du ein paar Postkarten-Server – manche sind rein digital, manche eher experimentelle API-Wrapper. Unser Server ist auf physischen Versand in Deutschland ausgelegt: echte Karte, echte Briefmarke, Deutsche Post. Und er kommt vom Anbieter, der die Karten am Ende auch wirklich druckt.

Wie schnell ist die Karte beim Empfänger?

Werktäglich produzieren wir die Karten und übergeben sie am Folgetag an die Post. Innerhalb Deutschlands rechnest du danach mit den üblichen 1–3 Werktagen – mehr versprechen können wir nicht, weil ab Versand die Post übernimmt.

Gibt es einen Sandbox-Modus zum Testen?

Für die REST-API ja. In deinen EchtPost-Einstellungen legst du einen Schlüssel im Modus Sandbox an – er trägt das Präfix ep_test_. Karten, Kontakte und Gruppen, die damit entstehen, liegen getrennt von deinen Live-Daten, werden nicht abgerechnet und gehen nicht in den Druck. Über einen Button in denselben Einstellungen räumst du die Sandbox-Daten wieder ab.

Im MCP-Server gilt dasselbe, sobald du dich mit einem Sandbox-Schlüssel anmeldest – also überall dort, wo du per API-Key verbindest, etwa in Mistral Le Chat. Dein Agent sieht dann nur Testdaten, und was er anlegt, wird weder berechnet noch gedruckt. Motive und Vorlagen stehen in beiden Modi gleich zur Verfügung.

Über OAuth – also in Claude und ChatGPT – geht das nicht: Der Modus steckt im Schlüssel, und ein OAuth-Login hat keinen. Zum Ausprobieren trägst du dort deine eigene Adresse als Empfänger ein und brichst die Karte über cancel_card ab, solange sie nicht im Druck ist.

Was passiert, wenn der Agent eine Karte falsch erstellt?

Die Server-Antwort enthält eine Vorschau (Motiv + finaler Text), an der du oder dein Agent gegenchecken könnt, bevor die Karte tatsächlich in Druck geht. Falls doch etwas durchrutscht: Solange die Karte noch nicht im Druck ist, kannst du sie über cancel_card stornieren – aus dem Agent heraus oder direkt im EchtPost-Konto.