VerifEye

VerifEye MCP サーバー

VerifEye MCP サーバーは、Realeyes がホストするリモートの Model Context Protocol（MCP）サーバーです。VerifEye Face API を、AI アシスタントが呼び出せるツールとして提供します。顔を分析して、見かけの年齢と性別に加え、その瞬間の感情や注意を判定する（Identify）、後で同じ人物を識別できるよう顔を登録する（Onboard）、登録済みの顔と画像を照合する（Compare）、登録済みの顔が保存されているコレクションを管理する、といった機能を利用できます。

サーバーは Realeyes がホストするため、インストールや実行は不要です。このリポジトリには、MCP レジストリ向けの公開リスティングメタデータである server.json が含まれています。

詳しいドキュメント：https://verifeye-docs.realeyes.ai/verifeye-apis/mcp-server/

サーバー URL

https://verifeye-mcp-server.realeyes.ai/mcp

トランスポート：Streamable HTTP。サーバーのアドレスはこれだけです。レジストリやディレクトリに別のアドレスが記載されている場合は接続せず、お問い合わせください。

要件

• VerifEye Developer Console のアカウント。
• OAuth に対応したリモート MCP サーバーをサポートする MCP クライアント。

認証

このサーバーは OAuth 2.1（PKCE を使用する認可コードフロー）を使用します。接続すると、ブラウザーで VerifEye のサインインと同意の画面が開きます。MCP クライアントに API キーを入力する必要はありません。アカウントの API キーはサーバー側で解決され、クライアントに公開されることはありません。

このサーバーは動的なクライアント登録には対応していません。ChatGPT、VS Code、Codex は Client ID Metadata Document を使って自らを識別するため、入力するものはありません。Claude、Claude Code、Cursor、Gemini CLI は事前登録されたクライアント ID を使用します。

クライアントの接続

Claude Code、Claude、ChatGPT、VS Code、Cursor、Gemini CLI、Codex の手順と、それぞれに必要なクライアント ID は、ドキュメントのクライアントの接続を参照してください。

たとえば、VS Code ではプロジェクトのルートに .vscode/mcp.json を追加します。

{
  "servers": {
    "verifeye": { "type": "http", "url": "https://verifeye-mcp-server.realeyes.ai/mcp" }
  }
}

MCP: List Servers コマンドからサーバーを起動し、ブラウザーが開いたらサインインします。

サーバーの使用

サーバーに接続してサインインしたら、自然な言葉で指示すると、アシスタントがツールを選びます。

画像はリンクで指定してください。 画像ツールが受け取れるのは JPEG または PNG 画像の公開 URL で、VerifEye がその URL から画像を取得します。会話に添付された画像はツールに渡せないため、アクセス可能な場所に画像を置き、そのリンクをアシスタントに伝えてください。長期間公開される URL より、数分で期限切れになる事前署名リンクを推奨します。サーバーが verifeye_get_upload_url を提供し、クライアントが独自に HTTPS リクエストを実行できる場合は、クライアントから画像をアップロードすることもできます。画像の要件についてはドキュメントを参照してください。

リージョンを選択してください。 各呼び出しは、米国（us）を指定しない限り EU（eu）で実行されます。コレクションはリージョンごとに分かれているため、コレクションを操作するときは、毎回同じリージョンを指定してください。

プロンプトの例

画像リンクはプレースホルダーです。ご自身の画像へのリンクを使用してください。プロンプト 2〜5 は順に内容を引き継ぎ、プロンプト 2 で作成したコレクションと顔を使用します。

