LedgerCrossing for QuickBooks Desktop

LedgerCrossing — QuickBooks Desktop 的 MCP 服务和 HTTP API

LedgerCrossing 为 QuickBooks Desktop（Pro、Premier、Enterprise）提供 HTTP/qbXML API 和 MCP 服务，让你的应用和 AI Agent 无论身处何处都能访问：同一台机器、办公室网络，或通过 LedgerCrossing Remote 连接互联网。

Claude、ChatGPT、Cursor、VS Code 和任何其他 MCP 客户端都能使用六种工具，覆盖全部 240 项 qbXML 操作。你自己的代码可以使用 POST /api/v1/qbxml：发送 qbXML，获取 qbXML 响应。无需托管 SOAP 服务， 也无需通过 Web Connector 轮询。

本仓库包含文档、示例、MCP Registry 条目（server.json），以及在其 releases 中提供的 Claude Desktop 扩展包（.mcpb）。 LedgerCrossing 应用本身是一款商业 Windows 应用：一次性购买，按机器授权，公司文件数量不限。定价请参阅 ledgercrossing.com。其源代码不在本仓库中，且如果未在 QuickBooks 计算机上安装该应用， 这里的任何内容都无法运行。

兼容性： LedgerCrossing 可与任何能够发起 Web 请求的程序配合使用。如今通过 Web Connector 同步的现成 应用由其供应商控制，LedgerCrossing 并不能取代它们。如果你（或你的开发者）能够控制集成， 切换起来很简单：将你现在发送的同一份 qbXML 作为 HTTP POST 发送即可。

QuickBooks Desktop 为什么需要它

QuickBooks Desktop 没有云 API。它只能通过运行所在机器上的 COM 接口接受 qbXML。Intuit 官方的 AI 连接器适用于 QuickBooks Online，而非 Desktop。LedgerCrossing 在 QuickBooks 所在机器上运行，并将其转换为工具可调用的端点。

连接 AI 客户端

根据 AI 相对于 QuickBooks 计算机的运行位置，选择对应的方式。

客户端	位置	方式	要求
Claude Desktop	QuickBooks 计算机	.mcpb bundle	无需复制任何内容
Claude Desktop	办公室里的另一台计算机	.mcpb bundle + 地址和 API key	需开启 Settings > Allowed Connections > Local network
claude.ai、ChatGPT、Meta Muse	任何位置	LedgerCrossing Remote（$39/mo）	每人单独登录（OAuth）；Meta Muse 需要 LedgerCrossing 1.15.1 或更高版本
Claude Code、Cursor、VS Code	上述任一位置	HTTP 配置	MCP URL + API key（同一台机器或办公室）；通过 Remote 登录
Codex、Gemini CLI	QuickBooks 计算机或办公室	快速入门	QuickBooks 计算机上无需配置（stdio）；从另一台计算机连接时需要 MCP URL + API key

MCP 端点为 http://<machine>:8284/mcp（streamable HTTP）。应用中的 Settings > Allowed Connections 会显示确切地址和 API key。

Claude Desktop

1. 从本仓库的 最新版本下载 ledgercrossing.mcpb。
2. 在 Claude Desktop 中打开 Settings > Extensions > Advanced settings > Extension Developer > Install Extension…，然后选择该文件。（Windows 没有为 .mcpb 设置文件关联，因此 双击文件无法安装。）
3. 在 QuickBooks 计算机上保留默认设置。在办公室的另一台计算机上，设置 LedgerCrossing address（例如 http://qb-server:8284），并粘贴 API key。

更喜欢使用配置文件？请参阅 examples/mcp-configs/claude_desktop_config.json （stdio 模式，仅适用于同一台机器）。

Claude Code、Cursor、VS Code

claude mcp add --transport http quickbooks http://localhost:8284/mcp --header "X-Api-Key: YOUR_KEY"

Cursor 和 VS Code 配置位于 examples/mcp-configs/。从办公室的另一台电脑连接时，将 localhost 替换为这台电脑的名称。无论身处何处，都可以通过 LedgerCrossing Remote 连接，并使用个人账号登录，方式与 claude.ai 相同（参见 /docs/connect）。

