TemplateFox
offiziellPDF-Dokumente mit TemplateFox generieren
Was kann man mit TemplateFox MCP machen?
- PDFs aus Vorlagen erstellen — Bitte deinen Assistenten, ein PDF aus einer Vorlage mit dynamischen Daten zu erstellen, zum Beispiel eine Rechnung oder ein Zertifikat.
- Asynchrone PDF-Aufträge in die Warteschlange stellen — Fordere die Generierung im Hintergrund für umfangreiche oder gebündelte Aufträge an, optional mit einem Webhook-Callback nach Abschluss.
- Vorlagen und Felder prüfen — Liste verfügbare Vorlagen auf und finde heraus, welche Felder eine bestimmte Vorlage vor der Generierung erwartet.
- PDF-Aufträge verfolgen — Prüfe den Status eines asynchronen Auftrags oder liste die letzten PDF-Aufträge und ihre Status auf.
- Guthaben und Transaktionen prüfen — Frage nach dem verbleibenden Guthaben, Kontoinformationen oder dem Verlauf der Guthabentransaktionen.
Dokumentation
MCP (Model Context Protocol) ist ein offener Standard, mit dem KI-Assistenten externe Tools entdecken und verwenden können. Der TemplateFox-MCP-Server stellt deinem KI-Assistenten 8 Tools zum Erstellen von PDFs, Verwalten von Vorlagen und Prüfen von Guthaben zur Verfügung – alles in natürlicher Sprache.
Voraussetzungen
- Node.js 18+ muss auf deinem Rechner installiert sein (für
npx) - Ein TemplateFox-API-Schlüssel – du erhältst ihn in deinem Dashboard (beginnt mit
sk_)
Installation
Claude Desktop
Füge Folgendes zu deiner Claude-Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS, %APPDATA%\Claude\claude_desktop_config.json unter Windows):
{
"mcpServers": {
"templatefox": {
"command": "npx",
"args": ["-y", "@templatefox/mcp-server"],
"env": {
"TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
}
}
}
}
Starte Claude Desktop neu, nachdem du die Datei gespeichert hast.
Claude Code
claude mcp add templatefox -- npx -y @templatefox/mcp-server
Lege anschließend die Umgebungsvariable TEMPLATEFOX_API_KEY in deiner Shell fest:
export TEMPLATEFOX_API_KEY="sk_your_api_key_here"
Cursor / Windsurf
Verwende denselben npx-Befehl in deiner MCP-Serverkonfiguration:
npx -y @templatefox/mcp-server
Lege TEMPLATEFOX_API_KEY in den Umgebungsvariablen fest.
Globale Installation (Alternative)
npm install -g @templatefox/mcp-server
Verwende anschließend templatefox-mcp-server statt npx als Befehl.
Einrichtung überprüfen
Frage deinen KI-Assistenten nach der Installation:
„Liste meine TemplateFox-Vorlagen auf“
Wenn der MCP-Server korrekt konfiguriert ist, ruft der Assistent list_templates auf und gibt deine Vorlagenliste zurück. Wenn ein Fehler auftritt, sieh im Abschnitt Fehlerbehebung weiter unten nach.
Konfiguration
| Umgebungsvariable | Erforderlich | Beschreibung |
|---|---|---|
TEMPLATEFOX_API_KEY | Ja | Dein API-Schlüssel (beginnt mit sk_). Du erhältst ihn in deinem Dashboard |
TEMPLATEFOX_BASE_URL | Nein | Überschreibt die API-Basis-URL (Standard: https://api.templatefox.com) |
Verfügbare Tools
Der MCP-Server stellt 8 Tools bereit, die dein KI-Assistent aufrufen kann:
generate_pdf
Erstellt ein PDF aus einer Vorlage mit dynamischen Daten. Kostet 1 Guthabenpunkt pro PDF.
Beispiele für Anfragen:
„Erstelle eine Rechnung für John Doe über insgesamt 250 $, mit meiner Rechnungsvorlage“
„Erstelle ein Abschlusszertifikat für Jane Smith, Kurs: Advanced React“
generate_pdf_async
Stellt die asynchrone PDF-Erstellung mit optionalem Webhook-Callback in eine Warteschlange. Nützlich für umfangreiche oder gebündelte Aufträge. Kostet 1 Guthabenpunkt pro PDF.
Beispiele für Anfragen:
„Erstelle 10 Zertifikate im Hintergrund und benachrichtige mich, wenn sie fertig sind“
list_templates
Zeigt alle verfügbaren PDF-Vorlagen in deinem Konto an.
Beispiele für Anfragen:
„Welche Vorlagen habe ich?“
„Zeig mir alle meine PDF-Vorlagen“
get_template_fields
Ruft die Felder und Variablen einer bestimmten Vorlage ab. So kannst du herausfinden, welche Daten eine Vorlage erwartet, bevor du ein PDF erstellst.
Beispiele für Anfragen:
„Welche Felder benötigt meine Rechnungsvorlage?“
get_pdf_job_status
Prüft den Status eines asynchronen PDF-Erstellungsauftrags.
Beispiele für Anfragen:
„Ist mein PDF-Auftrag schon fertig?“
list_pdf_jobs
Listet alle asynchronen PDF-Erstellungsaufträge und deren Status auf.
Beispiele für Anfragen:
„Zeig mir meine letzten PDF-Aufträge“
get_account_info
Prüft dein verbleibendes Guthaben und deine Kontoinformationen.
Beispiele für Anfragen:
„Wie viele Guthabenpunkte habe ich noch?“
list_transactions
Zeigt den Verlauf der Guthabentransaktionen an.
Beispiele für Anfragen:
„Zeig mir meine Guthabennutzung in diesem Monat“
Anwendungsfälle
Ein einzelnes Dokument erstellen
Bitte deinen KI-Assistenten, ein PDF mit bestimmten Daten zu erstellen. Der Assistent findet die Vorlage, prüft die erforderlichen Felder und erstellt das PDF in einem einzigen Ablauf:
„Erstelle einen Lieferschein für Bestellung Nr. 1234, Kunde John Doe, 3x Widget Blue und 1x Gadget Pro“
Vorlagen vor der Erstellung erkunden
Frage zuerst nach deinen Vorlagen und erstelle das Dokument, sobald du weißt, welche verfügbar sind:
„Liste meine Vorlagen auf und zeig mir dann die Felder der Vorlage Receipt“
Kontostatus prüfen
Behalte deine Nutzung im Blick, ohne deinen KI-Assistenten zu verlassen:
„Wie viele Guthabenpunkte habe ich noch? Zeig mir meine letzten Transaktionen“
Remote-Server (demnächst verfügbar)
Ein gehosteter HTTP-MCP-Endpunkt unter https://api.templatefox.com/mcp kommt demnächst. Damit kannst du eine Verbindung herstellen, ohne etwas lokal zu installieren – richte deinen MCP-Client einfach auf die URL.
Fehlerbehebung
„MCP-Server nicht gefunden“ oder Verbindungsfehler
- Stelle sicher, dass Node.js 18+ installiert ist: Führe
node --versionaus - Prüfe, ob der Befehl
npxfunktioniert: Führenpx -y @templatefox/mcp-server --helpaus - Starte deinen KI-Assistenten neu, nachdem du die Konfiguration aktualisiert hast
„Ungültiger API-Schlüssel“ oder Authentifizierungsfehler
- Vergewissere dich, dass dein API-Schlüssel mit
sk_beginnt und nicht abgelaufen ist - Prüfe den Schlüssel in deinem Dashboard
- Stelle sicher, dass
TEMPLATEFOX_API_KEYin der richtigen Umgebung festgelegt ist (nicht nur in deiner Shell, sondern auch in der MCP-Serverkonfiguration)
Tools werden nicht angezeigt
- Einige Clients speichern MCP-Toollisten zwischen – starte den Client neu
- Prüfe, ob andere MCP-Server funktionieren, um ein clientseitiges Problem auszuschließen
Nächste Schritte
- In 5 Minuten loslegen — Erstelle deine erste Vorlage
- Datenbindung — Erfahre, wie du dynamische Daten übergibst
- API-Referenz — Vollständige Dokumentation der Endpunkte