ブログ・ 2026年8月18日

MCPサーバーを介したKYC：実践ガイド

MCPサーバーを介してKnow Your Customer（KYC）検証を実行する方法。組織の発見、ワークフローの選択、ホスト型セッションの作成、そして自然言語プロンプトからの決定の読み取りまでを解説します。フルKYCバンドルはチェックあたり0.33ドルです。.

By Didit2026年8月18日更新日 2026年8月18日

Know Your Customer (KYC) チェックは、Diditプラットフォームで最も一般的な本人確認操作であり、https://mcp.didit.me/mcp にある公式のModel Context Protocol (MCP) サーバーを使用すると、まるで会話のように自然に実行できます。AIエージェント（Claude Desktop、Claude Code、Cursor、ChatGPT、または任意のMCP対応クライアント）をホストされたエンドポイントに向け、「Log in with Didit」で認証すると、エージェントは完全なKYCライフサイクルをたどることができます。組織とアプリケーションの発見、適切なワークフローの選択、ホストされた検証セッションの作成、ユーザーへのリンクの提供、そして決定のポーリングまで。このガイドでは、その一連のツールを順を追って説明し、10種類のセッションステータスとそれぞれの対処法、そしてバックエンドパスを希望する読者向けに同等のRESTコールも紹介します。

主なポイント

Didit MCPサーバーは、https://mcp.didit.me/mcp でStreamable HTTPを介して115のツールを11のカテゴリにわたって公開しています。ホスト型またはセルフホスト型で、MCPレイヤー自体は無料です。
認証は、動的クライアント登録を伴うOAuth 2.1 + Proof Key for Code Exchange (PKCE)です。ホストされたMCPサーバーにはAPIキーは不要です。エージェントはサインインしたユーザーとして認証され、そのユーザーのコンソール権限を継承します。
フルKYC検証（IDドキュメントチェック、パッシブ生体認証、顔照合、IP分析）は0.33ドルで、毎月500回まで無料で検証でき、2秒未満のp99推論を実現します。ワークフローには、AMLスクリーニング（0.20ドル）やカスタム質問票（0.10ドル）などの追加チェックを含めることができます。
エージェントは5つのツールでKYCセッションを実行します。組織とアプリケーションの発見、ワークフローの選択、セッションの作成、V3配列決定の読み取り、そしてセッションステータスを承認、拒否、または再提出要求に更新します。
10種類のセッションステータスは、エージェントに次に何をすべきかを指示します。未開始から、進行中、審査中、承認済み、拒否済み、期限切れ、放棄済み、KYC期限切れ、再提出済み、ユーザー待ちまで。
MCPサーバーは、220以上の国、14,000以上のドキュメントタイプ、48以上の言語で、2,000以上の企業のオンボーディングを支援しています。

Didit MCPサーバーとは

Model Context Protocol (MCP) は、AIエージェントが一貫したインターフェースを通じて外部ツールを呼び出すことを可能にするオープン標準です。Diditがhttps://mcp.didit.me/mcpで実装しているものは、本人確認および不正防止プラットフォームの公式MCPサーバーであり、github.com/didit-protocol/mcp でMITライセンスの下で公開されています。これはStreamable HTTPトランスポート（ステートレス、POST専用、Server-Sent Eventsなし）を使用し、セッション、ワークフロー、検証API、トランザクション監視、アンチマネーロンダリング（AML）スクリーニング、ウォレットスクリーニング、ウェブフック、ケース、レポート、ワークスペース操作など、プラットフォーム全体をカバーする11のカテゴリにわたる115のツールを公開しています。

ホストされた認証は、PKCE（Proof Key for Code Exchange）と動的クライアント登録（DCR）を伴うOAuth 2.1を使用します。エージェントが最初に接続すると、business.didit.me を介して「Log in with Didit」フロー用のブラウザが開きます。結果として得られるトークンは、didit:management と didit:verification にわたるコンソールユーザーにスコープされており、エージェントはあなたの役割が既に許可していることしかできません。これは重要です。ホストされたサーバーのMCP設定ファイルに貼り付けるAPIキーはありません。APIキーはREST APIの概念であり、MCPコンテキストでは使用されません。

