Anleitung · Assistent
Formfeed in OpenAI Codex CLI
Codex hält MCP-Server in ~/.codex/config.toml, gemeinsam für die Codex-CLI, die IDE-Erweiterung und die ChatGPT-Desktop-App. Der Befehl codex mcp add schreibt den Eintrag für Sie.
Test-Schlüssel anlegen
Melden Sie sich in der App an, öffnen Sie API-Schlüssel und legen Sie einen Schlüssel in der Testumgebung an. Testrenderings werden nicht berechnet, genau richtig, solange ein Agent Ihre Vorlagen noch kennenlernt. Für den Produktivbetrieb wechseln Sie auf einen Live-Schlüssel.
Den Formfeed-Server hinzufügen
Nutzen Sie den Befehl oder bearbeiten Sie
~/.codex/config.tomldirekt. Entfernte Server lesen das Bearer-Token aus einer Umgebungsvariable, die Sie benennen.codex mcp add formfeed \ --env FORMFEED_API_KEY=ff_test_... \ -- npx -y @formfeed/mcp[mcp_servers.formfeed] command = "npx" args = ["-y", "@formfeed/mcp"] [mcp_servers.formfeed.env] FORMFEED_API_KEY = "ff_test_..."[mcp_servers.formfeed] url = "https://mcp.formfeed.dev/mcp" bearer_token_env_var = "FORMFEED_API_KEY"Anmeldung statt Schlüssel: Verbinden Sie
https://mcp.formfeed.dev/mcpohne Header, und der Client öffnet die Formfeed-Anmeldung, in der Sie den Workspace des Agenten wählen. Ein angemeldeter Agent rendert immer live und verbraucht Einheiten; kostenlose Testrenderings gibt es nur mit einem Test-Schlüssel. Ein selbst betriebener Endpunkt (npx -y @formfeed/mcp --http) nimmt nur API-Schlüssel.Verbindung prüfen
Führen Sie
/mcpin der Terminal-Oberfläche von Codex aus:formfeedund seine acht Werkzeuge erscheinen.
Ausprobieren
- Rechnung
“Rendere Rechnung 2026-0042 an Olvarest GmbH: 8 Stunden Beratung zu 120 € und 20 Stunden Umsetzung zu 110 €. Nimm die deutsche Rechnungsvorlage.”
- Prüfung
“Prüfe, ob orders/2026-0042.json zur Vorlage invoice-de passt, bevor du irgendetwas renderst.”
- HTML
“Mach aus diesen Besprechungsnotizen ein einseitiges PDF. Ohne Vorlage, einfaches HTML genügt.”
Tipps
- Codex kann auch die
formfeed-CLI in Ihrem Repository bedienen;--jsonbei jedem Befehl macht die Ausgabe gut lesbar für ihn.
Die acht Werkzeuge
- list_templates
- Vorlagen des Workspace mit Slug, Art (PDF, Bild, Word oder PowerPoint), Engine und veröffentlichter Version; filterbar nach Art, Engine, Tag oder Suchtext.
- kostenlos
- get_template_schema
- Das JSON-Schema der Daten, die eine Vorlage erwartet, mit den Beispieldaten, mit denen sie gestaltet wurde. Speichert eine Vorlage kein Schema, wird eines aus den Beispieldaten abgeleitet: ein Anhaltspunkt, kein Vertrag.
- kostenlos
- validate_template
- Prüft eine Vorlage mit den Daten, ohne zu rendern: Syntax, Variablen, die in den Daten fehlen, Fehler, die erst mit diesen Daten auftreten, und die Daten gegen das gespeicherte Schema der Vorlage. Ad-hoc-HTML wird offline geprüft.
- kostenlos
- check_invoice
- Prüft den
_invoice-Block einer E-Rechnung offline, wie die API es vor dem Rendern tut: die Felder, die EN 16931 verlangt, die Summen auf den Cent, Umsatzsteuerkategorien und Codelisten sowie die Regeln Frankreichs. Nennt jedes Feld und jede Regel, die er verletzt. - kostenlos
- render
- Rendert eine Vorlage oder rohes HTML zu PDF, PNG, JPG oder WebP (Word- und PowerPoint-Vorlagen auch zu DOCX oder PPTX) und liefert Download-URL, Seitenzahl und Einheiten. Mit
einvoicewird das PDF eine ZUGFeRD- / Factur-X-E-Rechnung mit dem Bericht des Validators, für eine Einheit mehr (live ab dem Starter-Plan). - 1 Einheit, PDFs je 5 Seiten
- convert_to_pdf
- Wandelt ein Word-, Excel-, PowerPoint-, OpenDocument-, RTF- oder HTML-Dokument bis 20 MB oder das Rendering einer Word- oder PowerPoint-Vorlage in ein PDF um und liefert die Download-URL; das Dokument wird nicht aufbewahrt. Der lokale Server liest eine Datei auch über ihren Pfad. Ab dem Starter-Plan.
- wie ein PDF
- get_render
- Status, Download-URL und Fehler eines Renderings: für Renderings, die der Agent mit
wait: falseeingereiht hat, und für einen frischen Link, wenn der alte abgelaufen ist. - kostenlos
- get_workspace
- Workspace und Organisation, in denen der Server arbeitet, der Tarif, die Umgebung und die Einheiten des Zeitraums: wie viele Renderings noch bleiben.
- kostenlos
Konfigurationsreferenz: OpenAI — OpenAI Codex CLI (geprüft 17. Oktober 2026)