mcp-konduto

@codespar/mcp-konduto

Konduto 用の MCP サーバーです。API ファーストのブラジル向け不正防止サービスです。

CodeSpar の fraud カテゴリーでは、@codespar/mcp-clearsale に続く2つ目のエントリーです。Konduto は ClearSale と並び、ブラジルの加盟店が標準的な不正対策レイヤーとして評価する2つのサービスの1つです。スコア比較やフェイルオーバーを目的に、両方を並行して導入するケースもよくあります。

ClearSale との位置付けの違い

	ClearSale	Konduto
創業	2001年（サンパウロ）	2014年（サンパウロ）
強み	より大規模なチャージバック履歴データベース	行動に基づくデバイスインテリジェンス
特徴	ML スコアリング＋手動審査サービス	API ファースト、機能範囲が絞られ、開発者向け
主な導入先	ブラジルの大手小売で標準的	デジタルネイティブなブラジルの EC で標準的

加盟店は通常、両方を並行して稼働させます。Konduto は迅速な行動シグナルに、ClearSale は長期にわたるチャージバック履歴に使用します。一方が review、もう一方が approved と判定した場合、加盟店は注文を手動審査に回します。

ツール（18）

ツール	用途
send_order_for_analysis	不正分析のため、注文を Konduto に送信します。
get_order	注文の現在の分析状態を取得します。
update_order_status	注文の最終的な加盟店側のステータスを Konduto に通知します。
report_chargeback	注文について、確定したチャージバックを報告します。
report_order_approved	加盟店が最終的に注文を承認したことを報告します。
report_order_declined	加盟店が最終的に注文を拒否したことを報告します。
add_to_blocklist	Konduto のブロックリストに値を追加します。
query_blocklist	値が現在 Konduto のブロックリストに登録されているか確認します。
update_blocklist_entry	既存のブロックリストエントリーを更新します。通常、有効期限（expires_at）の延長または短縮に使用します...
remove_from_blocklist	Konduto のブロックリストから値を削除します。
add_to_allowlist	Konduto の許可リスト（信頼済み）に値を追加します。
query_allowlist	値が現在 Konduto の許可リストに登録されているか確認します。
update_allowlist_entry	既存の許可リストエントリーを更新します。通常、有効期限の延長または短縮に使用します。
remove_from_allowlist	Konduto の許可リストから値を削除します。
add_to_reviewlist	Konduto の審査リストに値を追加します。
query_reviewlist	値が現在 Konduto の審査リストに登録されているか確認します。
update_reviewlist_entry	既存の審査リストエントリーを更新します。通常、削除せずに有効期限を延長または短縮するために使用します...
remove_from_reviewlist	Konduto の審査リストから値を削除します。

インストール

npm install @codespar/mcp-konduto@alpha

環境変数

KONDUTO_API_KEY="T00000..."          # private key; required
KONDUTO_BASE_URL="..."               # optional; defaults to https://api.konduto.com/v1

認証

HTTP Basic 認証です。API キーをユーザー名として指定し、パスワードは空にします。

Authorization: Basic base64(KONDUTO_API_KEY + ":")

サーバーが base64 エンコードを処理するため、KONDUTO_API_KEY には生のキーを渡してください。

一般的なフロー

1. 加盟店のチェックアウトページに Konduto のブラウザー JS SDK を埋め込みます。これにより、visitor ID（行動およびデバイスのシグナル）が取得されます。
2. 注文送信時に、注文データ全体と visitor ID を指定して send_order_for_analysis を呼び出します。
3. 応答に応じて処理します。approved なら発送し、declined ならブロックし、review なら手動審査または ClearSale からの追加シグナルを待ちます。
4. 注文のライフサイクルが完了したら、approved／canceled／fraud を指定して update_order_status を呼び出します。これにより Konduto のモデルに情報がフィードバックされます。
5. チャージバックが確定したら、ステータス fraud を指定して update_order_status を呼び出します。これが Konduto の主要な ML フィードバックチャネルです（公開ドキュメントには独立した /chargebacks エンドポイントはありません）。
6. 確定した不正で確認された特定のメールアドレス／IP アドレス／カード BIN と末尾4桁の組み合わせを恒久的にブロックするには、add_to_blocklist を使用します。

アルファ版に関する注記

このパッケージは 0.1.0-alpha.1 としてリリースされます。元の概要とのスコープの違いは次のとおりです。

• docs.konduto.com に照らして検証済み：

  • POST /orders（send_order_for_analysis）
  • POST/GET/DELETE /blacklist/{type}（ブロックリスト関連）
  • /whitelist/{type}（許可リスト）および /greylist/{type}（審査リスト）。「APIs de Blocklist, Allowlist e Reviewlist」の下に掲載されています。

• 標準的な REST パターンですが、公開リファレンスには個別に掲載されていません（Konduto の公式クライアントライブラリで使用）：

  • GET /orders/{id}（get_order）
  • PUT /orders/{id}（update_order_status）

• 削除 — 公開ドキュメントに記載なし：

  • POST /disputes — docs.konduto.com に異議申し立てを送信するエンドポイントはありません。
  • POST /cards/analyze — カードのみを対象とする事前チェック用エンドポイントはドキュメントに記載されていません。
  • GET /visitors/{visitor_id} — ビジター ID は注文の visitor フィールドで参照されますが、公開取得エンドポイントはありません。

チャージバックのフィードバックは、Konduto がドキュメントで案内しているフィードバック手段である status: fraud を使った update_order_status に統合されています。

削除したエンドポイントが確認できた場合（非公開ドキュメントまたは API への直接リクエストによる）、または Konduto がより広範な公開リファレンスを公開した時点で、0.2.0 に更新してください。

実行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-konduto

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-konduto

カテゴリー

fraud — この CodeSpar カテゴリーでは、ClearSale に続く 2 つ目のサーバーです。不正検知サーバーは、決済とは異なる共通の構成（分析 → 判定 → フィードバック）を持つため、異なるアクワイアラー間で切り替えるよりも、プロバイダー間（ClearSale ↔ Konduto ↔ Legiti）での切り替えが容易です。

エンタープライズ

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

ライセンス

MIT