Xero MCP

Xero + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Xero API 的 MCP 服务。 与 Xero Limited 无关联，未经其认可或赞助。

_{▶ 观看 30 秒演示 - 演示数据为模拟数据；展示的每条命令都存在于实际 CLI 中。}

可读取 Xero Accounting 中的所有数据，并配备本地 SQLite 分类账 - 提供账龄分析、对账和总账核对，其他 Xero 工具都无法离线计算。可与您已在使用的 AI 搭配使用 - ChatGPT（Plus/Pro+，此连接器重新发布前暂停使用；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 也可通过远程方式搭配 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini 使用。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使在 localhost 上也不行。此版本没有密码保护， 会监听所有网络接口，并且早于浏览器重绑定防护措施， 因此您打开的网页可以访问它。MCP 工具还可以使用您的凭据进行更改。 请使用默认的 stdio 传输。如果您为远程 Agent 设置了隧道，请将其关闭。 修复方案即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，现已可用）：

您的 AI Agent	安装 Xero Skill 的方法
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 xero-mcp（无需编辑 JSON）。
ChatGPT（付费方案）	此连接器重新发布前暂停使用：ChatGPT 需要 HTTP 模式，而此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 servers 键下的 mcp.json 中添加 xero-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着需要使用此连接器的 HTTP 模式；在连接器重新发布前，该模式将暂停使用：此版本的该模式不要求密码、会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。

Microsoft 和 Google 技术栈用户也适用

用户基数很大，但有一点需要坦诚说明：这是远程 / 企业级方案，不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新发布此连接器：Copilot Studio 需要 HTTP 模式，而此版本的该模式无需密码、会监听所有网络接口，且可以通过你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 在本地运行，与 Claude Code 相同。Gemini 应用在远程运行，需要与 ChatGPT 相同的暂停使用的 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也包含在内）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，并且支持 MCP——请参阅下方的安装部分。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 配合使用。各工具的完整接入说明：docs/which-agent.md。

要运行多个 Agent？ 使用一条命令即可为所有 51 种以上受支持的 Agent 安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后为命令行 / MCP 二进制文件运行对应的 Skill 安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 的最快方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 xero-cli。从 2026-09-18 起发布的版本会在安装包内附带该 CLI；较旧的安装包仅包含 MCP 服务，因此如果你的安装包缺少配套 CLI，请先运行下方的路径 A 或路径 B 安装程序（或将 XERO_CLI_PATH 设置为现有二进制文件的路径）。详情请参阅：#331。

下载 Xero MCP (.mcpb)——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。点击一次即可，无需 JSON 或命令行。（在发布页面浏览所有 Xero 版本。）

更喜欢使用 Claude Code 插件？添加一次市场源，然后安装即可——立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install xero@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork：

在此 Agent 工作区中，从 Servosity/msp-skills 安装 Xero Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.ps1 | iex。然后按照 README 进行身份验证，并运行 xero-cli --help 了解用法。

同一条提示词也适用于任何能够运行 shell 的 Agent。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.sh)

安装程序会将 xero-cli（CLI）和 xero-mcp（MCP 服务）都放入你的用户二进制文件路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 查找 Skill。

验证：

xero-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/xero/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），并在 Settings > Extensions 中重新选择。Claude Code 插件用户：/plugin update xero@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的连接方式——每个 Agent 均有单独的章节，其中包括 GitHub Copilot 的 servers 键，以及 Microsoft 365 Copilot / Copilot Studio 的远程连接方式。Claude Desktop 的“设置 > 扩展”面板是最简单的方式；对于偏好编辑 JSON 的用户，mcp-install.md 中记录了 MCP 配置块。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/xero --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/xero --force

Hermes 原生支持 MCP，因此也可以直接使用 xero-mcp 服务——安装方式和环境变量相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/xero 安装 xero 技能。该技能定义了如何通过 openclaw: frontmatter 块安装其所需的 CLI（xero-cli）。

OpenClaw 目前尚未普遍开放；frontmatter 配置已预先提供，并会在 OpenClaw 发布后立即启用。

验证身份

设置 CLI 所需的两项凭据——OAuth2 访问令牌（在 Xero 开发者门户中创建 Custom Connection）和贵组织的租户 ID：

XERO_ACCESS_TOKEN=<value> XERO_TENANT_ID=<value> xero-cli doctor

运行任何会操作数据的命令前，doctor 会确认凭据有效。即使凭据被拒绝，它也会以状态码 0 退出，因此脚本应添加 --fail-on error。

此技能的功能

MSP 经常提出的问题	命令
谁欠我们钱？每张发票逾期多久？	xero-cli aging --agent
我们欠供应商多少钱？按账龄分组如何？	xero-cli aging --payable --agent
哪些联系人带来的应收账款风险最高？	xero-cli exposure --agent
哪些已授权发票仍未结清，且没有已应用的付款？	xero-cli reconcile --agent
哪些银行交易尚未对账？它们可能与什么匹配？	xero-cli bank-recon --agent
关账时，总账控制账户与未结发票的金额是否相符？	xero-cli tie-out --agent
某个账户发生了哪些过账？按余额变化列出。	xero-cli ledger 200 --agent
自上周以来，组织发生了哪些变化？	xero-cli since 7d --agent
一次调用就给我一份组织状态摘要。	xero-cli snapshot --agent

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run 以及何时在变更数据前确认），请参阅 AGENTS.md。

