Anleitung · Assistent

Formfeed in Claude Code

Claude Code ist der Agent, der am besten mit Vorlagen als Code arbeitet: Er liest das Datenschema über MCP, bearbeitet template.html in Ihrem Repository und prüft seine Arbeit mit formfeed validate, bevor etwas gerendert wird.

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.
2
Den Formfeed-Server hinzufügen
Fügen Sie den Server mit claude mcp add hinzu. Sein Name steht vor --env, denn die Option nimmt mehrere Werte und hielte den Namen sonst für einen davon. Alles nach -- ist der Befehl, den Claude Code startet. Für das ganze Team committen Sie eine .mcp.json; jede Entwicklerin hält den Schlüssel in ihrer eigenen Umgebung.
CLI
Shell
```
claude mcp add --transport stdio formfeed \
  --env FORMFEED_API_KEY=ff_test_... \
  -- npx -y @formfeed/mcp
```
Mit --scope user steht der Server in jedem Projekt bereit.
.mcp.json
.mcp.jsonJSON
```
{
  "mcpServers": {
    "formfeed": {
      "command": "npx",
      "args": ["-y", "@formfeed/mcp"],
      "env": { "FORMFEED_API_KEY": "${FORMFEED_API_KEY}" }
    }
  }
}
```
Claude Code setzt ${FORMFEED_API_KEY} aus der Umgebung ein, die Datei enthält also kein Geheimnis.
Remote (HTTP)
Shell
```
claude mcp add --transport http formfeed https://mcp.formfeed.dev/mcp \
  --header "Authorization: Bearer ff_test_..."
```
Anmeldung statt Schlüssel: Verbinden Sie https://mcp.formfeed.dev/mcp ohne 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 in Claude Code /mcp aus. formfeed erscheint als verbunden mit acht Werkzeugen. Dann bitten Sie um ein Dokument.

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

Claude Code kann auch die CLI nutzen: formfeed validate --json und formfeed test geben ihm maschinenlesbare Rückmeldung, während er Vorlagen bearbeitet. Siehe den AGENTS.md-Ausschnitt auf der Agenten-Seite.
Erlauben Sie die sechs kostenlosen Lese-Werkzeuge vorab in /permissions (mcp__formfeed__list_templates, mcp__formfeed__get_template_schema, mcp__formfeed__validate_template, mcp__formfeed__check_invoice, mcp__formfeed__get_render, mcp__formfeed__get_workspace) und lassen Sie render und convert_to_pdf, die Einheiten verbrauchen, bestätigen.
Oder installieren Sie Formfeed als Plugin: claude plugin marketplace add formfeed-dev/skills, dann claude plugin install formfeed@formfeed-dev. Es fügt den gehosteten Server ohne Schlüssel hinzu; /mcp öffnet die Formfeed-Anmeldung, und der Agent rendert live.

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 einvoice wird 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: false eingereiht 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

Formfeed in Claude Code

Test-Schlüssel anlegen

Den Formfeed-Server hinzufügen

Verbindung prüfen

Ausprobieren

Tipps

Die acht Werkzeuge

Weitere Anleitungen

Assistenten und Editoren

Agenten-Frameworks

Automatisierung

Heute mit dem Rendern beginnen