mcp-jumio について
mcp-jumio は Jumio のグローバル本人確認(KYX / Netverify)を扱う MCP サーバーです。規制対象の銀行やフィンテック企業を主な対象とし、アカウント、KYC ワークフロー、書類抽出、ライブネス検出、AML スクリーニングを 20 個のツールで提供します。
主な機能
- 01アカウントと KYC ワークフローの管理
- 02本人確認書類からの項目抽出
- 03顔照合とライブネス検出の結果取得
- 04AML・制裁リストのスクリーニング結果
- 05GDPR に基づくデータエクスポートと削除
- 06アカウント単位の Webhook 設定
活用シーン
- 01銀行やフィンテックの顧客本人確認
- 02高額取引における本人確認と不正リスクの審査
- 03AI エージェントからの KYC 審査状況の参照と更新
MCP 対応
Jumio のアカウント、ワークフロー、結果取得の API を MCP ツールとして公開し、MCP クライアントから本人確認の各工程を実行して結果を取得できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @codespar/mcp-jumioJUMIO_API_TOKENシークレットJumio API token (sent as the username component of HTTP Basic auth).JUMIO_API_SECRETシークレットJumio API secret (sent as the password component of HTTP Basic auth).JUMIO_USER_AGENTMerchant User-Agent string. Jumio requires a custom User-Agent header identifying the calling application (e.g. 'AcmeCorp KYX/1.0').JUMIO_REGIONRegion for the API host: 'us' (api.amer-1.jumio.ai), 'eu' (api.emea-1.jumio.ai), 'sg' (api.apac-1.jumio.ai). Defaults to 'us'.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
20掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| callbackUrl | string | いいえ | Jumioがワークフローの結果をPOSTするためのHTTPSコールバックURL。 |
| userReference | string | いいえ | Jumio のフローでユーザーに表示される不透明な参照値(例:マスキングされたメールアドレス)。 |
| workflowDefinition | object | いいえ | オプション:アカウント作成時にすぐ実行するインラインのワークフロー定義です。通常は省略し、別途 initiate_transaction を呼び出します。 |
| workflowDefinition.key | number | いいえ | Jumio ポータルの数値ワークフローキー(例:ID+selfie の場合は 200)。 |
| workflowDefinition.credentials | array | いいえ | 必要な認証情報のカテゴリ(ID、SELFIE など)。 |
| customerInternalReference | string | はい | 内部ユーザー ID です。Jumio アカウントに保存され、webhook で返されます。 |
詳細
@codespar/mcp-jumio
Jumio 向け MCP サーバー — グローバル企業向けの本人確認(KYX / Netverify)。
Jumio は、Onfido の不正パターン検出では不十分な場合に、銀行や大手の規制対象フィンテック企業が選ぶ本人確認基盤です。運用実績が長く、リスクインテリジェンスがより豊富で、規制対象の大規模な商取引向けに設計されています。
CodeSpar の identity カテゴリーにおける 3 番目のエントリーです。これで階層が完成します。
| サーバー | 強み |
|---|---|
| Unico | ブラジルのリーダー — 国内 KYC、PEP、裁判記録、Receita Federal の生体認証データベース |
| Onfido | グローバルな挑戦者 — 使いやすい開発者向け API、195 か国以上に対応、充実した SDK |
| Jumio(本プロジェクト) | グローバル企業向け — より高度な不正パターン検出、長い運用実績、銀行水準 |
Jumio を選ぶ場合
- 監査担当者が実績のあるベンダーを求める、規制対象の銀行または第 1 級フィンテック企業
- 不正による損失が本人確認コストを大きく上回る、高額取引のオンボーディング
- 高度な不正インテリジェンスが重要(頻度チェック、デバイス/セッションのシグナル、長期的な本人確認グラフ)
- 組織内の別の部門ですでに Jumio を利用しており、KYC スタックを一本化したい場合
ブラジル在住ユーザーには Unico(CPF + Receita の生体認証照合)を組み合わせ、その他の地域では Jumio を使用してください。
ツール(20)
| ツール | 用途 |
|---|---|
initiate_account | Jumio のエンドユーザーアカウントを作成します。 |
initiate_transaction | 既存のアカウントで新しい KYC ワークフローの実行を開始します。 |
get_transaction | ワークフロー実行の概要を取得します — ステータス('INITIATED' | 'PROCESSED' | 'SESSION_EXPIRED' | 'TOKEN_EXPI... |
list_transactions | アカウントのワークフロー実行一覧を取得します。 |
get_transaction_details | ワークフロー実行の全結果ペイロードを取得します — すべての機能の出力(データ抽出、生体検知、s... |
retrieve_document_data | ID 書類から抽出したフィールド(氏名、生年月日、書類番号、有効期限、発行国、MRZ、e...)を取得します。 |
retrieve_similarity_score | 顔の類似度結果(自撮り写真と書類の写真の比較)を取得します。 |
delete_transaction | ワークフロー実行を削除します(GDPR の消去権)。 |
update_transaction_status | ワークフロー実行の加盟店側ステータスを更新します(PATCH)。 |
retrieve_credentials | ワークフロー実行で取得した認証情報(ID の表裏、自撮り写真、住所証明など)を一覧表示します。 |
cancel_transaction | 進行中のワークフロー実行をキャンセルします(ステータスが 'INITIATED' または 'ACQUIRED' の場合)。 |
retry_transaction | 失敗、期限切れ、または拒否されたワークフロー実行を再試行します。 |
retrieve_extraction_data | 完了したワークフローの OCR/データ抽出機能の生出力を取得します — 抽出されたすべてのフィールドとその s... |
retrieve_liveness_result | 生体検知機能の結果を取得します — パッシブ/アクティブ生体検知の判定と、フレームごとのなりすまし防止スコ... |
retrieve_facemap | ワークフロー中に生成された生体認証フェイスマップ(顔テンプレート)を取得します。 |
retrieve_screening_result | ワークフローの AML/ウォッチリスト照合結果を取得します — 制裁対象者、PEP、ネガティブメディアの該当情報(... |
retrieve_data_export | アカウントの GDPR 準拠の全データエクスポートを取得します — すべてのワークフロー実行、取得した画像 URL、e... |
register_callback_url | Jumio がワークフロー結果の通知を POST する、アカウント単位の Webhook(コールバック)URL を設定または更新します。 |
delete_account | Jumio のエンドユーザーアカウントと、そのアカウントに関連するすべてのワークフロー実行を削除します(GDPR の消去権)。 |
list_accounts | 承認者/加盟店配下の Jumio エンドユーザーアカウントを一覧表示します。 |
フロー
initiate_account (once per end-user)
-> initiate_transaction returns redirectUrl
-> user completes capture at redirectUrl
-> get_transaction poll until status = PROCESSED
-> get_transaction_details full decision payload
-> retrieve_document_data extracted ID fields
-> retrieve_similarity_score face-match result
-> update_transaction_status ("APPROVED" / "REJECTED" — feedback loop)
インストール
npm install @codespar/mcp-jumio
環境
JUMIO_API_TOKEN="..." # API token (required)
JUMIO_API_SECRET="..." # API secret (required, secret)
JUMIO_USER_AGENT="AcmeCorp KYX/1.0" # required by Jumio — identifies the caller
JUMIO_REGION="us" # 'us' | 'eu' | 'sg'. Default 'us'.
認証
HTTP Basic 認証を使用します。API トークンをユーザー名、API シークレットをパスワードとして指定します。
Authorization: Basic base64(JUMIO_API_TOKEN:JUMIO_API_SECRET)
User-Agent: <JUMIO_USER_AGENT>
Jumio はカスタム User-Agent ヘッダーがないリクエストを拒否します。加盟店とインテグレーションを識別できる値を使用してください(例:"AcmeCorp KYX/1.0")。サーバーが両方のヘッダーを自動的に設定します。
リージョナルホスト
| 地域 | ホスト |
|---|---|
| US(デフォルト) | https://api.amer-1.jumio.ai |
| EU | https://api.emea-1.jumio.ai |
| SG / APAC | https://api.apac-1.jumio.ai |
すべてのエンドポイントは /api/v1 配下にあります。
実行
# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-jumio
# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-jumio
エンタープライズ
エージェントによる支払いのガバナンス、予算上限、監査証跡が必要ですか?CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。