连接器指南阅读约 4 分钟10 个 MCP 工具7 种语言

如何通过 MCP 将 Xero 连接到 Microsoft Copilot

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

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Xero

Xero

Read a Xero organisation's invoices, bills, contacts, chart of accounts, Trial Balance and Profit and Loss reports. 10 GET-only tools with OAuth2; xero_list_connections finds the tenant ID after authorisation.

个工具

10

区域

INTL

类别

会计

身份验证

OAuth 2.0

所需环境变量

XERO_CLIENT_IDXERO_CLIENT_SECRET
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Xero,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

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

试试这样问

Xero 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Xero · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

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

Xero + Microsoft Copilot

让你的 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 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Xero 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

ToolWhat it does
xero_list_connectionsList the Xero organisations this authorisation can read, with tenantId, tenantName and tenantType
xero_get_organisationRead the configured organisation's name, base currency and settings
xero_list_invoicesList sales invoices and purchase bills with totals, status and line items, one page at a time
xero_get_invoiceRead one invoice or bill with its line items, amounts and payment details
xero_list_contactsList customer and supplier contacts one page at a time
xero_get_contactRead one customer or supplier contact, including its addresses, contact people and balances
xero_list_accountsRead the chart of accounts with account codes, names, types, tax types and status
xero_get_accountRead one account's code, name, type, tax type and status
xero_get_trial_balanceRead the Trial Balance as at a specified date, including debit, credit and year-to-date values
xero_get_profit_and_lossRead income, expenses and profit for a date range

示例提示

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

FAQ

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

你的 Xero 智能体只差一次点击。

安装连接器,粘贴密钥,向 Microsoft Copilot 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

Xero 接入 MCP:从任意 AI 代理驱动 Xero

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

连接器

如何通过 MCP 将 Xero 连接到 Meta Muse

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

连接器

如何通过 MCP 将 Xero 连接到 ChatGPT

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

连接器

如何通过 MCP 将 Xero 连接到 Claude

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

连接器

如何通过 MCP 将 Xero 连接到 Cursor

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

连接器

如何通过 MCP 将 Xero 连接到 Gemini

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