mcp-pomelo

@codespar/mcp-pomelo

Pomelo 向け MCP サーバー — 中南米全域を対象とするカード発行サービスです。カード保有者ユーザー、バーチャルカードと物理 Visa／Mastercard の発行、ライフサイクル管理、取引フィードに対応しています。アルゼンチン、ブラジル、メキシコ、コロンビア、ペルー、チリ。

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "pomelo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pomelo"],
      "env": {
        "POMELO_CLIENT_ID": "your-client-id",
        "POMELO_CLIENT_SECRET": "your-client-secret",
        "POMELO_ENV": "sandbox"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "pomelo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pomelo"],
      "env": {
        "POMELO_CLIENT_ID": "your-client-id",
        "POMELO_CLIENT_SECRET": "your-client-secret",
        "POMELO_ENV": "sandbox"
      }
    }
  }
}

環境変数

変数	必須	説明
POMELO_CLIENT_ID	はい	OAuth2 クライアント ID
POMELO_CLIENT_SECRET	はい	OAuth2 クライアントシークレット
POMELO_ENV	いいえ	sandbox（デフォルト）または production
POMELO_BASE_URL	いいえ	API ベース URL の上書き（デフォルトは sandbox で https://api-stage.pomelo.la、production で https://api.pomelo.la）
POMELO_AUTH_URL	いいえ	認証ベース URL の上書き。トークンの呼び出し先は {AUTH_URL}/oauth/token です（デフォルトは Pomelo のドキュメントに従い、API と同じホストです）
POMELO_AUDIENCE	いいえ	OAuth2 audience の上書き（デフォルトは環境ごとに設定されます）

認証には OAuth2 クライアントクレデンシャルを使用します。サーバーが Bearer トークンを自動的に取得し、キャッシュします。

ツール（9）

ツール	機能
create_user	カード保有者の ID を作成します（POST /users/v1）
get_user	ID を指定してユーザーを取得します
update_user	ユーザーのフィールド（ステータス、連絡先、住所）を更新します
create_card	VIRTUAL または PHYSICAL カードを発行します（POST /cards/v1）
get_card	カードを取得します（マスク済み PAN、ステータス、プログラム）
list_cards	カードを一覧表示します。ユーザー／ステータスで絞り込めます
update_card_status	ライフサイクルのステータスを ACTIVE／BLOCKED／DISABLED に変更します
list_transactions	カード取引フィードを検索します
get_transaction	ID を指定して取引を取得します

データを変更する呼び出しには x-idempotency-key が付与されます（自動生成されますが、呼び出しごとに idempotency_key で上書きできます）。

使用例

「新しい契約社員用のバーチャルカードを発行して、古いカードを凍結してください。」

エージェントは create_user（必要な場合）→ create_card（card_type: "VIRTUAL"）→ update_card_status（status: "BLOCKED"、status_reason: "CLIENT_INTERNAL_REASON"）を呼び出します。

注意事項

• これらのツールからカード認証情報（完全な PAN／CVV）が返されることはありません。Pomelo は PCI スコープのウィジェットを通じてのみ機密データを公開します。
• 認証の判定（スワイプごとのリアルタイム承認）は、ホストする Webhook で行われるものであり、API 呼び出しではありません。取引ごとに利用制限を確認する場合は、このサーバーと CodeSpar のガバナンス対応オーソライザーを組み合わせてください。

認証

OAuth2 クライアントクレデンシャルを使用します。サーバーは {AUTH_URL}/oauth/token で POMELO_CLIENT_ID／POMELO_CLIENT_SECRET を Bearer トークンと交換し、有効期限が切れる少し前までキャッシュします。データを変更する呼び出しには x-idempotency-key が付与されます。

エンタープライズ

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

ライセンス

MIT