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 账户的最终用户执行操作的 Agent。通过 Stripe 按会话付费。

工具	描述	费用
acp_list_public_templates	列出内置模板（发票、报价单、合同、报告、提案）	免费
acp_create_session	创建结账会话并获取 Stripe 付款 URL	—
acp_pay_session	直接扣取 Stripe 付款方式的款项（开发者路径）	最低 $1.00
acp_get_session	查询会话状态，完成后获取下载 URL	免费

免注册工具的最低收费：$1.00（最多可生成 10 份 DOCX 或 5 份 PDF）。

公开 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 都只计为一个请求。

---

链接

• 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。