TemplateFox

MCP Server

ページをコピー

MCP Server

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を生成します。PDF1枚につき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生成をキューに入れます。大規模なジョブやバッチジョブに便利です。PDF1枚につき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アシスタントに特定のデータで1つのPDFを生成するよう依頼します。アシスタントはテンプレートを検出し、必要なフィールドを確認し、一連の流れで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リファレンス — 完全なエンドポイントドキュメント

最終更新日 2026年7月12日

PDF StandardsUpload to S3