TemplateFox

公式

TemplateFoxでPDF文書を生成する

TemplateFox MCPで何ができますか？

テンプレートからPDFを生成 — 請求書や証明書などの動的データを含むPDFの作成を依頼します。1ドキュメントにつき1クレジット消費されます。
バックグラウンドPDFジョブをキューに入れる — バッチ処理や大規模なPDF生成を非同期で依頼します。必要に応じてウェブフックのコールバックも指定できます。
テンプレートとそのフィールドを確認する — list_templates を使用して、利用可能なPDFを確認し、特定のテンプレートが期待するデータを把握します。
PDFジョブのステータスを追跡する — 非同期生成の進捗状況を確認したり、最近の全ジョブをレビューしたりできます。
アカウントのクレジットを監視する — 残りのクレジットについて問い合わせたり、使用履歴を確認したりできます。

ドキュメント

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

前提条件

Node.js 18+ がマシンにインストールされていること（npx 用）
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アシスタントに次のように尋ねます：

「TemplateFoxのテンプレートを一覧表示して」

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

設定

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

利用可能なツール

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

generate_pdf

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

依頼できる内容：

「請求書テンプレートを使って、John Doe宛ての合計250ドルの請求書を生成して」

「Jane Smithの修了証書を作成して、コース: Advanced React」

generate_pdf_async

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

依頼できる内容：

「10件の修了証書をバックグラウンドで生成して、完了したら通知して」

list_templates

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

依頼できる内容：

「どんなテンプレートを持っていますか？」

「すべてのPDFテンプレートを表示して」

get_template_fields

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

依頼できる内容：

「請求書テンプレートにはどのフィールドが必要ですか？」

get_pdf_job_status

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

依頼できる内容：

「PDFジョブはもう完了しましたか？」

list_pdf_jobs

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

依頼できる内容：

「最近のPDFジョブを表示して」

get_account_info

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

依頼できる内容：

「残りのクレジットはいくつですか？」

list_transactions

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

依頼できる内容：

「今月のクレジット使用量を表示して」

ユースケース

単一ドキュメントの生成

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

「注文番号#1234の納品書を生成して、顧客はJohn Doe、Widget Blueを3個とGadget Proを1個」

生成前にテンプレートを探索

まずテンプレートについて尋ね、利用可能なものを確認してから生成します：

「テンプレートを一覧表示して、次にReceiptテンプレートのフィールドを表示して」

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

AIアシスタントから離れずに使用状況を監視します：

「残りのクレジットはいくつですか？最近の取引も表示して」

リモートサーバー（近日公開）

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

トラブルシューティング

「MCPサーバーが見つかりません」または接続エラー

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

「APIキーが無効」または認証エラー

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

ツールが表示されない

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

次のステップ

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