适合谁
- 需要与 Xero 会计数据交互的 AI 助手
- 会计和财务团队的自动化工作流
X
49FMRS · D
Xero MCP Server 提供了全面的会计数据访问能力，通过 MCP 协议实现集成。官方维护，功能丰富，但需要谨慎配置权限和安全措施。
Xero MCP Server 是 Model Context Protocol (MCP) 协议的实现，用于连接 Xero API。它提供标准化的访问方式，让 MCP 客户端能够管理联系人、会计科目表、发票等会计和业务功能。支持 OAuth2 认证（自定义连接或 Bearer 令牌），并提供了丰富的命令用于查询和创建各类会计数据，包括发票、联系人、银行交易、工资单等。
工具能力
list-accounts
获取账户列表
list-contacts
获取联系人列表
list-credit-notes
获取贷项通知单列表
list-invoices
获取发票列表
list-items
获取项目列表
list-manual-journals
获取手动日记账列表
list-organisation-details
获取组织详情
list-profit-and-loss
获取损益报告
list-quotes
获取报价列表
list-tax-rates
获取税率列表
list-payments
获取付款列表
list-trial-balance
获取试算平衡表
list-bank-transactions
获取银行交易列表
list-payroll-employees
获取工资单员工列表
list-report-balance-sheet
获取资产负债表
list-payroll-employee-leave
获取员工休假记录
list-payroll-employee-leave-balances
获取员工休假余额
list-payroll-employee-leave-types
获取员工休假类型列表
list-payroll-leave-periods
获取员工休假周期列表
list-payroll-leave-types
获取所有可用的休假类型列表
list-timesheets
获取工时表列表
list-aged-receivables-by-contact
获取按联系人分组的应收账龄
list-aged-payables-by-contact
获取按联系人分组的应付账龄
list-contact-groups
获取联系人组列表
list-tracking-categories
获取跟踪类别列表
create-bank-transaction
创建银行交易
create-contact
创建联系人
create-credit-note
创建贷项通知单
create-invoice
创建发票
create-item
创建项目
create-manual-journal
创建手动日记账
create-payment
创建付款
create-quote
创建报价
create-payroll-timesheet
创建工资工时表
create-tracking-category
创建跟踪类别
create-tracking-option
创建跟踪选项
update-bank-transaction
更新银行交易
update-contact
更新联系人
update-invoice
更新草稿发票
update-item
更新项目
update-manual-journal
更新手动日记账
update-quote
更新草稿报价
update-credit-note
更新草稿贷项通知单
update-tracking-category
更新跟踪类别
update-tracking-options
更新跟踪选项
update-payroll-timesheet-line
更新工资工时表的行
approve-payroll-timesheet
批准工资工时表
revert-payroll-timesheet
撤销已批准的工资工时表
add-payroll-timesheet-line
添加工资工时表行
delete-payroll-timesheet
删除工资工时表
get-payroll-timesheet
获取工资工时表
安装接入
- 创建 Xero 开发者账户并设置自定义连接，获取客户端 ID 和密钥。
- 确保 Node.js v18 或更高版本，并安装 npm 或 pnpm。
- 在 Claude Desktop 中配置 mcpServers，使用 npx 命令启动服务器，并设置环境变量。
- 或者使用 Bearer 令牌方式，设置 XERO_CLIENT_BEARER_TOKEN。
claude_desktop_config.json
{
"mcpServers": {
"xero": {
"command": "npx",
"args": ["-y", "@xeroapi/xero-mcp-server@latest"],
"env": {
"XERO_CLIENT_ID": "your_client_id_here",
"XERO_CLIENT_SECRET": "your_client_secret_here",
"XERO_SCOPES": "accounting.invoices accounting.contacts accounting.settings"
}
}
}
}
选型与风险
不适合谁
- 不适合需要实时数据同步的高频交易系统
- 不适合非 Xero 用户
所需权限
- 需授权访问 Xero 会计数据，包括发票、联系人、银行交易、工资单等
- 具体权限取决于 OAuth 作用域，如 accounting.invoices、accounting.contacts 等
风险与副作用
- 敏感财务数据可能被泄露或误用
- 如果配置不当，可能意外修改或删除会计记录
- 需要管理 OAuth 令牌的安全存储
常见排障
- 确保 XERO_CLIENT_ID 和 XERO_CLIENT_SECRET 正确配置
- 检查网络连接是否能访问 Xero API
- 确认 OAuth 作用域是否包含所需权限
- 查看服务器日志以获取错误信息
使用场景
通过自然语言查询 Xero 中的客户、发票、账户等数据
自动化创建发票、联系人、银行交易等记录
生成财务报表如损益表、资产负债表、试算平衡表
管理工资单和工时表
支持客户端
Claude Desktop完整支持