如何通过 MCP 将 Xero 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Xero、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Xero + Gemini

让你的 AI 读取 Xero 账务数据：销售发票和供应商账单、客户和供应商联系人、科目表、试算平衡表（Trial Balance）以及支持期间对比的损益表，可按权责发生制或收付实现制。只读，使用你自己的 Xero OAuth2 应用，通过 Authorize with Provider 登录。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

XERO_CLIENT_ID, XERO_CLIENT_SECRET

步骤 1 — 获取凭证

1. 登录 developer.xero.com/app/manage（My Apps），创建一个类型为 Web app 的 OAuth2 应用（授权码流程）。
2. 重定向 URI 填写 https://cloud.anythingmcp.com/api/mcp-oauth/callback（AnythingMCP Cloud）；如果你自行托管 AnythingMCP，则填写 <你的 AnythingMCP URL>/api/mcp-oauth/callback。URI 必须完全一致。
3. 在应用的 Configuration 页面，把 Client ID 复制到 XERO_CLIENT_ID，再生成一个 client secret 并填入 XERO_CLIENT_SECRET。
4. 将 XERO_TENANT_ID 和 XERO_REFRESH_TOKEN 留空，安装连接器。在连接器页面点击 Authorize with Provider，登录 Xero 并连接 AI 要读取的组织。
5. 运行 xero_list_connections。选择 tenantName 正确且 tenantType 为 ORGANISATION 的条目，把它的 tenantId 复制到 XERO_TENANT_ID。不要使用连接的 id 或 authEventId：它们是不同的值。在设置 XERO_TENANT_ID 之前，其他工具会在调用 Xero 之前停止，并指出缺少的变量。
6. 运行 xero_get_organisation，在 AI 读取任何数字之前核对组织名称。一个连接器只读取一个组织；如需第二个组织，请再安装一次。

保持登录状态：访问令牌有效期为 30 分钟，会自动续期；AnythingMCP 会保存 Xero 每次发放的新刷新令牌。刷新令牌如果 60 天内没有续期就会过期，届时请再次点击 Authorize with Provider。只有当你已经持有同一应用、同样只读授权的有效刷新令牌时，才填写 XERO_REFRESH_TOKEN。不要与其他集成共用刷新令牌：Xero 每次续期都会替换它，两者中总有一个会留下无效的令牌。

天生只读：全部十个工具都只读取数据（GET），不会创建、修改或删除任何会计数据。连接器请求的是只读权限范围 openid offline_access accounting.invoices.read accounting.contacts.read accounting.settings.read accounting.reports.trialbalance.read accounting.reports.profitandloss.read。Xero 的授权是累加的，而不是替换：如果此前曾授予该应用写入权限，令牌会保留这些权限。要缩小权限，请在 Xero 中撤销旧连接，然后再次点击 Authorize with Provider。此外，AI 只能看到登录的 Xero 用户有权查看的内容；读取报表需要该用户拥有报表访问权限。

发票、联系人和科目：xero_list_invoices 同时返回销售发票（ACCREC）和供应商账单（ACCPAY）。用 where 筛选，例如 Type=="ACCREC"；用 order 排序，例如 InvoiceNumber ASC。发票和联系人按页返回，每页最多 100 条；AI 会继续翻页，直到某一页为空或条数不足。xero_list_contacts 可按名称、联系人编号和邮箱搜索，并可按需包含已归档的联系人。科目表一次全部返回。xero_get_invoice、xero_get_contact 和 xero_get_account 需要对应列表返回的 UUID，而不是发票号、联系人名称或科目代码。

报表：xero_get_trial_balance 接收一个 date，xero_get_profit_and_loss 接收 fromDate 和 toDate（格式为 YYYY-MM-DD）。除非你要求收付实现制（paymentsOnly），两者都按权责发生制计算。损益表可以按月、季度或年对比 1 到 12 个期间（periods 和 timeframe）。

常见错误：401 或 403 表示缺少授权、授权已过期、Xero 用户缺少所需权限，或者该组织没有连接到此应用：请将 XERO_TENANT_ID 与 xero_list_connections 的结果核对，然后再次点击 Authorize with Provider。429 表示达到了 Xero 对该组织的速率限制：AI 会等待 Retry-After 给出的秒数后再重试，X-Rate-Limit-Problem 响应头会说明触发了哪个限制。限制取决于你的应用等级，参见 Xero 的 API 限制。

连接器不会在 Xero 中创建、修改或删除任何内容，也不读取银行交易、资产负债表、薪资、文件或附件。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Xero 的工具。

可用工具

示例提示

• “哪些销售发票还没有收款？每个客户总共欠我们多少？”
• “给我看上个季度的损益表，并与之前的三个季度对比。”
• “哪些供应商账单在未来 14 天内到期？金额分别是多少？”
• “在联系人中找到 Acme Ltd，给我看他们的邮箱、账单地址和未结余额。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse