QuoteBill

QuoteBill MCP 服务

通过你已在使用的 AI 助手起草报价单、发票和销售中的其他单据。QuoteBill 的远程 MCP 服务为 ChatGPT、Claude、Gemini 和任何其他 MCP 客户端提供：

• 十种单据：报价单、发票、形式发票、收据、贷项通知单、采购订单、交货单、工单、对账单和商业发票
• 536 个模板，涵盖各类行业、专业服务、国家和语言，适用于所有单据类型
• 195 个国家/地区的税务规则，每条规则都注明了所依据的官方来源和核查日期
• 精确计算的总额，采用与 QuoteBill 编辑器相同的算法，并按货币取整
• 成品文档链接：build_document 会返回一个 URL，打开后即可在 quotebill.com 查看已填写的草拟文档，并下载为 Excel 或 Word 文件，或保存为 PDF
• 流程中的下一份单据：next_document 可将草拟的报价单转为发票，将发票转为收据、贷项通知单或交货单等，并保留相关方、明细、税费和语言
• 可供查阅的合同和表格样本：list_contract_templates 和 get_contract_template 可查找 QuoteBill 的合同样本；search_forms 和 get_form 可查找 Forms Top 100 中的表格，例如保密协议、劳动合同或辞职信，并显示其提供的国家/地区和语言（这些是样本和模板，不构成法律、税务或会计建议）

端点	https://quotebill.com/mcp
传输方式	Streamable HTTP（JSON 响应）
身份验证	使用免费的 QuoteBill 账户通过 OAuth 2.1 完成。你的 AI 应用会自动找到登录入口：它会打开 QuoteBill，你登录（支持 Google 登录）并选择 允许
协议	2026-07-28，以及 2025-03-26 至 2025-11-25 的握手修订版本
语言	支持以 33 种语言作答
用户指南	在 ChatGPT、Claude 和 Gemini 中使用 QuoteBill
MCP Registry	io.github.auto1225/quotebill

连接

首次连接时，你的 AI 应用会在浏览器中打开 QuoteBill。免费登录或注册，确认是哪个应用发起请求，然后选择 允许。每个应用只需操作一次；你可以随时在 QuoteBill 公司设置中的 已连接的 AI 应用 下断开应用连接。

Claude（claude.ai、桌面端和移动端）— Settings → Connectors → Add custom connector。名称填写 QuoteBill，URL 填写 https://quotebill.com/mcp，然后选择 Connect。也可以打开此链接：将 QuoteBill 添加到 Claude。

ChatGPT（chatgpt.com）— 在 Settings 中启用开发者模式，然后从应用页面创建应用：MCP 服务 URL 填写 https://quotebill.com/mcp，身份验证选择 OAuth。登录 QuoteBill 并授权，然后在聊天中的 + 菜单里添加 QuoteBill。

Claude Code

claude mcp add --transport http quotebill https://quotebill.com/mcp

然后运行 /mcp，选择 quotebill 并登录。

Codex — ~/.codex/config.toml，然后运行 codex mcp login quotebill

[mcp_servers.quotebill]
url = "https://quotebill.com/mcp"

Gemini CLI — 将此仓库安装为扩展：

gemini extensions install https://github.com/auto1225/quotebill-mcp

或者将其添加到 ~/.gemini/settings.json：

{ "mcpServers": { "quotebill": { "httpUrl": "https://quotebill.com/mcp" } } }

然后运行 /mcp auth quotebill 登录一次。

Cursor — .cursor/mcp.json（启用服务时，Cursor 会打开登录页面）

{ "mcpServers": { "quotebill": { "url": "https://quotebill.com/mcp" } } }

VS Code — .vscode/mcp.json（服务启动时，VS Code 会提示你登录）

{ "servers": { "quotebill": { "type": "http", "url": "https://quotebill.com/mcp" } } }

Claude Code 插件 — 此仓库同时也是一个插件市场：

/plugin marketplace add auto1225/quotebill-mcp
/plugin install quotebill@quotebill

登录方式

没有令牌的请求会收到 401，并附带 WWW-Authenticate: Bearer resource_metadata="https://quotebill.com/.well-known/oauth-protected-resource/mcp"。该元数据（RFC 9728）会指定授权服务器，即位于 https://wgpfbcfiontxqusseoyv.supabase.co/auth/v1 的 Supabase Auth；其元数据（RFC 8414）支持动态客户端注册、PKCE 和 email 作用域。遵循 MCP 授权规范的 MCP 客户端无需进行其他操作。

