Integration
Formfeed für KI-Agenten (MCP)
Agenten sind gut darin, Daten zusammenzustellen, und schlecht darin, zu raten, was eine Vorlage erwartet. Der MCP-Server schließt die Lücke: Der Agent liest das Vorlagenschema, prüft seine Daten kostenlos und gibt erst dann ein Rendering aus.
Ab sofort verfügbar: der gehostete Endpunkt mcp.formfeed.dev, mit API-Schlüssel oder Anmeldung, und das npm-Paket für einen lokalen Server.
Kostenloser Plan mit 100 Einheiten im Monat, keine Kreditkarte
Werkzeuge
- list_templates. Vorlagen des Workspace mit Slug, Art, Engine und veröffentlichter Version.
- get_template_schema. Das JSON-Schema der Daten, die eine Vorlage erwartet, mit ihren Beispieldaten.
- validate_template. Prüft eine Vorlage mit den Daten, ohne zu rendern: Syntax, fehlende Variablen und die Daten gegen das gespeicherte Schema der Vorlage. Kostenlos.
- check_invoice. Prüft den Rechnungsblock einer E-Rechnung offline gegen EN 16931 und nennt jedes Feld und jede Regel, die er verletzt, bevor ein Rendering etwas kostet. Kostenlos.
- render. Rendert zu PDF, PNG, JPG oder WebP, Word- und PowerPoint-Vorlagen auch zu DOCX oder PPTX, und liefert die Download-URL. Mit
einvoicewird das PDF eine ZUGFeRD- / Factur-X-E-Rechnung. - convert_to_pdf. Wandelt eine Word-, Excel-, PowerPoint-, OpenDocument-, RTF- oder HTML-Datei oder das Rendering einer Word- oder PowerPoint-Vorlage in ein PDF um. Ab dem Starter-Plan.
- get_render. Status, Seitenzahl, Einheiten und Fehler eines Renderings, mit einem frischen Download-Link, der auch einen abgelaufenen ersetzt.
- get_workspace. Der Workspace, in dem der Server arbeitet, der Tarif und die im Zeitraum verbleibenden Einheiten.
Einen Client verbinden
Für einen lokalen Server funktioniert derselbe Eintrag in Claude Desktop, Cursor, Windsurf, Cline und jedem Client, der mcpServers liest; npx startet ihn mit Node.js 22 oder neuer. Ein Client, der sich aus der Ferne verbindet, trägt stattdessen https://mcp.formfeed.dev/mcp ein: Ein Chat-Client öffnet die Anmeldung bei Formfeed, in der Sie den Workspace wählen, und ein Server sendet seinen API-Schlüssel als Authorization: Bearer. Beide Wege stehen in der Dokumentation. Schritt-für-Schritt-Anleitungen für Claude Code, Cursor, VS Code, Codex, Gemini CLI und die Agenten-Frameworks stehen auf der Seite für KI-Agenten.
{
"mcpServers": {
"formfeed": {
"command": "npx",
"args": ["-y", "@formfeed/mcp"],
"env": { "FORMFEED_API_KEY": "ff_test_..." }
}
}
}Sichere Voreinstellungen
Jede Verbindung arbeitet in einem Workspace: dem ihres API-Schlüssels oder dem, den Sie bei der Anmeldung wählen. Ein angemeldeter Agent erhält höchstens vier Scopes und nie mehr, als Ihre Rolle erlaubt: Er liest Vorlagen und Renderings, rendert und wandelt um und liest Tarif und Einheiten des Workspace, kann aber keine Vorlagen veröffentlichen oder ändern, keine Dateien hochladen und keine Schlüssel verwalten, und er rendert immer live. Nutzen Sie beim Bauen einen Test-Schlüssel: Seine Renderings werden nicht berechnet, laufen nach einem Tag ab und tragen im Free-Plan ein kleines Wasserzeichen.
Aus dem Blog
- Den Agenten die Daten schreiben lassen, nicht das HTML →
Ein KI-Agent, der das HTML eines Dokuments schreibt, schreibt jedes Mal ein neues Dokument. Einer, der eine geprüfte Vorlage füllt, schreibt dasselbe. Was die Vorlage dem Modell noch falsch zu machen lässt, und wie man es kostenlos prüft, bevor etwas gedruckt wird.