内容
krender-mcp
-nci/bulkrender-mcp MCP server](https://glama.ai/mcp/servers/ayo-nci/bulkrender-mcp/badges/score.svg)](https://glama.ai/mcp/servers/ayo/bulkrender-mcp)
BulkRender MCP 服务器。 从 Claude、Windsurf、Cline 和其他任何与 MCP 兼容的 AI 助手生成 DOCX 和 PDF 文档。
## 快速入门
1. 在 [bulkrender.com](https://bulkrender.com) 注册
2. 进入 **设置，集成，AI 助手（MCP）**
3. 点击 **生成 MCP URL** — 立即复制，只显示一次
4. 粘贴到您的 AI 助手（见下文）
---
## 连接您的 AI 助手
.ai
设置，集成自定义集成，粘贴您的 MCP URL。
### Claude Desktop / Cursorsurf / Cline
将以下内容添加到您的 MCP 配置文件中：
{
"mcpServers": {
"bulkrender": {
"url": "您的 MCP URL"
}
}
}
```
### Claude Code（命令行）
```bash
claude mcp add bulkrender --scope user -- npx mcp-remote 您的 MCP URL
```
验证：
```bash
claude mcp list
# bulkrender ✓ 已连接
```
---
## 工具列表
### 需要身份验证的工具（需要 MCP URL）
| 工具 | 描述 | 积分 |
| --------------------------- | ----------------------------------------------- | ------ |
| `list_templates` | 列出所有模板 | 0 |
| `get_template` | 获取模板详细信息和变量模式 | 0 |
| `search_templates` | 按名称或标签搜索模板 | 0 |
| `generate_document` 单个文档（DOCX 或 PDF） | 1-2| `generate_batch` 为多个记录生成文档（500 个） | 每个-2 |
| `_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 积分。
### 无需账户的工具（Walk-in 工具）
适用于代表没有 BulkRender 账户的终端用户操作的代理。 通过 Stripe 按会话付费。
| | 描述 | 费用 |
| --------------------------- | -------------------------------------------------------------------- | --------- |
| `acp_list_public_templates` | 列出内置模板（发票、报价、合同、报告、提案） | 免费 |
| `acp_create_session` | 创建结账会话并获取 Stripe 支付 URL | — |
| `acp_pay_session` | 直接充值 Stripe 支付方式（开发者路径） | 最低 $1.00 |
| `acp_get_session` | 查询会话状态，获取下载 URL（完成后） | 免费 |
Walk-in 最低收费：**$1.00** （涵盖最多 10 个 DOCX 或 5 个 PDF 文档）。
公共 MCP URL（无需账户，仅限 Walk-in 工具）：`https://mcp.bulkrender.com/mcp/acp`
---
## 使用示例
**列出模板：**
> "列出我的 BulkRender 模板"
**生成文档： "使用 Acme Corp模板生成发票，发票 #，日期 2025-01-15，金额 $5"
**批量生成：**
> "为以下 3 个发票：Acme Corp ($000)、Beta Inc ($3,200)、Gamma LLC ($7)"
---
## 故障排除
| 问题 | 解决方案| ----------------------- | --------------------------------------------------------------- |
| 服务器未连接 | 从集成中重新生成您的 |
| `模板未 | 使用 `list_templates正确的 UUID |
|超时 | 超过 条记录的批量异步处理get_batch_status` 429 请求过多`速率限制 — 短后重试 |
---
##限制
| 端点 限制 |
| | ------------------------------------- |
| 文档生成 | 每分钟 30组织 |
| 模板积分 | 每分钟 请求，每个组织 |
`` 无论记录数量多少，都算作一次请求。
---
链接
- [Bulkhttps://bulkrender.com [API 文档](httpskrender.com/docs/api)
Hub](https://github.com/ayo-nci/bulkrcp)
---
## 包迁移
独立的 npm 包（`npx bulkrender-mcp` 和 `BULNDER_API_KEY`）不再。改用托管的 — 无需安装，无需环境变量，只需从您的仪表贴 URL。
如果您有：
```json
"mcpServers": {
krender": {
command": "npx "args": ["-y", "bulkrender-mcp"],
"env": { "BULKRENDER_API_KEY": "br_live_..." }
}
}
}
```
将其替换为：
```json
{
"mcpServers": {
"bulkrender": {
"url": "您的 MCP URL"
}
}
}
```
从您的 BulkRender 仪表板中的 **设置，集成，AI 助手（MCP）** 获取您的 MCP URL。
