Xero Blade MCP

施乐叶片mcp

Xero Accounting+Payroll AU MCP服务器，适用于Claude和其他LLM代理。令牌高效，安全第一，Sidereal原生。

53种工具，涵盖联系人、发票、账单、银行交易、付款、信用票据、采购订单、报价、手动日记账、会计科目表、财务报告、税率、货币、跟踪类别、工资单员工、时间表、工资单和webhook验证。

为什么选择另一个Xero MCP？

这 Xero MCP官方 是原始API传递。它返回完整的JSON有效负载（每个列表响应800多个令牌），没有写保护，没有凭据清理，也没有发布的测试套件。社区替代方案要么是仅收费的、只读的（SQL），要么仅限于4-16个工具。

xero blade mcp专为处理财务数据的LLM代理而设计：

• SecOps --强制写入门控、破坏性操作（无效、删除、存档）的确认门控、所有错误路径中的凭据清理、OAuth2令牌自动刷新、客户端_凭据模式的仅内存令牌（没有秘密写入磁盘）
• 代币效率 --管道分隔列表、字段选择、人类可读货币（150.00澳元）、空字段省略、日期格式、分页提示——不是原始JSON转储
• Sidereal生态系统 -- accounting-v1 合约、插件清单、用于调度集成的webhook HMAC-SHA256验证、用于守护进程路由的HTTP传输模式

比较

代币效率：前后

XeroAPI/xero-mcp服务器 （原始JSON，约1200个令牌）：

{"Invoices":[{"InvoiceID":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","InvoiceNumber":"INV-0001","Type":"ACCREC","Contact":{"ContactID":"f1e2d3c4-b5a6-7890-fedc-ba0987654321","Name":"Acme Corp","ContactStatus":"ACTIVE","EmailAddress":"billing@acme.com","IsCustomer":true,"IsSupplier":false},"DateString":"2026-03-15T00:00:00","DueDateString":"2026-04-14T00:00:00","Status":"AUTHORISED","SubTotal":1500.00,"TotalTax":150.00,"Total":1650.00,"AmountDue":1650.00,"AmountPaid":0.00,"CurrencyCode":"AUD","LineItems":[{"Description":"Consulting services - March 2026","Quantity":10.0,"UnitAmount":150.00,"LineAmount":1500.00,"AccountCode":"200","TaxType":"OUTPUT"}]}]}

施乐叶片mcp （管道分隔，约60个标记）：

INV-0001 | Acme Corp | AUTHORISED | A$1,650.00 AUD | 2026-04-14 | due=A$1,650.00 AUD

代币数量减少16倍 对于相同的信息。对于损益报告，节省的金额甚至更大——结构化表输出与嵌套JSON数组相比。

快速开始

# Install
uv tool install xero-blade-mcp

# Configure (Custom Connection -- recommended)
export XERO_CLIENT_ID="your_client_id"
export XERO_CLIENT_SECRET="your_client_secret"
export XERO_TENANT_ID="your_tenant_id"

# Run
xero-blade-mcp

克劳德桌面/克劳德代码

{
  "mcpServers": {
    "xero": {
      "command": "uvx",
      "args": ["xero-blade-mcp"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id",
        "XERO_CLIENT_SECRET": "your_client_secret",
        "XERO_TENANT_ID": "your_tenant_id"
      }
    }
  }
}

HTTP传输（远程/隧道访问）

export XERO_MCP_TRANSPORT="http"
export XERO_MCP_HOST="127.0.0.1"
export XERO_MCP_PORT="8770"
export XERO_MCP_API_TOKEN="your-bearer-token"  # optional, enables auth
xero-blade-mcp

认证

三种模式，按优先级顺序排列：

设置自定义连接

1. 首选 developer.xero.com 并创建新应用程序
2. 选择“自定义连接”作为应用程序类型
3. 选择要连接的组织
4. 资助范围： accounting.transactions, accounting.contacts, accounting.settings, accounting.reports.read, payroll.employees, payroll.timesheets, payroll.payslips
5. 注意客户端ID和客户端密码
6. 使用 xero_connections 查找租户ID的工具

安全模型

写入门

所有创建、更新、删除和作废操作都需要 XERO_WRITE_ENABLED=true。没有它，服务器是只读的。

确认登机口

难以逆转的破坏性操作需要 confirm=true 作为参数：

凭证清除

所有错误消息都将被清除：

• JWT代币(eyJ... 图案）
• 承载授权标头
• 长十六进制字符串（OAuth令牌、机密）

速率限制

内置速率限制器遵守Xero的API限制：

• 每个租户每分钟60个API调用
• 5个并发请求
• 使用retry-After标头在429上自动重试

配置

\*要么 XERO_CLIENT_ID + XERO_CLIENT_SECRET 或 XERO_ACCESS_TOKEN 必修的。

工具

Meta（3个工具）

联系人（5个工具）

发票（6个工具）

账单（4个工具）

银行交易（3种工具）

付款（4种工具）

信用票据（3种工具）

采购订单（2个工具）

报价（2个工具）

账户（2个工具）

手动日志（1个工具）

报告（5个工具）

参考数据（4个工具）

工资单AU（8个工具）

Webhooks（1个工具）

发展

# Setup
git clone https://github.com/groupthink-dev/xero-blade-mcp.git
cd xero-blade-mcp
make install-dev

# Test
make test           # 414 unit tests
make test-cov       # with coverage report

# Quality
make lint           # ruff linter
make format         # ruff formatter
make type-check     # mypy
make check          # all of the above

Sidereal集成

实施 accounting-v1 服务合同。注册于 Sidereal插件注册表.

# sidereal-plugin.yaml
contract: accounting-v1
tier: certified
tools: 53

Xero API范围要求

许可证

麻省理工学院