Frisbii Transform (billwerk) Mcp

Frisbii Transform MCP サーバー

Frisbii Transform のサブスクリプションおよび請求 API と連携するツールを提供する、Model Context Protocol（MCP）サーバーです。

機能

この 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. 重要： 専用のクライアント認証情報を使用し、Admin UI の認証情報は共有しないでください
3. この方法では、トークンの自動管理と更新が可能です

ベアラートークン認証

{
  "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 トークンを消去します

開発

このプロジェクトは、次のものを使用して構築されています。

• MCP サーバーフレームワークの FastMCP
• HTTP クライアント操作の httpx
• データ検証の Pydantic

ライセンス

MIT ライセンス