bulkrender

bulkrender-mcp

BulkRender MCP サーバーです。Claude、Cursor、Windsurf、Cline、その他のMCP対応AIアシスタントからDOCXおよびPDFドキュメントを生成できます。

クイックスタート

1. bulkrender.com でサインアップします
2. Settings, Integrations, AI Assistants (MCP) に移動します
3. Generate MCP URL をクリックします。URLは一度だけ表示されるため、すぐにコピーしてください
4. AIアシスタントに貼り付けます（以下を参照）

---

AIアシスタントを接続する

Claude.ai

Settings、Integrations、Add custom integration の順に選択し、MCP URLを貼り付けます。

Claude Desktop / Cursor / Windsurf / Cline

MCP設定ファイルに追加します：

{
  "mcpServers": {
    "bulkrender": {
      "url": "YOUR_MCP_URL"
    }
  }
}

Claude Code（CLI）

claude mcp add bulkrender --scope user -- npx mcp-remote YOUR_MCP_URL

確認します：

claude mcp list
# bulkrender   ✓ Connected

---

ツール

認証が必要なツール（MCP URLが必要）

ツール	説明	クレジット
list_templates	すべてのテンプレートを一覧表示します	0
get_template	テンプレートの詳細と変数スキーマを取得します	0
search_templates	名前またはタグでテンプレートを検索します	0
generate_document	単一のドキュメント（DOCXまたはPDF）を生成します	1～2
generate_batch	複数のレコードのドキュメントを生成します（最大500件）	1～2／件
get_batch_status	バッチジョブのステータスを確認し、ダウンロードURLを取得します	0
check_credits	残りのクレジットを確認します	0
refresh_document_url	既存のドキュメントの新しい署名付きURLを取得します	0
estimate_cost	生成前に必要なクレジット数を見積もります	0
create_template_from_docx	DOCX URLから再利用可能なテンプレートを作成します	0
submit_feedback	フィードバックまたはバグレポートを送信します	0

クレジットの料金：DOCX＝1クレジット、PDF＝2クレジットです。

ウォークインツール（アカウント不要）

BulkRenderアカウントを持たないエンドユーザーに代わって動作するエージェント向けです。Stripe経由でセッションごとに支払います。

ツール	説明	料金
acp_list_public_templates	組み込みテンプレート（請求書、見積書、契約書、レポート、提案書）を一覧表示します	無料
acp_create_session	チェックアウトセッションを作成し、Stripeの決済URLを取得します	—
acp_pay_session	Stripeの支払い方法に直接請求します（開発者向けの方法）	最低$1.00
acp_get_session	セッションのステータスを確認し、完了時にダウンロードURLを取得します	無料

ウォークインの最低請求額：$1.00（DOCXは最大10件、PDFは最大5件分です）。

公開MCP URL（アカウント不要、ウォークインツールのみ）：https://mcp.bulkrender.com/mcp/acp

---

使用例

テンプレートを一覧表示する：

「BulkRenderのテンプレートを一覧表示してください」

ドキュメントを生成する：

「Invoice Templateを使って、Acme Corp宛ての請求書を生成してください。請求書番号は1234、日付は2025-01-15、金額は$5,000です」

一括生成：

「次の3社の請求書を生成してください：Acme Corp（$5,000）、Beta Inc（$3,200）、Gamma LLC（$7,800）」

---

トラブルシューティング

問題	解決策
サーバーに接続できない	「Settings, Integrations」から MCP URL を再生成します
Template not found	list_templates を使用して正しい UUID を取得します
大量のバッチでタイムアウトする	10 件を超えるレコードのバッチは非同期で処理されます — get_batch_status をポーリングします
429 Too Many Requests	レート制限に達しました — 少し待ってから再試行してください

---

レート制限

エンドポイント	制限
ドキュメント生成	組織あたり 30 リクエスト／分
テンプレートの読み取り、クレジット	組織あたり 30 リクエスト／分

generate_batch は、レコード数にかかわらず 1 リクエストとしてカウントされます。

---

リンク

• BulkRender
• API ドキュメント
• GitHub

---

npm パッケージからの移行

スタンドアロンの npm パッケージ（BULKRENDER_API_KEY を指定した npx bulkrender-mcp）はサポートされなくなりました。代わりにホスト型の MCP URL を使用してください。インストールも環境変数も不要で、ダッシュボードから URL をコピーして貼り付けるだけです。

以前の設定をお持ちの場合：

{
  "mcpServers": {
    "bulkrender": {
      "command": "npx",
      "args": ["-y", "bulkrender-mcp"],
      "env": { "BULKRENDER_API_KEY": "br_live_..." }
    }
  }
}

次の内容に置き換えてください：

{
  "mcpServers": {
    "bulkrender": {
      "url": "YOUR_MCP_URL"
    }
  }
}

BulkRender ダッシュボードの Settings, Integrations, AI Assistants (MCP) から MCP URL を取得してください。