AI导哈

Stripe计费代理服务

Agent Billy MCP Server是一个本地MCP代理，为AI助手（如Claude、Cursor、Copilot）提供通过Billy容器API安全、基于角色的Stripe计费访问。

  • by Agent-Billy
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Agent-Billy/mcp

使用说明

代理Billy MCP服务器

本地MCP代理，通过Billy容器API为AI助手（Claude、Cursor、Copilot）提供对Stripe账单的安全、基于角色的访问。

快速开始

npx agent-billy --api-url https://yourorg.agentbilly.ai --api-key billy_your-api-key

或者使用环境变量：

export BILLY_API_URL=https://yourorg.agentbilly.ai
export BILLY_API_KEY=billy_your-api-key
npx agent-billy

MCP配置

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "agent-billy": {
      "command": "npx",
      "args": ["-y", "agent-billy"],
      "env": {
        "BILLY_API_URL": "https://yourorg.agentbilly.ai",
        "BILLY_API_KEY": "billy_your-api-key"
      }
    }
  }
}

配置文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

克劳德代码

claude mcp add agent-billy \
  -e BILLY_API_URL=https://yourorg.agentbilly.ai \
  -e BILLY_API_KEY=billy_your-api-key \
  -- npx -y agent-billy

光标

首选 设置>MCP服务器>添加新的MCP服务器 并输入：

{
  "command": "npx",
  "args": ["-y", "agent-billy"],
  "env": {
    "BILLY_API_URL": "https://yourorg.agentbilly.ai",
    "BILLY_API_KEY": "billy_your-api-key"
  }
}

VS代码（GitHub副本）

添加到您的 settings.json:

{
  "mcp": {
    "servers": {
      "agent-billy": {
        "command": "npx",
        "args": ["-y", "agent-billy"],
        "env": {
          "BILLY_API_URL": "https://yourorg.agentbilly.ai",
          "BILLY_API_KEY": "billy_your-api-key"
        }
      }
    }
  }
}

认证

从Billy仪表板生成API密钥：

  1. 登录地址： https://yourorg.agentbilly.ai
  2. 首选 设置>API密钥
  3. 点击 生成密钥 并选择一个角色
  4. 复制密钥并将其用作您的 BILLY_API_KEY

API键继承您在创建它们时分配的角色。计费员密钥只能执行计费员操作。可以随时从设置中撤销密钥。

可用工具

阅读工具

工具 说明
billy_list_charges 列出最近的指控。按状态筛选（成功、失败、待定）。
billy_get_charge 通过Stripe费用ID获取特定费用的详细信息
billy_list_customers 按页码列出客户。
billy_get_customer 通过Stripe客户ID获取特定客户的详细信息
billy_list_subscriptions 列出订阅。按状态筛选（活动、过期、取消、试用）。
billy_list_invoices 列出发票。按状态筛选（草稿、未结、已付款、无效、无法收回）。
billy_list_refunds 列出已发放的所有退款。
billy_get_stats 仪表板快照：MTD收入、成功率、活跃用户、失败费用。
billy_search 按关键字搜索客户、费用、订阅和发票。

写入工具

工具 说明
billy_create_refund 全额或部分退还费用
billy_create_customer 创建新的Stripe客户。
billy_update_customer 更新客户的电子邮件、姓名、描述或元数据。
billy_cancel_subscription 取消订阅（在期限结束时或立即）。
billy_reactivate_subscription 重新激活尚未完全过期的已取消订阅。
billy_send_invoice 通过电子邮件向客户发送发票。
billy_void_invoice 作废发票，使其无法再支付。
billy_create_coupon 创建折扣券（百分比或固定金额）。
billy_delete_coupon 删除优惠券，使其无法应用于新客户。

基于角色的访问

所有权限都在服务器端强制执行。API键继承了创建它的用户的角色。

角色 阅读 退款 管理子订单 发票 客户 优惠券
所有者 全部 无限 满 满 全 满
账单管理器 全部 最高5000美元 全额 全额 全部 全额
票据文员 全部 最高100美元 仅限查看 仅限浏览 仅限更新 否
只读 全部 否 否 不 否

支出限额

退款限额按每笔交易、每个角色执行：

  • 业主： 无限
  • 计费经理： 每次退款5000美元
  • 计费员： 每次退款100美元
  • 只读： 无法退款

试图超出限制将返回权限错误。该操作记录在审计跟踪中。

CLI选项

agent-billy --api-url <url> --api-key <key>

Options:
  --api-url   Billy container API URL (or BILLY_API_URL env var)
  --api-key   API key (or BILLY_API_KEY env var)
  --token     JWT auth token, alternative to api-key (or BILLY_TOKEN env var)
  --help, -h  Show help

链接

相关 MCP