账单管理服务器

一个连接Claude和Bill.com账户的MCP服务器,通过自然语言管理供应商、账单和支付。

  • by Christian-Sidak
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Christian-Sidak/billcom-mcp-server

使用说明

billcom mcp服务器

一个MCP(模型上下文协议)服务器,将Claude连接到您的 Bill.com 账户通过自然语言管理供应商、账单和付款。

特性

应付账款

  • 供应商 --列出、查看和创建供应商
  • 账单 --列出、查看、创建和批准账单
  • 支付 --列出并查看付款历史记录

快速开始

1.获取Bill.com API证书

您需要一个Bill.com开发者帐户和API证书。注册地址: developer.bill.com.

2.在Claude Desktop中配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "billcom": {
      "command": "npx",
      "args": ["-y", "billcom-mcp-server"],
      "env": {
        "BILLCOM_DEV_KEY": "your-dev-key",
        "BILLCOM_USERNAME": "your-email@example.com",
        "BILLCOM_PASSWORD": "your-password",
        "BILLCOM_ORG_ID": "your-org-id",
        "BILLCOM_ENV": "sandbox"
      }
    }
  }
}

3.在Claude代码中配置

claude mcp add --transport stdio billcom \
  --env BILLCOM_DEV_KEY=your-dev-key \
  --env BILLCOM_USERNAME=your-email@example.com \
  --env BILLCOM_PASSWORD=your-password \
  --env BILLCOM_ORG_ID=your-org-id \
  --env BILLCOM_ENV=sandbox \
  -- npx -y billcom-mcp-server

环境变量

变量 必填 描述
BILLCOM_DEV_KEY 是 Bill.com开发者API密钥
BILLCOM_USERNAME 是 Bill.com帐户电子邮件
BILLCOM_PASSWORD 是 Bill.com帐户密码
BILLCOM_ORG_ID 是 Bill.com组织ID(以“008”开头)
BILLCOM_ENV 没有 sandbox (默认)或 production

可用工具

供应商

工具 说明
list_vendors 按页码列出所有供应商
get_vendor 按ID获取供应商详细信息
create_vendor 创建新供应商

账单

工具 说明
list_bills 按页码列出账单
get_bill 按ID获取账单详细信息
create_bill 使用行项目创建新账单
approve_bill 批准付款账单

支付

工具 说明
list_payments 按页码列出付款历史记录
get_payment 按ID获取付款详细信息

示例提示

配置后,您可以向Claude询问以下问题:

  • “显示所有未付账单”
  • “谁是我的顶级供应商?”
  • “创建Acme Corp的500美元账单,3月15日到期”
  • “批准付款账单[ID]”
  • “显示最近的付款”

运作原理

此服务器使用 Bill.com v3 REST API身份验证是基于会话的——服务器会自动登录并根据需要刷新会话。速率限制强制执行Bill.com的3次并发请求限制。

发展

git clone https://github.com/Christian-Sidak/billcom-mcp-server.git
cd billcom-mcp-server
npm install
npm run build

许可证

麻省理工学院