Didit MCPの使用例：プロンプトとエージェントとの会話

​

クイックプロンプト

• 「すべてのアプリを対象に、レビュー中のセッションを直近5件表示してください。」 → didit_session_search（status: "In Review"、limit: 5を指定）
• 「過去15日間に電話番号検証を試したものの離脱した人は何人ですか？」 → didit_analytics（last_n_days: 15を指定。1回の呼び出しで機能ファネルを読み取ります）
• 「vendor_dataがuser_8842の顧客を探して、どのアプリでどのステータスか教えてください。」 → didit_vendor_user_search
• 「クレジット残高と今月のコンバージョン率を教えてください。」 → didit_org_get_balance + didit_analytics

• 「IDスキャンとライブネス検知を含むKYCワークフローを作成して、認証リンクを発行してください。」 → didit_workflow_create → didit_session_create
• 「パスポートのみを受け付ける本人確認ワークフローを作成し、その後にセルフィーによるライブネス検知を追加してください。」 → didit_workflow_create。documents_allowed: ["PASSPORT"]と指定するだけで、MCPがすべての国についてパスポートのみの設定に展開します（高度な設定 → 機能設定を参照）。
• 「新しいワークフロー：パスポートをスキャンし、本人確認が却下されたらセッションを却下する。申告された職業が『Software Engineer』に近い（60%以上）場合はライブネスチェックを実行し、それ以外の場合はスペイン語で住所証明を求める。その後、自動判定する。」 → didit_workflow_get_field_definitions → didit_workflow_validate_graph → didit_workflow_set_graph
• 「ワークフロー26d33c04…で、本人確認の後に、本人確認が却下された場合はセッションを却下し、職業が『Software Engineer』と80%以上類似している場合はDocument-AIによる資金証明のステップを追加して、その後は続行してください。」 → didit_workflow_search → didit_workflow_get_graph → didit_workflow_edit_graph（小さな操作単位で編集し、レビュー可能な下書きとして保存）
• 「書類スキャンの代わりにBankIDやMitIDでのログインを提供できる国はどこですか？」 → didit_workflow_get_id_verification_methods_catalog
• 「https://myapp.com/webhooks/diditでステータス更新を受け取るWebhookの送信先を登録してください。」 → didit_webhook_create

• 「このウォレットをAMLスクリーニングにかけ、ヒットしたらブロックリストに追加してください。」 → didit_transaction_screen_wallet → didit_blocklist_add
• 「セッション…のケースを作成し、私に割り当ててください。」 → didit_case_create → didit_case_manage
• 「Acme Ltdは英国で登記された企業ですか？株主は誰ですか？」 → didit_verify_kyb_search → didit_verify_kyb_select

​

1. 本人確認を立ち上げる

あなた： 「IDスキャンとライブネス検知を使って、自分のアプリにDiditの本人確認を設定し、試せるリンクをください。」 エージェント： まずワークフローを作成します。（didit_workflow_createをworkflow_label: "Standard KYC"、features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]で呼び出し） 「Standard KYC」を公開しました。workflow_id = 6f2c…です。次に、試すためのセッションを作成します。（didit_session_createをworkflow_id: "6f2c…"、vendor_data: "test-user-1"で呼び出し） リンクはこちらです：https://verify.didit.me/session/…。スマートフォンで開いてフローを実行してください。本番環境では、バックエンドがREST APIでセッションを作成します：

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "workflow_id": "6f2c...", "vendor_data": "internal-user-id", "callback": "https://myapp.com/done" }'

このx-api-keyは、バックエンドで使うアプリケーションのREST APIキーです。このMCPへのサインイン方法（Log in with Diditを使用）とは別のものです。Webhookの送信先も登録しましょうか？ あなた： 「はい。エンドポイントはhttps://myapp.com/webhooks/diditです。」 エージェント： （didit_webhook_createをlabel: "Production"、url: "https://myapp.com/webhooks/didit"、webhook_version: "v3"、subscribed_events: ["status.updated"]で呼び出し） 完了しました。私が受け取るレスポンスでは署名シークレットが伏せられているため、コンソールのWebhookからコピーし、DIDIT_WEBHOOK_SECRETとして保存してください。各配信を信頼する前に、X-Signature-V2ヘッダーを検証してください。

​

2. KYB:法人登記で企業を確認する

