mcp-asaas

@codespar/mcp-asaas

Asaas 用の MCP サーバー — Pix、boleto、クレジットカード決済による請求業務の自動化

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "asaas": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-asaas"],
      "env": {
        "ASAAS_API_KEY": "your-key",
        "ASAAS_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add asaas -- npx @codespar/mcp-asaas

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "asaas": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-asaas"],
      "env": {
        "ASAAS_API_KEY": "your-key",
        "ASAAS_SANDBOX": "true"
      }
    }
  }
}

ツール（24）

ツール	説明
create_payment	Asaas で決済を作成します（Pix、boleto、またはクレジットカード）。分割払いにするには、billingType: CREDIT_CARD とともに installments（>=2）を渡します。均等な月払いになります
get_payment	ID で決済の詳細を取得します
list_payments	任意のフィルターを指定して決済を一覧表示します
get_pix_qrcode	決済用の Pix QR コードを取得します（ペイロードと画像を返します）
get_boleto	決済用の boleto の入力可能行とバーコードを取得します
create_customer	Asaas に顧客を作成します
list_customers	任意のフィルターを指定して顧客を一覧表示します
create_subscription	定期購読を作成します
get_balance	現在のアカウント残高を取得します
list_subscriptions	任意のフィルターを指定して定期購読を一覧表示します
cancel_subscription	ID で定期購読をキャンセルします
get_webhook_events	Webhook イベント（決済確認、送金など）を一覧表示します
create_subaccount	決済分割用のサブアカウントを作成します
get_installments	id で既存の決済の分割払い詳細を取得するか、id を指定せずに value と installments を渡して仮の支払いスケジュールをプレビューします
create_transfer	銀行振込（Pix 送金または TED）を作成します
create_pix_qrcode	決済受け取り用の静的な PIX QR コードを生成します
list_transfers	任意のフィルターを指定して送金を一覧表示します
create_notification	Webhook 通知設定を作成します
list_notifications	Webhook 通知設定を一覧表示します
get_customer	ID で顧客の詳細を取得します
update_payment	保留中の決済を更新します
delete_payment	ID で決済を削除します
refund_payment	受領済みの決済を返金します
get_subscription	ID で定期購読の詳細を取得します

認証

Asaas では、access_token ヘッダーで API キーを渡します。Asaas ダッシュボードからキーを生成できます。

サンドボックス／テスト

Asaas は sandbox.asaas.com で完全なサンドボックス環境を提供しています。使用するには ASAAS_SANDBOX=true を設定します。

認証情報を取得する

1. Asaas にアクセスします
2. アカウントを作成するか、sandbox.asaas.com でサンドボックスに登録します
3. Integracoes > API に移動し、API キーを生成します
4. ASAAS_API_KEY 環境変数を設定します

環境変数

変数	必須	説明
ASAAS_API_KEY	はい（デモモードを除く）	Asaas ダッシュボードの API キー
ASAAS_SANDBOX	いいえ	サンドボックスモードを使用するには "true" を設定します
MCP_DEMO	いいえ	状態を保持するデモモードのフィクスチャを使用するには "true" を設定します（コマンドラインで --demo を渡すのと同じです）。API キーは不要です

デモモード

--demo フラグを渡す（または MCP_DEMO=true を設定する）と、すべてのツールが実際の Asaas API を呼び出す代わりに、決定的なフィクスチャ応答を返します。サンドボックスの認証情報を消費せずに、エージェントを構築、テストする場合に便利です。

create_payment と get_installments のデモハンドラーは状態を保持します。create_payment は呼び出しごとに異なる ID（pay_demo_001、pay_demo_002、…）を発行し、billingType: CREDIT_CARD + installments >= 2 + value > 0 で呼び出された場合、分割払いのスケジュールをプロセス内の台帳に記録します。その後、その ID を指定して get_installments({ id }) を呼び出すと、記録されたスケジュールが返されます。get_installments はプレビューにも対応しています。id を指定せずに value と installments を渡すと、支払いを作成せずに仮のスケジュール（status: "PREVIEW"、preview: true）を返します。その他のツールは静的なフィクスチャペイロードを返します。

# Start the server in demo mode (no key required):
npx -y @codespar/mcp-asaas --demo

ロードマップ

v0.2（予定）

• list_subscriptions — フィルターを使って、すべての定期サブスクリプションを一覧表示します
• cancel_subscription — 有効なサブスクリプションをキャンセルします
• get_webhook_events — インテグレーションのデバッグ用に、Webhook イベントを一覧表示します
• create_subaccount — マーケットプレイスの分割用にサブアカウントを作成します
• get_installments — 支払いの分割払いの詳細を取得します

v0.3（予定）

• create_anticipation — 売掛金の早期入金をリクエストします
• get_fiscal_info — 支払いの税務情報を取得します
• batch_payments — 1 回のリクエストで複数の支払いを作成します

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• Asaas のウェブサイト
• Asaas API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT