Fraudlabs Pro

FraudLabs Pro MCP Server

FraudLabs Pro の不正検知システムを、Claude Desktop などの AI アシスタントに統合する、MCP に準拠したサーバーです。このサーバーにより、注文の取引やユーザー関連イベント（ログインや登録など）をリアルタイムで審査し、不正行為を特定して防止できます。

特長

• 注文審査：IP アドレス、請求先／配送先の詳細、クレジットカード情報を使用して、e コマースの注文を検証します。

• ユーザー審査：アカウントレベルのイベント（登録／ログイン）を分析し、不審なパターンを検出します。

• 取引管理：注文やユーザー審査の過去の結果を取得します。

• フィードバックループ：AI インターフェースから取引を承認、拒否、またはブラックリストに登録し、検知エンジンの精度を向上させます。

前提条件

• Python 3.10 以降がインストールされていること（ローカル MCP サーバーの場合のみ必要です）。
• FraudLabs Pro API キー：FraudLabs Pro に登録して、無料の Micro Plan API キーを取得してください。

インストール

この MCP サーバーは、次の 2 通りの方法で使用できます。

• クラウドホスト型 MCP サーバー：ホストされた FraudLabs Pro MCP サーバーに直接接続します。ローカルにインストールするものはありません。
• ローカル MCP サーバー：サーバーをダウンロードし、ご自身のマシンで実行します。

オプション 1：クラウドホスト型 MCP サーバー

ホストされたサーバーに直接接続する場合は、この方法を使用してください。

方法 A：HTTP による直接接続

MCP クライアントが HTTP 経由のリモートサーバーに対応している場合は、この方法を使用してください。Node.js や npx は必要ありません。

{
  "mcpServers": {
    "fraudlabspro": {
      "type": "http",
      "url": "https://mcp.fraudlabspro.com/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code など、クライアントをコマンドラインから設定する場合は、次のコマンドでサーバーを追加できます。

claude mcp add --transport http fraudlabspro https://mcp.fraudlabspro.com/ --header "X-API-Key: YOUR_API_KEY_HERE"

方法 B：npx 経由で接続

MCP クライアントがローカル（stdio）サーバーにしか対応していない場合は、この方法を使用してください。mcp-remote パッケージをローカルで実行し、リクエストをホストされたサーバーに転送します。Node.js が必要です。

{
  "mcpServers": {
    "fraudlabspro": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.fraudlabspro.com/",
        "--header",
        "X-API-Key:YOUR_API_KEY_HERE"
      ]
    }
  }
}

変更を保存した後、MCP クライアントを再起動すると、ツールメニューにサーバーが表示されます。

オプション 2：ローカル MCP サーバー

1. 依存関係のインストール 環境に必要なライブラリがインストールされていることを確認してください。

pip install mcp httpx uv

2. 設定 このサーバーを MCP クライアント（Claude Desktop など）で使用するには、設定ファイルに次の項目を追加してください。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fraudlabspro": {
      "command": "uvx",
      "args": [
        "mcp-fraudlabspro"
      ],
      "env": {
        "FRAUDLABSPRO_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

利用可能なツール

📦 注文管理

ツール	説明	主な引数
screen_order	注文の不正審査を行います。	ip, email, amount, bin_no, bill_country, ship_country
get_order_result	過去の注文の検証結果を取得します。	transaction_id
feedback_order	注文のステータスを更新します（APPROVE、REJECT、BLACKLIST）。	transaction_id, action, note

👤 ユーザー管理

ツール	説明	主な引数
screen_user	ログインや登録などのユーザーイベントを審査します。	email, ip, phone, first_name, last_name
get_user_result	過去のユーザー審査結果を取得します。	user_transaction_id
feedback_user	手動審査に基づいてユーザーイベントのステータスを更新します。	user_transaction_id, action, reason

開発とログ

このサーバーは FastMCP を使用し、MCP コンテキスト経由でログを送信します。Claude Desktop の「Developer Console」でログを確認し、デバッグ用に送信ペイロードと API の応答を調べることができます。

よくあるエラー：「An API key is needed」と表示された場合は、FRAUDLABSPRO_API_KEY 環境変数が設定ファイルで正しく設定されていることを確認し、MCP クライアントを再起動してください。

ライセンス

LICENSE ファイルを参照してください。