应付账款与支出管理服务

Bill.com MCP服务器

用于Bill.com API集成的MCP服务器实现，提供应付账款和支出管理功能。

特性

核心AP（v2 API）

• 供应商：搜索、获取、创建、更新、存档
• 账单：搜索、获取、创建、更新、存档
• 账单支付：搜索、获取、创建、作废
• 供应商信用：搜索、获取、创建、更新、存档
• 经常性账单：搜索、获取、创建、更新、存档
• 审批：获取政策、待批准、批准/拒绝账单、历史记录

支出和支出（v3 API）

• 预算：搜索、获取、创建、更新
• 卡片：搜索、获取、创建虚拟、冻结、解冻
• 交易：搜索、获取、更新
• 报销：搜索、获取、创建、批准

API体系结构

此服务器使用 两种不同的Bill.com API:

v2 AP API

• 基本URL:
  • 生产： https://api.bill.com/api/v2
  • 沙箱： https://api-sandbox.bill.com/api/v2
• 认证：基于会话（用户名/密码/devKey）
• 实体：供应商、账单、账单付款、供应商信用、经常性账单、批准

v3支出和支出API

• 基本URL:
  • 生产： https://gateway.bill.com/connect/v3/spend
  • 沙箱： https://gateway.stage.bill.com/connect/v3/spend
• 认证：基于令牌(apiToken 头球
• 实体：预算、卡片、交易、报销

设置

1. 复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

2. 安装依赖项：

npm install

3. 构建：

npm run build

配置

添加到您的Claude Code MCP配置中：

{
  "billcom": {
    "command": "node",
    "args": ["/path/to/billcom-mcp-server/dist/index.js"],
    "env": {
      "BILLCOM_USERNAME": "your-email@example.com",
      "BILLCOM_PASSWORD": "your-password",
      "BILLCOM_ORG_ID": "your-org-id",
      "BILLCOM_DEV_KEY": "your-dev-key",
      "BILLCOM_SPEND_API_TOKEN": "your-spend-api-token",
      "BILLCOM_ENVIRONMENT": "production"
    }
  }
}

环境变量

备注：如果您只需要AP功能，则可以仅使用v2凭据，如果您只需Spend&Expense功能，则只能使用v3令牌。

可用工具

供应商（v2 API）

• search_vendors -使用筛选器搜索供应商
• get_vendor -按ID获取供应商
• create_vendor -创建新供应商
• update_vendor -更新供应商
• archive_vendor -存档（停用）供应商

法案（API第2版）

• search_bills -使用过滤器搜索账单
• get_bill -按ID获取账单
• create_bill -创建新账单
• update_bill -更新账单
• archive_bill -档案账单

账单支付（v2 API）

• search_bill_payments -搜索付款
• get_bill_payment -通过ID获取付款
• create_bill_payment -创建账单付款
• void_bill_payment -作废未处理的付款

供应商信用（v2 API）

• search_vendor_credits -搜索学分
• get_vendor_credit -通过ID获取积分
• create_vendor_credit -创建信用
• update_vendor_credit -更新信用
• archive_vendor_credit -档案信用

经常性票据（v2 API）

• search_recurring_bills -搜索定期账单
• get_recurring_bill -按ID获取定期账单
• create_recurring_bill -创建定期账单
• update_recurring_bill -更新定期账单
• archive_recurring_bill -存档定期账单

批准（第2版API）

• get_approval_policies -获取所有审批政策
• get_pending_approvals -获取待批准的项目
• approve_bill -批准待处理的账单
• reject_bill -拒绝待处理的账单
• get_approval_history -获取对象的审批历史记录

预算（v3 API）

• search_budgets -搜索预算
• get_budget -通过UUID获取预算
• create_budget -创建新预算
• update_budget -更新预算

卡（v3 API）

• search_cards -搜索卡片
• get_card -通过UUID获取卡片
• create_virtual_card -创建虚拟卡
• freeze_card -冻结卡片
• unfreeze_card -解冻卡片

事务（v3 API）

• search_transactions -搜索卡交易
• get_transaction -按UUID获取交易
• update_transaction -更新交易（分类、添加备注）

报销（v3 API）

• search_reimbursements -搜索报销申请
• get_reimbursement -通过UUID获得报销
• create_reimbursement -创建报销申请
• approve_reimbursement -批准报销

筛选器运算符（v2 API）

v2 API搜索工具支持以下筛选器运算符：

示例用法

搜索活动供应商（v2 API）

{
  "filters": [
    { "field": "isActive", "op": "eq", "value": "1" }
  ]
}

按供应商搜索账单（v2 API）

{
  "filters": [
    { "field": "vendorId", "op": "eq", "value": "00000ABC123" }
  ],
  "sort": [
    { "field": "dueDate", "asc": true }
  ]
}

搜索卡（v3 API）

{
  "cardType": "virtual",
  "status": "active",
  "limit": 10
}

按日期范围搜索事务（v3 API）

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "limit": 50
}

认证

v2 AP API

• 使用基于会话的身份验证
• 会话是自动管理的
• 会话在35分钟不活动后过期
• 客户端在会话到期前自动刷新会话

v3支出和支出API

• 通过以下方式使用基于令牌的身份验证 apiToken 头球
• 无需会话管理
• 应从Bill.com支出和开支门户获得代币

故障排除

必须设置BILLCOM_USENAME、BILLCOM_PASSWORD、BILLCOM _ORG_ID和BILLCOM _DEV_KEY

您正在尝试在没有所需凭据的情况下使用v2 AP API功能。设置所有四个环境变量。

“必须在环境变量中为SPEND&Expense API访问设置BILLCOM_SPEND_API_TOKEN”

您正在尝试在没有API令牌的情况下使用v3支出和支出功能。集 BILLCOM_SPEND_API_TOKEN.

“花费API错误：401”

您的Spend API令牌无效或已过期。从Bill.com支出和费用门户生成新令牌。

许可证

麻省理工学院