Für Entwickler und KI-Agenten
FrankKi für Entwickler
Verbinde deinen Client
Claude, Claude Desktop, Claude Code und ChatGPT melden sich per OAuth an. Du trägst die Adresse ein, meldest dich im Browserfenster bei FrankKi an oder legst dort dein Konto an und erlaubst den Zugriff. Einen Produktions-Token brauchst du nur für Skripte, Server und Clients ohne Anmeldefenster. Eine Sandbox gibt es für normale Konten nicht. Zum kostenlosen Testen nimmst du dryRun: dieselben Prüfungen und derselbe Preis, ohne Druck und ohne Abbuchung.
Claude-Desktop-Quickstart öffnenWas FrankKi MCP ist: der MCP Server für Briefe
FrankKi ist die agentische Ebene des Briefs: physische Post für KI-Agenten und Menschen. FrankKi MCP ist die live geschaltete Schnittstelle, mit der du Briefe mit KI-Agent versendest, ein gehosteter Model-Context-Protocol-Server unter https://mcp.frankki.app, über den dein Agent echte Briefe entwirft, kalkuliert, versendet und nachverfolgt, per One-Shot-Versand-Aufruf statt eines mehrstufigen Formulars. Der offizielle Name in der MCP-Registry ist app.frankki/letters. Dieselbe Partner-Schnittstelle gibt es als REST-Variante. Zugestellt wird weltweit: lokale Posttarife in DACH und mehreren europäischen Ländern, in den Rest der Welt per DHL. Für fristgebundene und rechtlich relevante Post kommen Einschreiben mit Einlieferungsbeleg, Mandantentrennung und Freigabe-Workflows mit menschlicher Entscheidung vor dem Versand dazu. Bezahlt wird pro Brief, ohne Abo, aus einem geschlossenen Guthaben-Kreislauf (Closed-Loop-Wallet): du lädst einmal Guthaben auf, jeder Versand zieht Cent-genau davon ab, ohne Kreditkarten-Prompt pro Brief.
Bevor du startest
- Schritt 0
Konto anlegen
Du legst es im Anmeldefenster an, wenn du Claude oder ChatGPT verbindest, oder vorher unter /dashboard/registrieren. Kostenlos, ohne Einladung und ohne Firma.
- Schritt 1
Anmeldeweg wählen
Claude, Claude Desktop, Claude Code und ChatGPT: trag https://mcp.frankki.app ein und melde dich per OAuth 2.1 an (PKCE, Dynamic Client Registration). Skripte, Server, Cursor und andere Clients ohne Anmeldefenster: erzeuge unter /dashboard/tokens einen Produktions-Token mit genau den Rechten, die du brauchst. Er wird einmal angezeigt. Schick ihn als Authorization: Bearer.
- Schritt 2
Absenderprofil und AVV
Vervollständige das Absenderprofil und unterschreib den AVV. dryRun prüft beides, also erledigst du das vor der ersten Probe. Vor dem ersten echten Versand lädst du Guthaben auf (ab 10 €).
- Schritt 3
Zuerst mit dryRun proben
Rufe mcp_health auf und probe order_send mit dryRun:true. Die Probe ist kostenlos und liefert Preis und Seite 1 als Bild. Ein echter Versand ohne dryRun wartet auf die Freigabe im Dashboard.
Quickstart pro Client
Claude Desktop
Connector hinzufügen, "Sign in now" wählen, bei FrankKi anmelden. Kein Token nötig.
Claude Code
claude mcp add --transport http frankki https://mcp.frankki.app, danach /mcp zum Anmelden.
ChatGPT
Als eigenen MCP-Server mit OAuth hinzufügen, sofern dein ChatGPT-Tarif das erlaubt.
Cursor
Produktions-Token aus /dashboard/tokens als Authorization-Header in .cursor/mcp.json.
Mehr Referenz
Sicheres Agent-Onboarding
Der Ablauf von der Anmeldung bis zur Freigabe: OAuth oder API-Key, Adressprüfung, Vorschau, Preislimit, Freigabe, Idempotenz und Storno. Proben machst du mit dryRun.
Tool-Referenz
Alle Tools mit Namen, Beschreibung und Feldern, direkt aus der echten Registry generiert.
Fehlerkatalog
Jeder Fehlercode mit Bedeutung, Recovery-Klasse und Korrektur-Link.
Konventionen
ISO-8601, Cent-Beträge, Idempotenz und dryRun an einem Ort.
Briefdesign
Wiederverwendbarer Briefkopf, Infoblock, Fußzeile, QR-Code und Falzmarken: speichern, prüfen und pro Brief mit designId und reference einsetzen.
Strukturierte Briefinhalte (blocks)
Rechnungen, Tabellen und gestylte Briefe mit blocks und styleDefs statt Fliesstext bauen: Vokabular, Limits und die letter_preview-Gestaltungsschleife.
E-Rechnung: ZUGFeRD und XRechnung
Wie aus einer versendeten Rechnung eine ZUGFeRD-PDF/A-3 mit EN-16931-XML und eine XRechnung werden: Ablauf, Dateiinhalt, Sperrgründe und der Download-only-Rahmen.
Transkript: Kompletter Briefauftrag
Der ganze Auftrag in einem Gespräch: Preis, Entwurf, Anhang, Versand in die Freigabe, menschliche Freigabe, Verfolgung, Storno und Korrektur.
Webhooks (Vorschau)
Geplante Event-Typen und Signatur-Vertrag, noch nicht live.
Changelog
Versionsstand der API und künftige Änderungen.
Vertrauen und Live-Status
Maschinenlesbare Servicefakten und der aktuelle Betriebsstatus der Partner-Schnittstelle stehen jederzeit offen zur Verfügung, ohne Login.