TemplateFox

MCP Server

MCP (Model Context Protocol) ist ein offener Standard, der es KI-Assistenten ermöglicht, externe Werkzeuge zu entdecken und zu nutzen. Der TemplateFox MCP-Server stellt Ihrem KI-Assistenten 8 Werkzeuge zur Verfügung, um PDFs zu generieren, Vorlagen zu verwalten und Guthaben zu prüfen – alles in natürlicher Sprache.

• npm: @templatefox/mcp-server
• GitHub: TemplateFoxPDF/mcp-server

Voraussetzungen

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

Installation

Claude Desktop

Fügen Sie zu Ihrer 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"

      }

    }

  }

}

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 Ihren 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 Ihre Vorlagenliste zurück. Wenn Sie einen Fehler sehen, lesen Sie den Abschnitt Fehlerbehebung unten.

Konfiguration

Umgebungsvariable	Erforderlich	Beschreibung
TEMPLATEFOX_API_KEY	Ja	Ihr API-Schlüssel (beginnt mit sk_). Erhalten Sie einen im Dashboard
TEMPLATEFOX_BASE_URL	Nein	API-Basis-URL überschreiben (Standard: https://api.templatefox.com)

Verfügbare Werkzeuge

Der MCP-Server stellt 8 Werkzeuge bereit, die Ihr KI-Assistent aufrufen kann:

generate_pdf

Generiert eine PDF aus einer Vorlage mit dynamischen Daten. Kostet 1 Guthaben pro PDF.

Was Sie fragen können:

„Erstelle eine Rechnung für John Doe, Gesamtbetrag 250 $, mit meiner Rechnungsvorlage“

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

generate_pdf_async

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

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

list_templates

Entdeckt alle verfügbaren PDF-Vorlagen in Ihrem Konto.

„Welche Vorlagen habe ich?“

„Zeige mir alle meine PDF-Vorlagen“

get_template_fields

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

„Welche Felder benötigt meine Rechnungsvorlage?“

get_pdf_job_status

Überprüft den Status eines asynchronen PDF-Generierungsauftrags.

„Ist mein PDF-Auftrag schon fertig?“

list_pdf_jobs

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

„Zeige mir meine letzten PDF-Aufträge“

get_account_info

Überprüft verbleibendes Guthaben und Kontoinformationen.

„Wie viel Guthaben habe ich noch?“

list_transactions

Zeigt den Verlauf der Guthabentransaktionen an.

„Zeige mir meine Guthabennutzung diesen Monat“

Anwendungsfälle

Ein einzelnes Dokument generieren

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

„Erstelle einen Lieferschein für Bestellung #1234, Kunde John Doe, 3x Widget Blau 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 zeige mir dann die Felder für die Quittungsvorlage“

Kontostatus prüfen

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

„Wie viel Guthaben habe ich noch? Zeige mir meine letzten Transaktionen“

Remote-Server (bald)

Ein gehosteter HTTP-MCP-Endpunkt unter https://api.templatefox.com/mcp kommt bald. Damit können Sie sich verbinden, ohne etwas lokal zu installieren – verweisen 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
• Überprü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
• Überprü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)

Werkzeuge werden nicht angezeigt

• Einige Clients speichern MCP-Werkzeuglisten zwischen – starten Sie den Client neu
• Überprüfen Sie, ob andere MCP-Server funktionieren, um ein Problem auf Client-Ebene auszuschließen

Nächste Schritte

• Erste Schritte in 5 Minuten – Erstellen Sie Ihre erste Vorlage
• Datenbindung – Erfahren Sie, wie Sie dynamische Daten übergeben
• API-Referenz – Vollständige Endpunkt-Dokumentation