与众不同之处

大多数 Xero 集成和 MCP 服务都会将每个问题转发为实时 API 调用。查询单条记录时，这样没问题。但当你需要查询“所有已授权发票中，谁欠我们钱、每张逾期多久”时，它就无法应对大规模查询了——而且查询过程中会迅速耗尽 Xero 每分钟 60 次、每天 5,000 次的速率限制。

此技能会将 Xero 同步到带有全文搜索的本地 SQLite 镜像中。汇总类问题只需执行一次本地 SQL 联接：即时完成、无需联网，AI 看到的是答案而非原始数据。reconcile（将已授权发票与已应用的付款进行交叉联接）和 tie-out（将不可变的日记账控制账户与未结发票进行比对）等组合命令会联接发票、付款、日记账和账户——这是无状态 API 封装层无法完成的工作。

它解决的痛点

现金流会拖垮小型服务企业，而其中最慢的环节就是催收。在 r/msp 和 r/bookkeeping 上，反复出现同一个抱怨：每周催收应收账款和月末结账都是手动流程。你导出 Aged Receivables 报告，将其粘贴到电子表格中，再按逾期天数创建数据透视表——等催收清单做好时，数据早已过时一天。将已收款项与已授权发票对账，以及将未对账的银行流水与其结算的发票对应起来，都得逐行来回点击。想通过脚本解决这些问题，又会遇到 Xero 每分钟 60 次、每天 5,000 次的 API 调用上限，因此你真正需要的跨端点答案无法通过一次调用获得。

此技能通过将组织同步到本地镜像，然后离线提供答案，解决这一问题：

• xero-cli aging --agent - 本周的催收清单，按逾期天数分组（欠款情况可使用 --payable）。
• xero-cli exposure --agent - 按联系人排序的应收账款风险，并细分逾期情况。
• xero-cli reconcile --agent - 现金收款核销差额：仍有欠款且尚无已核销付款的已授权发票。
• xero-cli bank-recon --agent - 将未对账的银行流水与可能对应的发票和付款相匹配。
• xero-cli tie-out --agent - 证明 GL 控制账户与结账时的未结发票相符；差异为零即为对平信号。

更完整的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

此版本暂不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 计划；Free 计划尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着必须以 HTTP 模式运行 Xero MCP 服务。此版本的 HTTP 模式无需密码，会监听所有网络接口，且你打开的网页也能访问它，因此在连接器重新发布之前，请勿运行它或将其置于隧道之后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这能与 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 配合使用吗？

可以——它们都支持 MCP。跨工具安装命令见上方的对照表，深入说明请参阅 docs/which-agent.md。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方案是在每个操作系统上运行一行安装命令（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Xero 凭据。

我的 Xero 数据安全吗？

你的数据始终保存在你的设备上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户账户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而非原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 绝不会将其打包进此仓库，也不会将其传输到任何地方。

这会触及 Xero API 调用速率限制吗？

很少会。在将数据 sync 到本地镜像一次后，账龄分析、对账、试算平衡、风险分析、分类账和搜索都完全离线运行——API 调用次数为零。只有 sync、明确的实时读取和写入操作会调用 API，而 Xero 将其限制为每个组织每分钟 60 次、每天 5,000 次调用。本地优先的设计正是为了不触及此上限。

它需要哪些 Xero 凭据？会创建这些凭据吗？

你需要在 Xero 开发者门户中创建 OAuth2 令牌——对于机器对机器的使用，Custom Connection 是最简单的方式——然后通过 XERO_ACCESS_TOKEN 和 XERO_TENANT_ID 传入该令牌及组织的租户 ID。CLI 绝不会创建或轮换令牌；它只会使用你提供的令牌。运行 xero-cli doctor，确认两项都已设置后再进行同步。

它适用于一个组织还是多个组织？

每个 XERO_TENANT_ID 对应一个组织。本地镜像仅保存单个租户的数据；如需管理多个实体，请依次将租户 ID 指向各个组织并循环处理。

它会取代 Xero 网页应用吗？

不会。它是对你仍在使用的门户的补充，门户仍用于编辑和日常簿记。此技能用于在你已有的 AI Agent 中回答跨报表问题——账龄、对账、总账核对——并离线计算结果。

费用是多少？

免费。采用 Apache-2.0 许可。你只需为所使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 服务提供商收取，而非我们收取。

安全模型

层级	示例	推荐的 Agent 策略
读取	aging、exposure、reconcile、bank-recon、tie-out、ledger、snapshot、since、search、sync、doctor，以及所有 get 命令	允许
写入（常规）	invoices create、invoices update、contacts create、accounts create、payments create、bank-transactions create、items create，以及批量 import	使用 --dry-run 预览，然后经审核后写入
破坏性操作／凭据操作	accounts delete、items delete、payments delete、auth logout	仅限人工介入

最有力的控制措施是授予 Xero 凭据的权限范围——CLI 只能执行这些凭据获准执行的操作。完整详情（包括如何收紧权限）请参阅 governance.md。

状态

Beta 版。已根据 Xero API 的功能范围进行验证，目前正通过每周 Build Sessions 与在自有生产租户上运行的 MSP 一起进行验证。请在 compoundingteams.com/build-sessions RSVP。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-06-06。