あなた： 「Acme Trading Ltdは実在する英国企業ですか？登記番号は12345678です。」 エージェント： （didit_verify_kyb_searchをcountry_code: "GB"、name: "Acme Trading Ltd"、registration_number: "12345678"で呼び出し） 候補が1件見つかりました：ACME TRADING LTD、2019年設立、ステータスはactive、登記上の事務所はマンチェスターです。役員と株主を含む完全な記録を取得しますか？ あなた： 「はい。実質的支配者が誰かも教えてください。」 エージェント： （候補のkyb_response_idを指定してdidit_verify_kyb_selectを呼び出し） 完全な記録を取得しました。取締役が2名、株式および議決権の75%+を保有する重要な支配権を有する者が1名です。記録には提出書類の履歴と登記住所が含まれます。これは課金対象の法人登記照会でした（クレジットを消費する呼び出しが2回）。すべての企業顧客に対してこれを自動的に実行したい場合は、didit_workflow_createでKYBワークフローにKYB_REGISTRYを追加できます。英国の登記所が販売しているデータのレベルは、didit_workflow_get_kyb_registry_catalogで確認できます。

​

3. レビューキューを処理する

あなた: 「レビュー待ちのものは何がありますか。それぞれ何が問題ですか。」 エージェント: (status: "In Review"、limit: 10を指定してdidit_session_searchを呼び出し) 2つのアプリにまたがる4件のセッションがレビュー中です。それぞれの判定を確認します。(各session_idに対してdidit_session_get_decisionを呼び出し)

セッション	アプリ	停止した理由
a1f3…	Onboarding	顔照合の一致スコア71(しきい値80)、ライブネス検知は合格
b7c2…	Onboarding	書類の有効期限が2か月前に切れている
c904…	Marketplace	AML: PEPヒット1件、氏名一致率92%、生年月日が異なる
d215…	Marketplace	住所証明が90日より古い

あなた: 「a1f3を承認してください。セルフィーを確認したところ同一人物です。b7c2は書類の期限切れなので却下してください。」 エージェント: (session_id: "a1f3…"、new_status: "Approved"を指定してdidit_session_update_statusを呼び出し、続いてsession_id: "b7c2…"、new_status: "Declined"、comment: "Expired document"を指定して呼び出し) 両方とも更新しました。(a1f3…に対して「Manual selfie review: same person」というメモを付けてdidit_session_add_reviewを呼び出し) スコアを覆した理由が監査ログに残るよう、レビューメモを追加しました。AMLと住所証明の2件はまだ未対応です。ご指示いただければ、didit_case_createでPEPヒットのケースを作成します。

​

4. 取引ルールを本番適用前にバックテストする

あなた: 「1時間以内に$1,000を超える送金を3回を超えて行った人をフラグ付けしたいです。どのくらいノイズが出ますか。」 エージェント: (amount > 1000に対するconditions、1時間のウィンドウでの件数3以上というaggregation、period_days: 90を指定してdidit_transaction_rule_backtestを呼び出し) 過去90日間では、このルールは6人の対象者による14件の取引で発火していたはずです。そのうち2人の対象者はすでにフラグ付けされています。アクションを一切実行せずに一致のみを記録するTESTモードで作成しましょうか。 あなた: 「はい、TESTモードでお願いします。」 エージェント: (title: "Velocity: 3+ transfers over $1,000 per hour"、category: "aml_ctf"、mode: "TEST"、同じconditionsとaggregation、対象者をフラグ付けするactionsリストを指定してdidit_transaction_rule_createを呼び出し) 作成しました。数日後にdidit_transaction_rule_getで状況を確認してください。問題なければ、didit_transaction_rule_updateでmodeをACTIVEに切り替えます。プリセットをインストールしたい場合は、didit_transaction_rule_library_listにDiditのベロシティルールのプリセットも用意されています。

​

セッション結果は非同期です

1. status.updated Webhook（推奨）
2. didit_session_get_decision(フォールバックとしてのポーリング)

{
  "session_id": "uuid",
  "status": "Approved",
  "session_kind": "user",
  "id_verifications":  [ { "node_id": "first_id", "status": "Approved", "first_name": "Jane" } ],
  "liveness_checks":   [ { "node_id": "first_liveness", "status": "Approved", "score": 95.4 } ],
  "face_matches":      [ { "node_id": "first_face_match", "status": "Approved", "score": 96.1 } ],
  "aml_screenings":    [ { "node_id": "first_aml", "status": "Approved", "total_hits": 0, "hits": [] } ],
  "reviews": []
}

​

ワンプロンプト連携と組み合わせる