mcp-iugu

@codespar/mcp-iugu

iugu の MCP サーバー — 請求書、サブスクリプション、決済管理

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "iugu": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-iugu"],
      "env": {
        "IUGU_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "iugu": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-iugu"],
      "env": {
        "IUGU_API_TOKEN": "your-token"
      }
    }
  }
}

ツール（23）

ツール	目的
create_invoice	iugu で請求書を作成します（Pix、boleto、またはクレジットカード）
get_invoice	ID を指定して請求書の詳細を取得します
list_invoices	オプションのフィルターを指定して請求書を一覧表示します
cancel_invoice	請求書をキャンセル（削除）します。
refund_invoice	支払い済みの請求書を全額または一部返金します。
duplicate_invoice	新しい期日を設定して既存の請求書を複製します。
create_customer	iugu に顧客を作成します
update_customer	顧客情報を更新します。
list_customers	オプションのフィルターを指定して顧客を一覧表示します
create_plan	サブスクリプションプラン（定期課金テンプレート）を作成します。
update_plan	既存のプランを更新します。
list_plans	サブスクリプションプランを一覧表示します。
create_subscription	iugu で定期サブスクリプションを作成します
suspend_subscription	サブスクリプションを一時停止します。
activate_subscription	一時停止中のサブスクリプションを再開します。
cancel_subscription	サブスクリプションをキャンセル（削除）します。
create_payment_token	サーバーサイドでクレジットカードをトークン化します。
create_payment_method	決済方法（クレジットカードのトークン）を顧客に紐付けます。
create_subaccount	マーケットプレイスのサブアカウントを作成します。
create_transfer	iugu アカウント間で資金を移動します（マーケットプレイス）。
request_withdraw	サブアカウントから銀行口座への出金（saque）を申請します。
create_webhook	iugu のイベント用に webhook（gatilho）を登録します。
get_account_info	アカウント情報、設定、残高を取得します

認証

iugu は、API トークンをユーザー名、空のパスワードを使用する Basic Auth を採用しています。

サンドボックス／テスト

iugu ではダッシュボードからテストモードを利用できます。実際の課金を避けるため、テストモード用の API トークンを使用してください。

認証情報の取得

1. iugu Developer Portal にアクセスします
2. アカウントを作成してダッシュボードにアクセスします
3. テストモードに切り替えて API トークンを生成します
4. IUGU_API_TOKEN 環境変数を設定します

環境変数

変数	必須	説明
IUGU_API_TOKEN	はい	iugu ダッシュボードの API トークン
IUGU_SANDBOX	いいえ	テストモードの場合は "true" に設定します

ロードマップ

v0.3（予定）

• create_split — 分割決済ルールを作成します
• list_transfers — マーケットプレイスの送金を一覧表示します
• get_financial_report — 財務サマリーレポートを取得します
• batch_invoices — 1 回のリクエストで複数の請求書を作成します
• list_payment_methods — 顧客に保存されている決済方法を一覧表示します

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

リンク

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

エンタープライズ

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

ライセンス

MIT