TemplateFox

公式

TemplateFoxでPDF文書を生成する

TemplateFox MCPで何ができますか?

  • テンプレートからPDFを生成 — 請求書や証明書など、動的データを使ってテンプレートからPDFを作成するようアシスタントに依頼できます。
  • PDFジョブを非同期でキューに登録 — 大規模なジョブや一括ジョブのバックグラウンド生成を依頼できます。完了時のWebhookコールバックも任意で設定できます。
  • テンプレートとフィールドを確認 — 利用可能なテンプレートを一覧表示し、生成前に特定のテンプレートで必要なフィールドを確認できます。
  • PDFジョブを追跡 — 非同期ジョブのステータスを確認したり、最近のPDFジョブとそのステータスを一覧表示したりできます。
  • クレジットと取引履歴を確認 — 残りのクレジット、アカウント情報、クレジットの取引履歴について確認できます。

ドキュメント

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

前提条件

  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 アシスタントに次のように尋ねます:

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

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 クレジットを消費します。

依頼の例:

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

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

generate_pdf_async

オプションの Webhook コールバックを指定して、非同期 PDF 生成をキューに追加します。大規模なジョブや一括処理に便利です。PDF 1 件につき 1 クレジットを消費します。

依頼の例:

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

list_templates

アカウントで利用可能なすべての PDF テンプレートを確認します。

依頼の例:

「どんなテンプレートがある?」

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

get_template_fields

特定のテンプレートのフィールドと変数を取得します。生成前にテンプレートが必要とするデータを確認するのに便利です。

依頼の例:

「Invoice テンプレートにはどんなフィールドが必要?」

get_pdf_job_status

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

依頼の例:

「PDF ジョブはもう完了した?」

list_pdf_jobs

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

依頼の例:

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

get_account_info

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

依頼の例:

「残りのクレジットはいくつ?」

list_transactions

クレジットの取引履歴を確認します。

依頼の例:

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

ユースケース

1 件のドキュメントを生成する

特定のデータを使って PDF を 1 件生成するよう、AI アシスタントに依頼します。アシスタントはテンプレートを見つけ、必須フィールドを確認し、一連の流れで 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 サーバーが動作しているか確認します

次のステップ