#	プロンプト	動作
1	"https://example.com/photos/visitor.jpg にある顔の見た目の年齢と性別を推定してください。"	verifeye_identify_face が顔を分析し、推定結果を返します。顔も画像も保存されません。
2	"front-desk-visitors という名前の VerifEye コレクションを作成し、https://example.com/photos/visitor-1042.jpg の顔を外部キー visitor-1042 を付けて登録してください。"	verifeye_create_collection がコレクションを作成し、verifeye_onboard_face がそのキーとともに顔テンプレートを保存します。登録によって生体認証データが保存されます。生体認証データと同意をご覧ください。
3	"https://example.com/photos/today.jpg の人物は、すでに front-desk-visitors コレクションに登録されていますか？"	verifeye_identify_face にそのコレクションを指定すると、写真にプロンプト 2 で登録した人物が写っている場合は faceId とキーを含む Existing を返し、それ以外の人物には NotExisting を返します。登録は行われません。
4	"https://example.com/photos/check-in.jpg の顔と、front-desk-visitors にある visitor-1042 を比較してください。"	verifeye_get_face_by_key が faceId を検索し、verifeye_compare_face が類似度と VerifEye の isMatch 判定を返します。
5	"front-desk-visitors から visitor-1042 の顔を削除してください。"	verifeye_get_face_by_key が顔を検索し、verifeye_delete_face がそのテンプレートを破棄します。この操作は取り消せません。

多くのクライアントでは、顔の登録や削除の前など、実行前に呼び出しを承認するよう求められます。

ツール

すべてのツールは region（eu または us。デフォルトは eu）を受け取り、画像の処理場所とコレクションの保存場所を選択します。コレクションはリージョンごとに分かれています。eu で作成したコレクションは us からは見えません。

ツール	動作	データの保存または破棄
verifeye_identify_face	画像内の顔を分析し、コレクションを指定した場合はそのコレクションと照合して顔を識別します	なし
verifeye_onboard_face	後で人物を識別できるよう、画像内の顔をコレクションに登録します	顔テンプレートを保存します
verifeye_compare_face	画像内の顔を、登録済みの顔 1 件と比較します	なし
verifeye_delete_face	登録済みの顔を 1 件削除します	取り消せません
verifeye_list_collections	アカウント上のコレクションを一覧表示するか、指定したコレクションの存在を確認します	なし
verifeye_create_collection	空のコレクションを作成します	なし
verifeye_set_collection_description	コレクションの説明を置き換えます	なし
verifeye_reset_collection	コレクションを残したまま、その中のすべての顔を削除します	取り消せません
verifeye_delete_collection	コレクションと、その中のすべての顔を削除します	取り消せません
verifeye_get_face_by_key	独自の識別子を使って登録済みの顔を検索します	なし
verifeye_set_face_key	登録済みの顔に独自の識別子を付与します	なし
verifeye_delete_face_key	登録済みの顔から識別子を削除します	顔を検索する手段が失われます
verifeye_get_upload_url	画像 1 枚をアップロードするための、有効期間の短いフォームを返します	なし

各ツールのパラメーター、結果、エラーコードについては、ドキュメントをご覧ください。

生体データと同意

これらのツールは顔（生体）データを処理します。呼び出しが実行される前に、有効かつ十分な説明に基づく同意を取得し、画像に写っている人々に適用されるプライバシーおよび生体データに関する規制（GDPR、BIPA、CCPA など）を遵守する責任があります。

• verifeye_onboard_face は、削除されるまで保持される顔テンプレートを保存します。
• verifeye_delete_face、verifeye_reset_collection、verifeye_delete_collection は、顔テンプレートを完全に破棄します。
• 年齢は見た目に基づく推定であり、法的な年齢証明ではありません。性別は人口統計上の推定であり、本人が申告したアイデンティティ属性ではありません。顔の一致は類似性を示す証拠であり、それ単独では本人確認になりません。
• ツールの呼び出しはお客様の VerifEye アカウントとして実行され、アカウントの使用上限に算入されます。

リンク

• ドキュメント：https://verifeye-docs.realeyes.ai/verifeye-apis/mcp-server/
• MCP レジストリの項目（ai.realeyes/verifeye）：https://registry.modelcontextprotocol.io/v0.1/servers/ai.realeyes%2Fverifeye/versions/latest
• プライバシーポリシー：https://realeyes.ai/privacy-policy/
• 利用規約：https://realeyes.ai/terms-for-customers/
• サポート：[email protected]