docjet-mcp

docjet-mcp

DocJet の MCP サーバーです。任意の MCP クライアント（Claude Desktop、Claude Code、Cursor、Windsurf、……）から、ブランドに合わせた PDF ドキュメント（請求書、レポート、証明書）や PNG のソーシャル画像を直接生成できます。

テンプレート ID または生の HTML と JSON データを送信すると、署名付きダウンロード URL が返されます。npx を使って stdio 経由でローカル実行するため、ホストするものはありません。

クイックスタート

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "docjet": {
      "command": "npx",
      "args": ["docjet-mcp"],
      "env": {
        "DOCJET_API_KEY": "binfra_your_key_here"
      }
    }
  }
}

docjet.dev で API キーを取得してください。サインアップせずに試す場合は、公開デモキーを使用できます（レート制限：3 リクエスト/分、50 回のレンダリング/月、全員で共有）。

binfra_9afb57dbb6478c441ad101129fca65847f5745403f9d718b3de6d934c9b63f88

ツール

ツール	説明
render_pdf	ブランドに合わせた PDF を生成します。入力：template_id（または生の html）と data オブジェクト。署名付きダウンロード URL を返します。
render_image	PNG 画像（例：OG／ソーシャルカード）を生成します。入力：template_id（または生の html）と data オブジェクト。署名付きダウンロード URL を返します。
list_templates	利用可能なテンプレートの id、name、description、outputType を一覧表示します。API キーは不要です。

接続後のプロンプト例：

「DocJet のテンプレートを一覧表示してから、invoice-ro テンプレートを使い、クライアント名を『Demo SRL』、合計を 1000 にして PDF を生成してください。」

環境変数

変数	必須	説明
DOCJET_API_KEY	はい	DocJet の API キー（binfra_ プレフィックス）。Bearer トークンとして送信され、ログには記録されません。
DOCJET_BASE_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.docjet.dev）。

仕組み

• 公式の @modelcontextprotocol/sdk（v1）を使用した stdio トランスポートです。
• render_pdf → POST /v1/render?response=url、render_image → POST /v1/image?response=url、list_templates → GET /v1/templates。
• ネットワーク呼び出しの前に、テンプレート ID を正規表現 ^[a-z0-9][a-z0-9-]{0,63}$ に照らしてローカルで検証します。
• API エラーは、DocJet のエラーコード（例：QUOTA_EXCEEDED、RATE_LIMITED）を含む MCP エラーコンテンツとして返されます。

リンク

• API ドキュメント：docjet.dev/docs
• JS/TS SDK：npm の docjet
• サポート：[email protected]

ライセンス

MIT