Für Entwickler und KI-Agenten
FrankKi für Entwickler
Mit Produktion verbinden
Die Sandbox ist derzeit nicht verfügbar. Interaktive Clients verbinden sich per OAuth 2.1 mit https://mcp.frankki.app, Headless-Integrationen nutzen einen klar begrenzten Produktions-Token. Produktive Aufrufe können dein Guthaben belasten und echte Briefe verschicken. Starte deshalb mit dryRun und prüfe jeden Versand vor der Ausführung.
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
Leg dein Konto unter /dashboard/registrieren an, kostenlos und ohne Einladung. Wir schicken dir eine E-Mail mit einem einmaligen Link, darüber legst du dein Passwort fest und schließt den ersten Onboarding-Schritt ab, das dauert ein bis zwei Minuten, ohne AVV und ohne Guthaben-Aufladung.
- Schritt 1
Authentifizierungsweg wählen
Interaktive Clients (Claude Desktop, ChatGPT, Cursor, VS Code): trag https://mcp.frankki.app als Remote-MCP-Server ein und lass den Client sich selbst anmelden. OAuth 2.1 mit Authorization Code, PKCE (S256) und Dynamic Client Registration (RFC 7591) läuft produktiv, geprüft am 2026-08-13 über https://mcp.frankki.app/.well-known/oauth-authorization-server. Headless- und Server-Integrationen: öffne /dashboard/tokens und erzeuge einen Produktions-Token mit genau den Rechten, die deine Integration braucht. Der Token wird einmal angezeigt. Bewahre ihn sicher auf und schick ihn als Authorization: Bearer.
- Schritt 2
Produktionsvoraussetzungen erfüllen
Vervollständige Absenderprofil und AVV und lade dein Guthaben auf, bevor du echt versendest. Das sind Produktionsvoraussetzungen, keine Sandbox-Einrichtung.
- Schritt 3
Zuerst mit dryRun prüfen
Rufe mcp_health auf und prüfe order_send danach mit dryRun:true. Entferne dryRun erst, wenn du kostenpflichtig einen echten Brief verschicken willst.
Quickstart pro Client
Claude Desktop
Über OAuth 2.1 mit PKCE und Dynamic Client Registration verbinden oder mit einem klar begrenzten Produktions-Token, dann den ersten Versand per dryRun prüfen.
Claude Code
Über OAuth 2.1 mit PKCE und Dynamic Client Registration verbinden oder mit einem klar begrenzten Produktions-Token, dann den ersten Versand per dryRun prüfen.
ChatGPT
Über OAuth 2.1 mit PKCE und Dynamic Client Registration verbinden oder mit einem klar begrenzten Produktions-Token, dann den ersten Versand per dryRun prüfen.
Cursor
Über OAuth 2.1 mit PKCE und Dynamic Client Registration verbinden oder mit einem klar begrenzten Produktions-Token, dann den ersten Versand per dryRun prüfen.
Mehr Referenz
Sicheres Agent-Onboarding
Der kanonische Sandbox-first-Ablauf mit OAuth, API-Key, Adressprüfung, Vorschau, Preislimit, Freigabe, Idempotenz und Storno.
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.