mcp-flow-cl

@codespar/mcp-flow-cl

Flow（flow.cl）向け MCP サーバー — チリ発の PSP です。1 つのホスト型決済注文で、Webpay（クレジット／デビット）、ETpay 銀行振込、現金決済ネットワーク、海外発行カードに対応します。返金にも対応しています。すべての API 呼び出しに HMAC-SHA256 署名を付与します。

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "flow-cl": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-flow-cl"],
      "env": {
        "FLOW_API_KEY": "your-flow-api-key",
        "FLOW_SECRET_KEY": "your-flow-secret-key",
        "FLOW_ENV": "sandbox"
      }
    }
  }
}

Claude Code

claude mcp add flow-cl --env FLOW_API_KEY=... --env FLOW_SECRET_KEY=... -- npx -y @codespar/mcp-flow-cl

Cursor / VS Code

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

ツール（8 個）

ツール	エンドポイント	機能
create_payment	POST /payment/create	ホスト型決済注文を作成し、顧客が支払いを行う url + token を返します
create_payment_by_email	POST /payment/createEmail	Flow が顧客に決済リンクをメールで送信します
get_payment_status	GET /payment/getStatus	Flow トークンでステータスを取得します（1 は保留中、2 は支払い済み、3 は拒否、4 はキャンセル済み）
get_payment_status_by_commerce_id	GET /payment/getStatusByCommerceId	commerceOrder でステータスを取得します
get_payment_status_by_flow_order	GET /payment/getStatusByFlowOrder	Flow の注文番号でステータスを取得します
list_payments	GET /payment/getPayments	指定日の受領済み支払いを一覧表示します（ページ分割）
create_refund	POST /refund/create	全額または一部返金の注文を作成します
get_refund_status	GET /refund/getStatus	返金トークンで返金ステータスを取得します

認証

Flow はすべてのリクエストに署名します。パラメーターをアルファベット順に並べ、name+value として連結し、secretKey を使用して HMAC-SHA256 で署名します。このサーバーが署名を代行するため、2 つの環境変数を設定し、通常の引数でツールを呼び出すだけで使えます。

変数	必須	説明
FLOW_API_KEY	はい	Flow の加盟店 API キー
FLOW_SECRET_KEY	はい	HMAC 署名用シークレット（通信で送信されることはありません）
FLOW_ENV	いいえ	sandbox（デフォルト）または production

サンドボックス：sandbox.flow.cl に登録してください。サンドボックス専用のキーとシークレットが発行されます。

例

「CLP 25,000 の Flow 決済注文を作成してください。件名は「Plan Pro mensual」、メールアドレスは [email protected] で、決済リンクも教えてください。」

エージェントが create_payment を呼び出し、url?token=... を返します。顧客は Flow のホスト型ページで Webpay、ETpay、または現金決済を選択します。

エンタープライズ

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

マネージドプラン

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

ライセンス

MIT