TemplateFoxPDF

TemplateFox MCP サーバー

TemplateFox の PDF 生成 API 用 MCP（Model Context Protocol）サーバーです。Claude、Cursor、Windsurf などの AI アシスタントから、テンプレートを使って PDF を直接生成できます。

インストール

Claude Desktop

Claude Desktop の設定ファイルに追加します（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "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

続いて、シェルで環境変数 TEMPLATEFOX_API_KEY を設定します。

Cursor / Windsurf

MCP サーバーの設定で、同じ npx -y @templatefox/mcp-server コマンドを使用し、環境変数に TEMPLATEFOX_API_KEY を設定します。

グローバルインストール（代替方法）

npm install -g @templatefox/mcp-server

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

設定

環境変数	必須	説明
TEMPLATEFOX_API_KEY	はい	API キー（sk_ で始まります）。app.templatefox.com/dashboard/api-keys から取得できます
TEMPLATEFOX_BASE_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.templatefox.com）

利用可能なツール

ツール	説明
generate_pdf	動的データを使ってテンプレートから PDF を生成します（1 クレジット）
generate_pdf_async	オプションの Webhook を指定して、非同期 PDF 生成をキューに登録します（1 クレジット）
get_pdf_job_status	非同期 PDF ジョブのステータスを確認します
list_pdf_jobs	非同期 PDF 生成ジョブを一覧表示します
list_templates	利用可能なテンプレートをすべて一覧表示します
get_template_fields	テンプレートのフィールド／変数を取得します
get_account_info	残りのクレジットとアカウント情報を確認します
list_transactions	クレジットの取引履歴を表示します

リモートサーバー（HTTP）

この MCP サーバーは Streamable HTTP による HTTP トランスポートにも対応しており、リモート環境やクラウド環境へのデプロイに適しています。

URL 経由で接続

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

MCP クライアントは、HTTP ヘッダー経由で API キーを渡す必要があります。

Authorization: Bearer sk_your_api_key_here

または：

x-api-key: sk_your_api_key_here

セルフホスト

環境変数 PORT を設定して、HTTP モードでサーバーを実行します。

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

または Docker を使用します。

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

MCP エンドポイントは http://localhost:8080/mcp、ヘルスチェックは http://localhost:8080/health で利用できます。

使用例

設定が完了したら、AI アシスタントに次のように依頼できます。

「PDF テンプレートを一覧表示し、Invoice Template を使って、顧客名を 'John Doe'、金額を 150.00 にした請求書を生成してください」

アシスタントは次の処理を行います。

1. list_templates を呼び出して、利用可能なテンプレートを検索します
2. get_template_fields を呼び出して、必須フィールドを確認します
3. テンプレート ID とデータを指定して generate_pdf を呼び出します
4. PDF のダウンロード URL を返します

リンク

• TemplateFox ドキュメント
• API リファレンス
• API キーを取得
• GitHub

ライセンス

MIT