TemplateFox

公式

TemplateFoxでPDF文書を生成する

templatefox.com で表示このMCPを試すスポンサー

TemplateFox MCPで何ができますか？

  • Generate a PDF from a template — アシスタントに動的データ（請求書詳細や証明書名など）を指定して generate_pdf を呼び出すよう依頼します。
  • Queue async PDF generation — バッチ処理やバックグラウンドジョブには generate_pdf_async を使用し、オプションでウェブフックコールバックを設定できます。
  • List your available templates — list_templates でアカウント内のすべてのテンプレートを確認できます。
  • Inspect template fields — 生成前に get_template_fields でテンプレートが期待するデータを確認します。
  • Check async job status — get_pdf_job_status を使用して、キューに入れたPDFジョブの進捗を追跡します。
  • View account credits and transactions — get_account_info で残りのクレジットを確認し、list_transactions で使用履歴を確認できます。

ドキュメント

MCP サーバー

MCP (Model Context Protocol) は、AI アシスタントが外部ツールを発見して利用できるようにするオープンスタンダードです。TemplateFox MCP サーバーは、AI アシスタントに PDF の生成、テンプレートの管理、クレジットの確認を行うための 8 つのツールを提供します。すべて自然言語で操作できます。

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

前提条件

  1. Node.js 18 以上 がマシンにインストールされていること (npx 用)
  2. TemplateFox API キー — ダッシュボードから取得してください (sk_ で始まります)

インストール

Claude Desktop

Claude Desktop の設定ファイル (macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json) に以下を追加します:


{

  "mcpServers": {

    "templatefox": {

      "command": "npx",

      "args": ["-y", "@templatefox/mcp-server"],

      "env": {

        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"

      }

    }

  }

}

ファイルを保存した後、Claude Desktop を再起動してください。

Claude Code


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

次に、シェルで TEMPLATEFOX_API_KEY 環境変数を設定します:


export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

MCP サーバー設定で同じ npx コマンドを使用します:


npx -y @templatefox/mcp-server

環境変数に TEMPLATEFOX_API_KEY を設定してください。

グローバルインストール (代替手段)


npm install -g @templatefox/mcp-server

その後、npx の代わりに templatefox-mcp-server をコマンドとして使用します。

セットアップの確認

インストール後、AI アシスタントに次のように尋ねてください:

“List my TemplateFox templates”

MCP サーバーが正しく設定されていれば、アシスタントは list_templates を呼び出し、テンプレート一覧を返します。エラーが表示された場合は、以下のトラブルシューティングセクションを確認してください。

設定

環境変数必須説明
TEMPLATEFOX_API_KEYはいAPI キー (sk_ で始まります)。ダッシュボードから取得してください
TEMPLATEFOX_BASE_URLいいえAPI ベース URL を上書きします (デフォルト: https://api.templatefox.com)

利用可能なツール

MCP サーバーは、AI アシスタントが呼び出せる 8 つのツールを公開します:

generate_pdf

動的データを使用してテンプレートから PDF を生成します。PDF 1 件につき 1 クレジットを消費します。

質問の例:

“Generate an invoice for John Doe, total $250, using my Invoice template”

“Create a certificate of completion for Jane Smith, course: Advanced React”

generate_pdf_async

オプションの webhook コールバック付きで非同期 PDF 生成をキューに入れます。大規模なジョブやバッチジョブに便利です。PDF 1 件につき 1 クレジットを消費します。

“Generate 10 certificates in the background and notify me when done”

list_templates

アカウント内の利用可能なすべての PDF テンプレートを検出します。

“What templates do I have?”

“Show me all my PDF templates”

get_template_fields

特定のテンプレートのフィールドと変数を取得します。生成前にテンプレートが期待するデータを理解するのに役立ちます。

“What fields does my Invoice template need?“

get_pdf_job_status

非同期 PDF 生成ジョブのステータスを確認します。

“Is my PDF job finished yet?“

list_pdf_jobs

すべての非同期 PDF 生成ジョブとそのステータスを一覧表示します。

“Show me my recent PDF jobs”

get_account_info

残りのクレジットとアカウント情報を確認します。

“How many credits do I have left?“

list_transactions

クレジット取引履歴を表示します。

“Show me my credit usage this month”

ユースケース

単一ドキュメントの生成

AI アシスタントに特定のデータで PDF を 1 つ生成するよう依頼します。アシスタントはテンプレートを検出し、必要なフィールドを確認し、1 つのフローで PDF を生成します:

“Generate a packing slip for order #1234, customer John Doe, 3x Widget Blue and 1x Gadget Pro”

生成前のテンプレート探索

最初にテンプレートについて尋ね、利用可能なものを把握してから生成します:

“List my templates, then show me the fields for the Receipt template”

アカウントステータスの確認

AI アシスタントから離れることなく、使用状況を監視します:

“How many credits do I have left? Show me my recent transactions”

リモートサーバー (近日公開)

https://api.templatefox.com/mcp でホストされる HTTP MCP エンドポイントが近日公開予定です。これにより、ローカルに何もインストールすることなく接続できるようになります。MCP クライアントを URL に向けるだけです。

トラブルシューティング

”MCP server not found” または接続エラー

  • Node.js 18 以上がインストールされていることを確認してください: node --version を実行
  • npx コマンドが動作することを確認してください: npx -y @templatefox/mcp-server --help を実行
  • 設定を更新した後、AI アシスタントを再起動してください

”Invalid API key” または認証エラー

  • API キーが sk_ で始まり、有効期限が切れていないことを確認してください
  • ダッシュボードでキーを確認してください
  • TEMPLATEFOX_API_KEY が正しい環境 (シェルだけでなく、MCP サーバー設定) で設定されていることを確認してください

ツールが表示されない

  • 一部のクライアントは MCP ツールリストをキャッシュします — クライアントを再起動してください
  • 他の MCP サーバーが動作しているか確認し、クライアントレベルの問題を除外してください

次のステップ

  • 5 分で始める — 最初のテンプレートを作成する
  • データバインディング — 動的データの渡し方を学ぶ
  • API リファレンス — 完全なエンドポイントドキュメント