Frisbii Transform (billwerk) Mcp

Frisbii Transform MCP 服务

一个模型上下文协议（MCP）服务，提供用于与 Frisbii Transform 订阅和计费 API 交互的工具。

功能

此 MCP 服务提供以下工具：

• 客户管理：创建、检索、更新和删除客户
• 合同管理：管理订阅合同及其生命周期
• 组件订阅：处理基于组件的订阅
• 用量跟踪：管理按量计费的用量数据
• 发票操作：创建、检索和管理发票
• 支付处理：处理付款和退款
• 折扣管理：管理折扣订阅
• 计划管理：访问计划组、计划和计划变体
• 报告生成：生成各种业务报告
• Webhook 管理：Webhook 配置和事件监控
• OAuth2 管理：内置身份验证状态和令牌管理工具

安装

pip install -e .

配置

将此服务添加到 MCP 客户端配置中（例如 Claude Desktop）。选择以下一种身份验证方式：

OAuth2 身份验证（推荐）

{
  "mcpServers": {
    "frisbii-transform": {
      "command": "python",
      "args": ["-m", "frisbii_transform_mcp.server"],
      "env": {
        "FRISBII_BASE_URL": "https://app.billwerk.com",
        "FRISBII_OAUTH2_CLIENT_ID": "your_client_id",
        "FRISBII_OAUTH2_CLIENT_SECRET": "your_client_secret",
        "FRISBII_OAUTH2_TOKEN_URL": "https://app.billwerk.com/oauth/token",
        "FRISBII_OAUTH2_SCOPE": "api"
      }
    }
  }
}

设置要求：

1. 在 Billwerk+ Transform 设置中创建 OAuth2 客户端凭据
2. **重要：**请使用专用客户端凭据，避免共享管理界面凭据
3. 此方式支持自动令牌管理和刷新

Bearer 令牌身份验证

{
  "mcpServers": {
    "frisbii-transform": {
      "command": "python",
      "args": ["-m", "frisbii_transform_mcp.server"],
      "env": {
        "FRISBII_BASE_URL": "https://app.billwerk.com",
        "FRISBII_API_KEY": "your_api_key"
      }
    }
  }
}

可选：法律实体 ID

如需访问多个实体，请将法律实体 ID 添加到环境配置中：

"env": {
  "FRISBII_LEGAL_ENTITY_ID": "your_legal_entity_id",
  // ... other environment variables
}

注意：FRISBII_LEGAL_ENTITY_ID 是可选的。大多数单实体 Billwerk 客户可省略此设置。

环境端点

• 生产环境：https://app.billwerk.com
• 沙盒环境：https://sandbox.billwerk.com

OAuth2 设置的详细说明请参阅 OAUTH2_SETUP.md。

OAuth2 管理工具

此服务内置了 OAuth2 管理工具：

• oauth2_status：检查身份验证状态、令牌有效性和配置
• oauth2_refresh_token：强制刷新 OAuth2 令牌
• oauth2_clear_token：清除已存储的 OAuth2 令牌

开发

此项目使用以下组件构建：

• FastMCP，用于 MCP 服务框架
• httpx，用于 HTTP 客户端操作
• Pydantic，用于数据验证

许可证

MIT 许可证