财务对接服务器

Xero MCP服务器是一个允许客户端与Xero会计软件交互的服务,提供认证、交易管理、发票处理等财务功能。

  • by john-zhang-dev
  • TypeScript
  • 本地部署
  • 22 星标
  • 更新于
在 GitHub 查看 john-zhang-dev/xero-mcp

使用说明

Xero MCP服务器

此MCP服务器允许客户端与 Xero会计软件.

开始使用

  1. 确保 节点 已安装。

  2. 在Xero中创建OAuth 2.0应用程序以获得 客户端ID 和 客户端密码.

    • 创建一个免费的Xero用户帐户(如果您没有)

    • 登录Xero开发者中心https://developer.xero.com/app/manage/

    • 单击“新建应用程序”

    • 输入应用程序的名称

    • 选择Web应用程序

    • 提供有效的URL(可以是任何有效的URL,例如。https://www.myapp.com)

    • 输入重定向URI: http://localhost:5000/callback

      注: 重定向URI可以自定义,但必须使用 localhost 并且包括显式端口和路径(例如。 http://localhost:5050/my-path).设置与相同的值 XERO_REDIRECT_URI 在下面的MCP客户端配置中。

    • 勾选接受条款和条件,然后单击创建应用程序

    • 在屏幕左侧选择配置

    • 单击生成密钥

  3. 配置您的MCP客户端:

    克劳德桌面版

    转到设置->开发人员->本地MCP服务器->编辑配置,并将以下内容添加到 claude_desktop_config.json:

    {
      "mcpServers": {
        "xero-mcp": {
          "command": "npx",
          "args": ["-y", "xero-mcp@latest"],
          "env": {
            "XERO_CLIENT_ID": "YOUR_CLIENT_ID",
            "XERO_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
            "XERO_REDIRECT_URI": "http://localhost:5000/callback"
          }
        }
      }
    }
    

    重新启动Claude Desktop,或通过开发人员->重新加载MCP配置重新加载。

    克劳德代码

    运行以下命令以添加MCP服务器:

    claude mcp add xero-mcp \
      -e XERO_CLIENT_ID=YOUR_CLIENT_ID \
      -e XERO_CLIENT_SECRET=YOUR_CLIENT_SECRET \
      -e XERO_REDIRECT_URI=http://localhost:5000/callback \
      -- npx -y xero-mcp@latest
    

    服务器将在您的下一个Claude Code会话中可用。要使其在所有项目中可用,请添加 --scope user 按照上面的命令。

  4. 首次访问Xero工具时,将弹出Xero登录页面征求您的同意。完成身份验证流程并手动关闭网页(因为在此版本中Xero页面不会自动关闭)

    隐私警告:在完成Xero OAuth2流程后,您的Xero数据可能会通过您使用的LLM。如果你正在进行测试,你应该授权 Xero演示公司.

工具

  • authenticate

    使用OAuth2与Xero进行身份验证

  • create_bank_transactions

    创建一个或多个已支出或已收款交易

  • create_contacts

    在Xero组织中创建一个或多个联系人

  • get_balance_sheet

    检索资产负债表的报告

  • get_bank_transaction

    通过Xero银行交易ID检索单个已支出或已收款交易

  • get_invoice

    通过Xero发票ID检索单个销售发票或采购账单

  • list_accounts

    检索完整的会计科目表

  • list_bank_transactions

    检索任何已支出或已收款交易

  • list_contacts

    检索Xero组织中的所有联系人

  • list_invoices

    检索销售发票或采购账单

  • list_organisations

    检索Xero组织详细信息

  • list_payments

    检索发票和贷记单的付款

  • list_quotes

    检索销售报价

  • update_bank_transaction

    按银行交易ID更新现有的已支出或已收款交易(例如行项目、联系人、银行账户)

  • update_invoice

    更新现有的销售发票或采购账单(通常是草稿),包括行项目和账户代码

例子

  • “想象一下我上个月的财务状况”

  • “追踪我上周的支出”

  • “将月结单中的所有交易添加到我的收入账户(账户代码201)中作为收款”

许可证

麻省理工学院