TemplateFox MCP Server

MCP-Server (Model Context Protocol) für die TemplateFox PDF-Generierungs-API. Generieren Sie PDFs direkt aus Templates über KI-Assistenten wie Claude, Cursor und Windsurf.

Installation

Claude Desktop

Fügen Sie in der Konfigurationsdatei von Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json auf macOS) Folgendes hinzu:

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

Claude Code

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

Setzen Sie anschließend die Umgebungsvariable TEMPLATEFOX_API_KEY in Ihrer Shell.

Cursor / Windsurf

Verwenden Sie denselben Befehl npx -y @templatefox/mcp-server in Ihrer MCP-Server-Konfiguration, mit TEMPLATEFOX_API_KEY in der Umgebung.

Globale Installation (Alternative)

npm install -g @templatefox/mcp-server

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

Related MCP server: @docujson/mcp

Konfiguration

Verfügbare Tools

Remote-Server (HTTP)

Der MCP-Server unterstützt außerdem den HTTP-Transport per Streamable HTTP und ist für Remote- und Cloud-Bereitstellungen geeignet.

Verbindung über URL

https://mcp-server-599407781746.us-central1.run.app/mcp

MCP-Clients müssen den API-Schlüssel über einen HTTP-Header übergeben:

Authorization: Bearer sk_your_api_key_here

oder:

x-api-key: sk_your_api_key_here

Self-Hosting

Starten Sie den Server im HTTP-Modus, indem Sie die Umgebungsvariable PORT setzen:

PORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js

Oder mit Docker:

docker build -t templatefox-mcp .
docker run -p 8080:8080 templatefox-mcp

Der MCP-Endpunkt ist unter http://localhost:8080/mcp und ein Healthcheck unter http://localhost:8080/health verfügbar.

Beispielverwendung

Sobald die Konfiguration abgeschlossen ist, können Sie Ihren KI-Assistenten bitten:

„Listen Sie meine PDF-Templates auf und erzeugen Sie eine Rechnung mit dem Rechnungs-Template mit dem Kundennamen ‚John Doe‘ und dem Betrag 150.00.“

Der Assistent führt dann die folgenden Schritte aus:

1. list_templates aufrufen, um verfügbare Templates zu finden

2. get_template_fields aufrufen, um die erforderlichen Felder zu ermitteln

3. generate_pdf mit der Template-ID und den Daten aufrufen

4. Die PDF-Download-URL zurückgeben

Links

• TemplateFox-Dokumentation

• API-Referenz

• API-Schlüssel abrufen

• GitHub

License

MIT