TemplateFox

offiziell

PDF-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

  1. Node.js 18+ muss auf deinem Rechner installiert sein (für npx)
  2. 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

UmgebungsvariableErforderlichBeschreibung
TEMPLATEFOX_API_KEYJaDein API-Schlüssel (beginnt mit sk_). Du erhältst ihn in deinem Dashboard
TEMPLATEFOX_BASE_URLNeinÜ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 --version aus
  • Prüfe, ob der Befehl npx funktioniert: Führe npx -y @templatefox/mcp-server --help aus
  • 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_KEY in 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