ホストされたエンドポイントをClaude DesktopまたはClaude.aiに接続するには、事前に構築されたコネクタディープリンクを使用します。

ClaudeコネクタとしてDiditを追加

ツールセットの全概要については、MCPツールリファレンスとMCP概要ドキュメントを参照してください。

KYCシーケンス — ツール別

Diditの標準KYCセッションでは、IDドキュメント検証、本人の物理的な存在を確認するためのパッシブ生体認証、自撮り写真とドキュメントの肖像画が一致することを確認するための顔照合、不正の兆候を検出するためのIP分析など、選択した本人確認チェックをバンドルします。フルバンドルを構成した場合、これらすべてが0.33ドルで提供されます。エージェントが作成、配信、解決を行うための正確なツールシーケンスは次のとおりです。

1. コンテキストの検出

何かを作成する前に、エージェントはどの組織とアプリケーションで操作するかを知る必要があります。didit_context_get を呼び出して、サインインしたユーザーがアクセスできる利用可能な組織とアプリケーションをリストします。これにより、後続のすべてのツール呼び出しに必要なorganization_idとapplication_idが返されます。

2. ワークフローの選択

検証ワークフローは、どのチェックを実行し、どのように決定を下すかを定義します。didit_workflow_list を呼び出して、アプリケーション用に構成されたワークフローを取得します。各ワークフローは、その機能（OCR（光学文字認識）、生体認証、顔照合、AML、質問票）を公開しているため、エージェントは必要な検証タイプに適切なものを選択できます。標準のKYCオンボーディングの場合、ワークフローには通常、OCR、生体認証、顔照合、およびIP分析が含まれます。

3. セッションの作成

ワークフローが選択されたら、workflow_id を指定して didit_session_create を呼び出し、オプションで vendor_data に独自の外部参照を指定します。組織とアプリケーションのスコープは、曖昧でない場合は自動的に解決されるため、これらを渡すことはほとんどありません。ホストされた検証UIのlanguage、申請者が戻るcallback、およびcontact_detailsまたはexpected_detailsを介した事前入力データを設定することもできます。ツールはurl（申請者に送信するホストされたリンク）を返します。このパスにはSDK統合は必要ありません。申請者はブラウザでリンクを開き、チェックを完了すると、エージェントがそこから引き継ぎます。

4. 決定の読み取り

申請者がチェックを完了したら、セッションIDを指定して didit_session_get_decision を呼び出します。これにより、V3の複数配列決定が返されます。これには、status文字列、判定とリスクスコアを含むdecisionオブジェクト、および機能ごとの結果（OCRデータ、生体認証の信頼度、顔照合の類似度など）が含まれます。エージェントは判定を読み取り、次のアクションを決定します。

5. 決定に基づく行動

didit_session_update_status を呼び出して、決定の判定に基づいてセッションステータスを設定します。

承認済み — すべてのチェックに合格しました。ステータスを approved に設定して最終決定します。
拒否済み — チェックが失敗したか、不正が検出されました。ステータスを declined に設定します。
再提出済み — ドキュメントが不明瞭だったか、申請者が再試行する必要があります。ステータスを resubmitted に設定して、別の試行を許可します。

これが、自然言語プロンプトから5つのツールで完結するKYCの往復プロセス全体です。

10のセッションステータス

Diditセッションは、10のステータスからなるライフサイクルをたどります。セッションを監視するように構成されたエージェントは、それぞれを処理する必要があります。

未開始 — セッションは作成されましたが、申請者は検証リンクを開いていません。まだアクションは不要です。
進行中 — 申請者がリンクを開き、チェックを進めています。エージェントは待機する必要があります。
審査中 — 自動チェックが境界スコアで終了しました。セッションは手動レビューが必要です。人間のコンプライアンス担当者に通知します。
承認済み — すべてのチェックに合格しました。オンボーディングを完了します。
拒否済み — チェックが失敗しました。申請者を拒否するか、別のドキュメントで新しい検証を開始します。
期限切れ — 完了する前にセッションの有効期限が切れました。新しいセッションを提供します。
放棄済み — 申請者が完了する前にフローを閉じました。リマインダーまたは新しいリンクを送信します。
KYC期限切れ — 定期的な再検証セッションの有効期限が切れました。再オンボーディングのフラグを立てます。
再提出済み — より良いデータが要求された後、申請者が再提出しました。didit_session_get_decision を再実行して新しい判定を取得します。
ユーザー待ち — セッションは、申請者が追加情報またはドキュメントを提供するのを待って一時停止しています。

