Verifa

Verifa MCP サーバー

Claude Desktop、Cursor、Claude Code、または独自のエージェントなど、あらゆる MCP クライアントから本人確認を実行できます。 確認セッションを作成し、本人に撮影用リンクを渡し、制裁対象者リストや PEP リストと照合して、結果を読み取り、審査キューを処理できます。すべてエージェントが呼び出せるツールとして利用できます。

{
  "mcpServers": {
    "verifa": {
      "command": "npx",
      "args": ["-y", "@verifasolutionsinc/mcp-server"],
      "env": { "VERIFA_API_KEY": "vk_sandbox_...", "VERIFA_ENV": "sandbox" }
    }
  }
}

インストールはこれだけです。app.withverifa.com → Developers → API keys でサンドボックスキーを取得できます （無料、カード不要、営業担当者との通話も不要）。サンドボックスキーが実際のデータに触れることはなく、あらゆる確認結果をシミュレートできるため、 数分で一連の流れを確認できます。これを実行するのが examples/id-check です。

仕組み

このパッケージは意図的に小さく作られています。Verifa のホスト型 MCP エンドポイント（ https://api.withverifa.com/mcp、ストリーミング可能な HTTP）への認証済み接続を 1 つ開き、 tools/list、tools/call、prompts/list 、prompts/get を stdio 経由で転送します。ここで再実装されている機能はありません。ツールスキーマ、PII のスクラブ処理、レート制限、監査証跡はすべてサーバー側にあるため、このラッパーが製品との間でずれることはありません。

クライアントがすでに OAuth 2.1 によるストリーミング可能な HTTP に対応している場合、このパッケージを省略してホスト型エンドポイントに直接接続できます。同じツールを使え、API キーの代わりにサインインします。

ツール

サーバーでは、45 個のツールをツールセット別に公開しています。デフォルトでは destructive 以外のすべてを利用できます。

ツールセット	エージェントが実行できる操作
sessions	create_session、get_session、list_sessions、list_session_events、simulate_session（サンドボックス）、reprocess_session
checks	list_checks、get_check、list_check_hits、rerun_check — 制裁対象者、PEP、ネガティブメディア、監視リスト
identities	search_identities、list_identities、get_identity、タグ付け／タグ解除
cases	list_cases、get_case、claim_case、assign_case、add_case_comment、approve_case、reject_case、escalate_case …
findings	list_findings、get_finding、acknowledge_finding、dismiss_finding
lists	ブロックリストとカスタムリストの読み取りと書き込み
workflows	list_workflows、get_workflow、trigger_workflow、list_verification_policies
org	whoami、get_usage_stats、list_org_users、list_api_keys
search	ChatGPT 形式のコネクター向けの search／fetch
destructive	redact_session、redact_identity、bulk_redact_sessions、… — オプトインしない限り無効です

すべてのツールにはスコープが適用されます。有効になっているツールセットにかかわらず、接続で実行できる操作は API キーのスコープによって制限されます。 読み取り、書き込みを問わず、すべての呼び出しで、エージェントによる実行であることと、使用されたキーまたは OAuth クライアントを記録する監査ログが書き込まれるため、エージェントの判断が人間の判断と誤認されることはありません。

利用するツールの絞り込み

ツールが少なければ、リクエストごとに消費するコンテキストが減り、ツールの選択精度が向上します。用途に必要なものを選んでください。

"env": {
  "VERIFA_API_KEY": "vk_sandbox_...",
  "VERIFA_MCP_TOOLSETS": "sessions,checks",
  "VERIFA_MCP_READ_ONLY": "1"
}

変数	効果
VERIFA_API_KEY	必須です。vk_sandbox_… または vk_live_… を指定します。公開可能キー（vk_pub_…）は拒否されます。
VERIFA_ENV	sandbox または live を指定します。省略した場合はキーから推定され、指定した場合はキーと一致している必要があります。
VERIFA_MCP_TOOLSETS	公開するツールセットをカンマ区切りで指定します。デフォルトは destructive 以外のすべてです。
VERIFA_MCP_READ_ONLY	1 を指定すると、書き込みを行うすべてのツールが非表示になります。
VERIFA_MCP_ALLOW_DESTRUCTIVE	1 を指定すると、削除ツールが追加されます。各呼び出しには redact:write スコープと、記述された reason も必要です。また、キーごとに 1 時間あたり 5 回までに制限されます。削除は設計上、元に戻せません。
VERIFA_API_URL	API ホストを上書きします（例：ステージング環境）。

クライアントを開かずに、特定の設定で公開される内容を確認できます。

VERIFA_API_KEY=vk_sandbox_... npx -y @verifasolutionsinc/mcp-server --check

5 分で試す

git clone https://github.com/Verifa-Solutions/verifa-mcp-server
cd verifa-mcp-server/examples/id-check
npm install
cp .env.example .env        # paste your sandbox key
npm start                   # approve
npm run review              # the outcome that matters: a human has to decide

デモではセッションを作成し、インテグレーターが提示するワンタイムのキャプチャリンクと QR コードを生成して、結果をシミュレートし（パスポートは不要です。サンドボックスのみ）、その結果を読み取ります。REST 呼び出しを一方の列に、同じフローをこの MCP サーバー経由で実行した結果をもう一方の列に出力します。署名付き Webhook の配信を受信して署名検証を確認するには、公開 URL を指定して --webhooks を追加してください（cloudflared tunnel --url http://localhost:8787 を利用できます）。署名検証は、ほとんどのインテグレーションで誤りが起きやすい部分です。

開発

npm install
npm run build
npm test                                     # unit tests
VERIFA_API_KEY=vk_sandbox_... node dist/index.js --check   # live smoke test

Node 20 以降が必要です。ログは stderr に出力され、stdout は MCP トランスポートとして使用されます。

セキュリティ

• 評価中はサンドボックスキーを使用してください。ライブキーは、エージェントが必要とするツールセットに限定してください。
• サーバーが API キーを保存または記録することはありません。VERIFA_API_URL への Bearer トークンとしてのみ送信されます。
• デフォルトではレスポンスに PII は含まれません。ホスト型サーバーは、キーに該当するスコープがあり、セッションの機密データウィンドウが開いている場合を除き、ツールの結果から申請者の識別情報を除去します。
• 脆弱性は withverifa.com/security/disclosure から報告してください。

ライセンス

MIT — LICENSE を参照してください。