然后询问：“哪些客户的逾期时间超过 60 天？”

六种工具

工具	功能
list_operations	列出或搜索 240 个 qbXML 操作，并显示类别和所需的最低 QuickBooks 版本
get_operation	查看某个操作的完整字段参考：元素顺序、必填字段、最大长度、枚举值
validate_qbxml	根据目录检查请求，不接触 QuickBooks
run_qbxml	在 QuickBooks Desktop 中运行 qbXML 并返回响应
explain_error	将 QuickBooks 状态代码转换为错误原因及修改建议
get_status	检查 QuickBooks 是否运行、当前打开的公司文件，以及桥接是否已连接

Agent 会按需发现所需信息（list_operations → get_operation → validate_qbxml → run_qbxml），因此目录不会淹没其上下文。

**连接 Agent 前请注意：**它可以写入数据。在运行 QuickBooks 的电脑和办公室网络上，run_qbxml 可以创建发票、付款和修改内容，权限与 HTTP API 相同。通过 LedgerCrossing Remote 连接时，每个人的初始权限均为只读，直到所有者允许进行修改。默认情况下会拒绝无界查询，QuickBooks 的审计跟踪会记录每笔已过账的交易。请仅连接你信任的 Agent，并确保它们只能访问你允许操作的公司文件。

在自己的代码中调用

curl -s http://localhost:8284/api/v1/qbxml \
  -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"qbxml": "<?xml version=\"1.0\"?><?qbxml version=\"13.0\"?><QBXML><QBXMLMsgsRq onError=\"stopOnError\"><CustomerQueryRq><MaxReturned>10</MaxReturned></CustomerQueryRq></QBXMLMsgsRq></QBXML>"}'

更多示例见 examples/：Python、Node.js 和 PowerShell，以及如何在发送请求前进行验证。

端点	用途
POST /api/v1/qbxml	运行 qbXML 请求
POST /api/v1/validate	根据目录验证 qbXML，无需与 QuickBooks 往返通信
GET /api/v1/docs?search=	搜索操作目录
GET /api/v1/docs/{operation}	查看某个操作的字段参考，例如 CustomerQuery
GET /api/v1/errors/{code}	解释 QuickBooks 状态代码
GET /api/v1/health	存活检查
POST /mcp	MCP 端点（可流式传输的 HTTP）

随时随地访问

• 同一台电脑： http://localhost:8284。
• 办公室网络： 开启 Settings > Allowed Connections > Local network；应用会先要求提供 API 密钥，并管理自己的防火墙规则。免费。
• 互联网： LedgerCrossing Remote（$39/月），这是一项托管 HTTPS 中继服务，支持个人账号登录，claude.ai 和 ChatGPT 均要求使用此服务（Meta Muse 也已通过验证）。或者，为支持发送 API 密钥标头的客户端，按照免费指南自行搭建隧道。

系统要求

• Windows 10 或 11，或 Windows Server 2016–2025，并安装 QuickBooks Desktop Pro、Premier 或 Enterprise。
• QuickBooks 正在运行且公司文件已打开（或可自动打开）。这是 QuickBooks Desktop 的限制。
• 在该电脑上安装并激活 LedgerCrossing（Meta Muse 需使用 1.15.1 或更高版本）。

链接

• 产品和定价：https://ledgercrossing.com
• MCP 快速入门：https://ledgercrossing.com/docs/mcp
• 将 Claude 连接到 QuickBooks Desktop：比较各种方案：https://ledgercrossing.com/connect-claude-to-quickbooks-desktop
• claude.ai 和 ChatGPT 设置：https://ledgercrossing.com/docs/connect
• 支持：[email protected]

许可证

本仓库中的文档、示例和 server.json 均采用 MIT 许可（参见 LICENSE）。LedgerCrossing 应用和 .mcpb 捆绑包是商业软件，按机器授权，具体条款见 ledgercrossing.com。MIT 许可证不适用于它们。

---

QuickBooks 是 Intuit Inc. 的注册商标。LedgerCrossing 是一款面向 QuickBooks Desktop 的独立产品，与 Intuit 无关联，也未获得 Intuit 背书。客户名称归各自所有者所有。