エージェントレベルの制御：リスト、ブロックリスト、継続的な監視

シングルセッションKYCを超えて、MCPサーバーはエージェントにリスク制御インターフェースへのアクセスを提供します。didit_lists_list および didit_lists_entry_create を使用して、拒否された申請者をブロックリストに追加し、新しいセッションの作成を防ぎます。didit_blocklist_get および didit_blocklist_add を使用して、新しいセッション要求が作成される前にスクリーニングします。継続的な監視のために、KYC承認後、アンチマネーロンダリングスクリーニングのためにdidit_verify_amlを1,300以上のウォッチリストに対してチェックあたり0.20ドルで実行でき、暗号ウォレットスクリーニングのためにdidit_transaction_screen_walletをチェックあたり0.15ドルで実行できます。

同等のREST APIパス

すべての統合がAIエージェントを介して実行されるわけではありません。DiditをHTTP経由で直接呼び出すバックエンドを構築している場合、REST APIはx-api-key認証（コンソールからのアプリケーションのシークレットキー）を使用します。以下は、curlを介した同等のKYCセッション作成です。

curl -X POST https://api.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wfl_abc123",
    "vendor_data": "user-456",
    "language": "en",
    "callback": "https://myapp.com/kyc-callback"
  }'

応答には、session_idとurl（MCPセッションが返すのと同じホストされたリンク）が含まれます。決定エンドポイントをポーリングし、RESTを介して同じ方法でステータスを更新します。x-api-keyヘッダーに注意してください。これはREST API認証メカニズムであり、上記で説明したMCP OAuthフローとは関係ありません。REST APIは別のインターフェースであり、MCPサーバーはAPIキーを必要とせず、使用することもありません。

価格と制限

Diditのすべての機能には、最低料金なしの公開された成功報酬型価格設定があります。MCPサーバー自体は無料です。接続やツールのリスト表示には料金がかかりません。成功した検証に対してのみ支払います。

フルKYCバンドル（ID + パッシブ生体認証 + 顔照合 + IP）：0.33ドル
ID検証（単体）：0.15ドル
パッシブ生体認証（単体）：0.10ドル
AMLスクリーニング：チェックあたり0.20ドル、1,300以上のウォッチリスト
ウォレットスクリーニング（KYT）：チェックあたり0.15ドル
トランザクション監視：トランザクションあたり0.02ドル
企業検証（KYB）：企業あたり2.00ドルから

すべての機能には、毎月500回の無料検証が永続的に含まれています。時間制限もティアゲートもありません。0.33ドルのフルKYCバンドルは、従来のKYCプロバイダーよりも3〜5倍安価であり、220以上の国と14,000以上のドキュメントタイプで2秒未満のp99推論を実現します。

始めるには

エージェントを接続し、数分でKYCチェックを開始するには、次の手順を実行します。

Claudeコネクタディープリンクを開き、Diditをカスタムコネクタとして追加します。
Claude Codeの場合：claude mcp add --transport http didit https://mcp.didit.me/mcp を実行し、次に /mcp で認証します。
Cursorの場合：{"mcpServers":{"didit":{"url":"https://mcp.didit.me/mcp"}}} を .cursor/mcp.json に追加します。
認証後、「Discover my organization and applications, list the KYC workflows, and create a verification session for a new applicant.」とプロンプトします。

MCPのソースコードはオープンソースでMITライセンスの下で公開されており、github.com/didit-protocol/mcp で入手できます。異なるクライアントでのサーバーのインストールに関する詳細なウォークスルーについては、ClaudeにDidit MCPサーバーをインストールする方法をお読みください。パラメータを含むツールカタログ全体については、Didit MCPツールリファレンスを参照してください。