mcpField
M
mcp-clearsale

mcp-clearsale

ローカル
github.com/codesparセキュリティ2755 週間前に更新
リポジトリ

mcp-clearsale について

mcp-clearsale は、ブラジルの不正検知サービスプロバイダーである ClearSale の MCP サーバーです。ブラジルの ECサイト事業者を対象に、注文のリスクスコアリング、デバイスフィンガープリント、KYC 検証をツールとして提供します。分析、判断、フィードバックの流れに沿って利用します。

主な機能

  1. 01注文の不正分析とリスクスコアリング
  2. 02デバイスフィンガープリントセッションと行動イベント記録
  3. 03CPF、CNPJ、住所の KYC 検証
  4. 04手動審査の解決とチャージバック通知
  5. 05不正調査ケースの作成と更新

活用シーン

  1. 01出荷前にチェックアウトの注文を不正分析へ送信
  2. 02スコアに基づく承認、拒否、手動審査の判断
  3. 03最終判断とチャージバック情報を返してモデルを改善

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-clearsale": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-clearsale"
      ],
      "env": {
        "CLEARSALE_API_KEY": "<CLEARSALE_API_KEY>",
        "CLEARSALE_BASE_URL": "<CLEARSALE_BASE_URL>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-clearsale
設定が必要な環境変数
CLEARSALE_API_KEYシークレットClearSale API key / bearer token used in the Authorization header
CLEARSALE_BASE_URLClearSale API base URL. Defaults to https://api.clearsale.com.br (prod). Override per contract-issued staging URL.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-clearsale0.2.0-alpha.3

ツール

18

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
idstringはい加盟店側の注文 ID（後続のステータス更新やチャージバックとの関連付けに使用するため、一意で安定している必要があります）
ipstringはい注文時の購入者の IP アドレス（IPv4 または IPv6）
datestringはい注文作成日時のタイムスタンプ（ISO-8601 形式、例：2026-04-21T14:32:00Z）
emailstringはい購入者のメールアドレス
itemsarrayはい注文明細：各項目に sku、name、category、quantity、unit_price を含めます。
paymentarrayはいこの注文で使用された1つ以上の支払い方法（card、boleto、pix）。カード情報は必ずトークン化してください。生の PAN を渡さないでください。
session_idstringいいえcreate_device_fingerprint_session から取得する任意のデバイスフィンガープリント session_id。判定の質が大幅に向上します。
total_itemsnumberはい注文内の商品数
total_ordernumberはいBRL 建ての注文合計金額（基本単位、例：199.90）
customer_billingobjectはい請求先顧客：name、document（CPF/CNPJ）、birth_date、phone、および住所フィールド（street、number、city、state、zip_code）。
customer_shippingobjectはい配送先顧客：name、document、phone、および住所フィールド。customer_billing と同じスキーマです。

詳細

@codespar/mcp-clearsale

ClearSale 用の MCP サーバー — ブラジルの不正防止サービスです。

ClearSale はブラジルの不正分析を先駆けて開始し（2001 年、サンパウロで創業）、現在もブラジルの大手 EC サイトの多くで標準的な不正対策レイヤーとして利用されています。これは CodeSpar の fraud カテゴリーにおける最初のエントリーです。カタログ内で不正スコアリングを行うサーバーはほかにありません。今後、Konduto、Legiti、Sift、Cybersource が同じ「分析 → 決定 → フィードバック」の流れに沿って追加される予定です。

ツール（18）

ツール目的
send_order_for_analysis不正分析のため、注文を ClearSale に送信します。
get_order_analysisClearSale に送信済みの注文について、現在の分析状況を取得します。
update_order_status注文に対する販売事業者の最終判断（APROVADO／CANCELADO／DEVOLVIDO）を ClearSale に通知します。
list_ordersオプションのフィルターを指定して、ClearSale に送信済みの注文を一覧表示します。
create_chargeback_notification確定したチャージバックを ClearSale に報告します。
get_order_score注文の不正スコア（数値 0～100）のみを取得します。
create_device_fingerprint_sessionデバイスフィンガープリントのセッションを開始します。
get_device_fingerprintフィンガープリントセッションで取得したデバイスの特徴（OS、ブラウザー、タイムゾーン、Canvas／WebGL など）を取得します。
resolve_manual_review現在 EM_ANALISE の注文について、承認または却下して手動で解決します。
get_score_by_documentブラジルの身分証明書番号（CPF または CNPJ）に関連するリスクスコアと過去のシグナルを照会します。
get_score_by_contact連絡先識別子（メールアドレスまたは電話番号）のリスクスコアを照会します。
validate_documentKYC：CPF または CNPJ を Receita Federal に照会して検証します。
validate_addressKYC：ブラジルの郵便住所を Correios のデータベースに照会して検証します。
track_behavior_eventフィンガープリントセッションに関連付けて、行動シグナル（ページ閲覧、ログイン、登録、カスタムイベント）を記録します。
issue_challenge購入者に認証チャレンジ（SMS／メールによる OTP または KBA の質問）を発行します。
validate_challenge_responseissue_challenge で発行したチャレンジに対する購入者の回答を検証します。
create_case不正調査ケースを作成します（例：
update_case既存の不正調査ケースを更新します — ステータスの変更、メモの追加、再割り当て、または注文の追加を行います。

インストール

npm install @codespar/mcp-clearsale@alpha

環境

CLEARSALE_API_KEY="..."    # Bearer token issued by ClearSale
CLEARSALE_BASE_URL="..."   # Optional. Defaults to https://api.clearsale.com.br. Override per contract-issued staging URL.

認証

サーバー側の Bearer トークン：

Authorization: Bearer <CLEARSALE_API_KEY>

ClearSale は、開発者ポータルまたは商業契約を通じてトークンを発行します。公開サンドボックスはありません。ステージング URL は契約ごとに提供されます。CLEARSALE_BASE_URL を上書きして、その URL を指定してください。

一般的なフロー

  1. ページの読み込み時に、販売事業者は create_device_fingerprint_session を呼び出し、返された session_token を使って ClearSale のブラウザー JS を埋め込みます。
  2. チェックアウト時に、販売事業者は同じ session_id と、注文、決済、商品、請求先／配送先の全データを指定して send_order_for_analysis を呼び出します。
  3. レスポンスには判定が含まれます：APROVADO（発送）、REPROVADO（ブロック）、または EM_ANALISE（get_order_analysis をポーリングするか、Webhook を待機）。
  4. 注文のライフサイクル完了後、販売事業者の最終判断を指定して update_order_status を呼び出します。これはモデルの品質を維持するために必須です。
  5. 後日チャージバックが発生した場合は、create_chargeback_notification を呼び出して ClearSale がモデルを調整できるようにします。

実行

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

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

カテゴリー

fraud — CodeSpar のこのカテゴリーで最初のサーバーです。不正対策サーバーは「分析 → 決定 → フィードバック」という共通の流れを持ち、決済とは異なるため、取得銀行間の切り替えよりもプロバイダー間（ClearSale ↔ Konduto ↔ Legiti）の切り替えが容易です。

エンタープライズ

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

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。