mcp-niubiz

@codespar/mcp-niubiz

Niubiz（旧VisaNet Perú）向けのMCP サーバーです。ペルー最大のカードアクワイアラーで、加盟店は30万社以上です。実際のEC決済フロー（セキュリティトークン → チェックアウトセッション → オーソリゼーション）に加え、当日中の取消にも対応しています。

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "niubiz": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-niubiz"],
      "env": {
        "NIUBIZ_USER": "your-api-user",
        "NIUBIZ_PASSWORD": "your-api-password",
        "NIUBIZ_MERCHANT_ID": "your-merchant-id",
        "NIUBIZ_ENV": "sandbox"
      }
    }
  }
}

Claude Code

claude mcp add niubiz --env NIUBIZ_USER=... --env NIUBIZ_PASSWORD=... --env NIUBIZ_MERCHANT_ID=... -- npx -y @codespar/mcp-niubiz

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に同じブロックを追加します。

ツール（4）

ツール	エンドポイント	機能
get_security_token	POST /api.security/v1/security	ベアラートークン（20分間キャッシュされます。他のツールでは自動取得されます）
create_session_token	POST /api.ecommerce/v2/ecommerce/token/session/{merchantId}	金額と不正利用防止データを含むチェックアウトセッション
authorize_transaction	POST /api.authorization/v3/authorization/ecommerce/{merchantId}	チェックアウトの transactionToken を使ってオーソリゼーションを実行します
reverse_transaction	POST /api.authorization/v3/reverse/ecommerce/{merchantId}	オーソリゼーションを当日中に取り消します

Niubiz のフロー

カードデータがこのサーバーに渡ることはありません。顧客はNiubiz独自のチェックアウトフォームにカード情報を入力します（フォームには create_session_token でデータを渡します）。フォームから transactionToken が返され、authorize_transaction で購入が完了します。これがNiubiz標準の3ステップのEC決済連携です。

認証

変数	必須	説明
NIUBIZ_USER	はい	APIユーザー
NIUBIZ_PASSWORD	はい	APIパスワード
NIUBIZ_MERCHANT_ID	はい	加盟店ID（código de comercio）
NIUBIZ_ENV	いいえ	sandbox（デフォルト）または production

エンタープライズ

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

マネージドプラン

このオープンソースサーバーは、お客様の認証情報を使ってNiubizのAPIを直接呼び出します。CodeSparのマネージドプランでは、自動フェイルオーバー、ガバナンス、監査、認証情報保管庫を備えた単一のインターフェースで、LATAMのすべてのプロバイダーに接続できます：codespar.dev/agents。

ライセンス

MIT