TemplateFox

offiziell

PDF-Dokumente mit TemplateFox generieren

Auf templatefox.com ansehenDieses MCP ausprobierenGesponsert

Was kann man mit TemplateFox MCP machen?

  • PDFs aus Vorlagen generieren — Fordern Sie die Erstellung einer PDF wie einer Rechnung oder eines Zertifikats mit dynamischen Daten an, Kosten: 1 Credit pro Dokument.
  • Hintergrund-PDF-Jobs in die Warteschlange stellen — Fordern Sie die asynchrone Generierung von Batch- oder großen PDFs an, optional mit einem Webhook-Callback.
  • Vorlagen und ihre Felder entdecken — Verwenden Sie list_templates, um verfügbare PDFs zu sehen und zu erfahren, welche Daten eine bestimmte Vorlage erwartet.
  • PDF-Jobstatus verfolgen — Überprüfen Sie den Fortschritt der asynchronen Generierung mit oder sehen Sie sich alle aktuellen Jobs an.
  • Account-Credits überwachen — Fragen Sie nach verbleibenden Credits mit oder sehen Sie sich den Nutzungsverlauf an.

Dokumentation

MCP (Model Context Protocol) ist ein offener Standard, der es KI-Assistenten ermöglicht, externe Tools zu entdecken und zu nutzen. Der TemplateFox MCP-Server gibt Ihrem KI-Assistenten 8 Tools, um PDFs zu generieren, Vorlagen zu verwalten und Guthaben zu prüfen – alles über natürliche Sprache.

Voraussetzungen

  1. Node.js 18+ auf Ihrem Rechner installiert (für npx)
  2. Ein TemplateFox-API-Schlüssel – erhalten Sie einen über Ihr Dashboard (beginnt mit sk_)

Installation

Claude Desktop

Fügen Sie Folgendes zu Ihrer Claude-Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json auf macOS, %APPDATA%\Claude\claude_desktop_config.json auf Windows):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern der Datei neu.

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

Setzen Sie dann die Umgebungsvariable TEMPLATEFOX_API_KEY in Ihrer Shell:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

Verwenden Sie denselben npx-Befehl in Ihrer MCP-Server-Konfiguration:

npx -y @templatefox/mcp-server

Setzen Sie TEMPLATEFOX_API_KEY in den Umgebungsvariablen.

Globale Installation (Alternative)

npm install -g @templatefox/mcp-server

Verwenden Sie dann templatefox-mcp-server als Befehl anstelle von npx.

Einrichtung überprüfen

Fragen Sie nach der Installation Ihren KI-Assistenten:

„Liste meine TemplateFox-Vorlagen auf“

Wenn der MCP-Server korrekt konfiguriert ist, ruft der Assistent list_templates auf und gibt Ihre Vorlagenliste zurück. Wenn ein Fehler angezeigt wird, prüfen Sie den Abschnitt Fehlerbehebung unten.

Konfiguration

UmgebungsvariableErforderlichBeschreibung
TEMPLATEFOX_API_KEYJaIhr API-Schlüssel (beginnt mit sk_). Erhalten Sie einen über Ihr 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 Ihr KI-Assistent aufrufen kann:

generate_pdf

Generieren Sie ein PDF aus einer Vorlage mit dynamischen Daten. Kostet 1 Guthaben pro PDF.

Was Sie fragen können:

„Generiere eine Rechnung für John Doe, Gesamtsumme 250 $, mit meiner Rechnungsvorlage“

„Erstelle ein Abschlusszertifikat für Jane Smith, Kurs: Advanced React“

generate_pdf_async

Stellen Sie asynchrone PDF-Generierung mit optionalem Webhook-Callback in die Warteschlange. Nützlich für große oder Stapelaufträge. Kostet 1 Guthaben pro PDF.

Was Sie fragen können:

„Generiere 10 Zertifikate im Hintergrund und benachrichtige mich, wenn fertig“

list_templates

Entdecken Sie alle verfügbaren PDF-Vorlagen in Ihrem Konto.

Was Sie fragen können:

„Welche Vorlagen habe ich?“

„Zeig mir alle meine PDF-Vorlagen“

get_template_fields

Rufen Sie die Felder und Variablen für eine bestimmte Vorlage ab. Nützlich, um zu verstehen, welche Daten eine Vorlage vor der Generierung erwartet.

Was Sie fragen können:

„Welche Felder benötigt meine Rechnungsvorlage?“

get_pdf_job_status

Prüfen Sie den Status eines asynchronen PDF-Generierungsauftrags.

Was Sie fragen können:

„Ist mein PDF-Auftrag schon fertig?“

list_pdf_jobs

Listen Sie alle asynchronen PDF-Generierungsaufträge und deren Status auf.

Was Sie fragen können:

„Zeig mir meine letzten PDF-Aufträge“

get_account_info

Prüfen Sie verbleibendes Guthaben und Kontoinformationen.

Was Sie fragen können:

„Wie viele Guthaben habe ich noch?“

list_transactions

Zeigen Sie den Verlauf der Guthaben-Transaktionen an.

Was Sie fragen können:

„Zeig mir meine Guthaben-Nutzung diesen Monat“

Anwendungsfälle

Ein einzelnes Dokument generieren

Bitten Sie Ihren KI-Assistenten, ein PDF mit bestimmten Daten zu generieren. Der Assistent entdeckt die Vorlage, prüft die erforderlichen Felder und generiert das PDF in einem Ablauf:

„Generiere einen Lieferschein für Bestellung #1234, Kunde John Doe, 3x Widget Blue und 1x Gadget Pro“

Vorlagen vor der Generierung erkunden

Fragen Sie zuerst nach Ihren Vorlagen und generieren Sie dann, sobald Sie wissen, was verfügbar ist:

„Liste meine Vorlagen auf und zeig mir dann die Felder für die Quittungsvorlage“

Kontostatus prüfen

Überwachen Sie Ihre Nutzung, ohne Ihren KI-Assistenten zu verlassen:

„Wie viele Guthaben habe ich noch? Zeig mir meine letzten Transaktionen“

Remote-Server (bald)

Ein gehosteter HTTP-MCP-Endpunkt unter https://api.templatefox.com/mcp ist bald verfügbar. Damit können Sie sich verbinden, ohne etwas lokal zu installieren – weisen Sie einfach Ihren MCP-Client auf die URL.

Fehlerbehebung

„MCP-Server nicht gefunden“ oder Verbindungsfehler

  • Stellen Sie sicher, dass Node.js 18+ installiert ist: führen Sie node --version aus
  • Prüfen Sie, ob der Befehl npx funktioniert: führen Sie npx -y @templatefox/mcp-server --help aus
  • Starten Sie Ihren KI-Assistenten nach der Aktualisierung der Konfiguration neu

„Ungültiger API-Schlüssel“ oder Authentifizierungsfehler

  • Überprüfen Sie, ob Ihr API-Schlüssel mit sk_ beginnt und nicht abgelaufen ist
  • Prüfen Sie den Schlüssel in Ihrem Dashboard
  • Stellen Sie sicher, dass TEMPLATEFOX_API_KEY in der richtigen Umgebung gesetzt ist (nicht nur in Ihrer Shell, sondern in der MCP-Server-Konfiguration)

Tools werden nicht angezeigt

  • Einige Clients speichern MCP-Tool-Listen zwischen – starten Sie den Client neu
  • Prüfen Sie, ob andere MCP-Server funktionieren, um ein clientseitiges Problem auszuschließen

Nächste Schritte