工具

工具	功能
search_templates	按关键词、文档类型、类别或国家/地区查找模板，并以指定语言返回，还会提供示例行项目以及每个模板打开时所在的页面。
get_template	获取一个模板 slug 对应的完整记录及其示例行项目。
get_tax_rule	获取任意 195 个国家/地区已发布的税率、名称、货币和信息来源；如果发票可能需要是电子发票，还会返回相关系统。
calculate_totals	汇总行项目，应用折扣和所在国家/地区的税费，并将每个税费组成部分分别四舍五入到相应货币的精度。
build_document	根据行项目创建十种类型中的任意一种完整文档，也可选择使用模板；返回一个链接，打开后即可在 quotebill.com 上查看已填好的文档。
next_document	根据 build_document 或 next_document 返回的链接创建下一份文档：报价单变为发票，发票变为收据，依此类推。
calculate_tax	VAT 和 GST 计算器：在净额上加税，或从总额中扣税；可选预扣税，并将结果四舍五入到相应货币的精度。
convert_currency	通过欧元和欧洲央行的每日参考汇率换算金额；该汇率仅供参考，并非银行汇率。
list_contract_templates	按关键词、分组或是否包含价格表，列出或查找 QuoteBill 的示例合同。
get_contract_template	按 ID 或 slug 获取一份示例合同：包括其分组、摘要、当事方和条款标题；也可按需获取英文文本。此为示例，不构成法律建议。
search_forms	按关键词、表单列表部分、国家/地区或语言查找 QuoteBill Forms Top 100 中的表单，并提供每个表单所在页面和编辑器链接。表单是模板，不构成法律、税务或会计建议。
get_form	按 ID 获取 Forms Top 100 中的一份表单：包括其类型、摘要、适用的国家/地区和语言，以及可绘制该表单的设计样式。
top_templates	列出会员最喜欢的模板或示例合同，并仅提供数量。
list_guides	列出 QuoteBill 的操作指南，例如如何将报价单转换为发票，或德国、日本或韩国的发票必须包含哪些内容。
list_reference	列出其他工具可接受的类别、布局、语言和国家/地区代码，以及示例合同的分组和 Forms Top 100 的部分。

每个工具都会发布 inputSchema 和 outputSchema，并带有注释 readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: false。参数无效时会返回工具错误，并说明需要修正的内容。

请求示例

• “在 QuoteBill 中为我在日本的客户制作一张发票：网站设计费 ¥480,000，外加每月 ¥25,000、共三个月的维护费，维护费打 5% 折扣。”
• “使用 QuoteBill 为我在德国的客户制作一份报价单，咨询服务共 12 小时，每小时 €95。”
• “在 QuoteBill 中用我的韩国公司信息制作一张形式发票，40 个阀门，每个 $180，以美元计价：保留韩国的税务规则。”
• “查找一份用于管道工程报价的 QuoteBill 模板，并填入这些项目。”
• “客户接受了这份报价单：将其转换为发票，编号为 INV-2026-014。”
• “在 QuoteBill 中制作一张形式发票：40 个阀门，每个 $180，运往越南，然后为同一批货物制作商业发票。”
• “法国的 VAT 税率是多少？QuoteBill 从哪里获取这个税率？”

隐私

服务会检查调用者是否已登录为 QuoteBill 成员，然后只查询模板和税务规则并进行算术运算。AI 应用持有的登录令牌无法读取成员保存的文档、个人资料或文件；数据库会拒绝所有发放给应用的令牌。服务不会保存任何内容，也不会保留客户名称或金额；其日志会记录工具、是否成功响应以及客户端名称，但绝不记录参数或账户信息。草拟的文档会放在返回链接中，位于 # 之后；浏览器绝不会将这部分发送给服务器。链接还带有校验和，因此如果副本被篡改，系统会拒绝打开，而不是显示错误数字。系统会使用每分钟变化一次的加盐哈希值，按账户限制调用频率；这些计数会在一小时内删除。请参阅隐私声明。

限制

• 每个账户每分钟最多调用工具 60 次
• 最多 200 个明细项，每项及每份文档的金额上限为 100,000,000,000
• 已发布的税率仅供参考，并非税务建议：仍需确认注册情况、供应地点以及商品或服务的税务处理方式

支持

[email protected] · quotebill.com/en/contact

许可证

本仓库中的配置文件采用 MIT 许可证。QuoteBill 服务由 quotebill.com 运营。