mcp-zoop

@codespar/mcp-zoop

Zoop 向け MCP サーバー — 分配ルールに対応したマーケットプレイス決済

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

ツール（28）

ツール	用途
create_transaction	Zoop で取引を作成します（Pix、boleto、またはクレジットカード）
get_transaction	ID で取引の詳細を取得します
list_transactions	オプションのフィルターを指定して取引を一覧表示します
create_split_rule	販売者間で決済を分配するための分配ルールを作成します
create_seller	マーケットプレイスに販売者（個人または法人）を作成します
get_seller	ID で販売者の詳細を取得します
list_sellers	マーケットプレイスの販売者を一覧表示します
create_buyer	マーケットプレイスに購入者を作成します
get_balance	販売者またはマーケットプレイスの残高を取得します
create_transfer	販売者の銀行口座への振込を作成します
refund_transaction	取引の払い戻しを行います（全額または一部）
get_receivables	取引の売掛金を取得します
create_token_card	安全な決済のためにクレジットカードをトークン化します
create_bank_account	販売者の銀行口座トークンを作成します
get_seller_balance	特定の販売者の詳細な残高を取得します
update_seller	販売者情報を更新します
list_transfers	フィルターを指定してマーケットプレイスの振込を一覧表示します
get_transfer	ID で振込の詳細を取得します
create_subscription	定期購読を作成します
list_receivables	マーケットプレイスのすべての売掛金を一覧表示します
create_pix_payment	PIX 決済取引を作成します
get_pix_payment	QR コードとコピー＆ペースト用ペイロードを含む PIX 決済の詳細を取得します
cancel_subscription	定期購読をキャンセルします
list_subscriptions	マーケットプレイスの定期購読を一覧表示します
list_disputes	マーケットプレイスの異議申し立て／チャージバックを一覧表示します
get_marketplace	マーケットプレイスの情報と設定を取得します
get_dispute	ID で異議申し立ての詳細を取得します
get_subscription	ID で定期購読の詳細を取得します

認証

Zoop は、ユーザー名に API キー、パスワードに空の値を使用する Basic 認証を採用しています。

サンドボックス／テスト

Zoop は、ダッシュボードからアクセスできるサンドボックス環境を提供しています。

認証情報を取得する

1. Zoop Documentation にアクセスします
2. 開発者アカウントを作成します
3. ダッシュボードから API キーとマーケットプレイス ID を取得します
4. 環境変数を設定します

環境変数

変数	必須	説明
ZOOP_API_KEY	はい	Zoop ダッシュボードの API キー
ZOOP_MARKETPLACE_ID	はい	マーケットプレイス ID

ロードマップ

v0.2（予定）

• get_dispute — ID で異議申し立ての詳細を取得します
• respond_dispute — 証拠を添えて異議申し立てに回答します
• list_plans — すべての定期購読プランを一覧表示します
• update_subscription — 定期購読の詳細を更新します
• cancel_subscription — 有効な定期購読をキャンセルします

v0.3（予定）

• batch_transfers — 1 回のリクエストで複数の振込を処理します
• detailed_reports — 詳細な財務レポートを生成します
• webhook_management — Webhook の登録、一覧表示、削除を行います

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

リンク

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

エンタープライズ

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

ライセンス

MIT