API ВЕГА
English

VerifEye MCP Server

VerifEye MCP Server — это размещённый на сервере Model Context Protocol (MCP) сервер компании Realeyes. Он предоставляет Face API VerifEye в виде инструментов, которые может вызывать 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.

  • MCP-клиент с поддержкой удалённых MCP-серверов и OAuth.

Аутентификация

Сервер использует OAuth 2.1 (поток authorization code с PKCE). При подключении в браузере откроется страница входа в VerifEye и предоставления согласия. API key не нужно указывать в MCP-клиенте: ключ вашей учётной записи определяется на стороне сервера и не передаётся клиенту.

Сервер не поддерживает динамическую регистрацию клиентов. ChatGPT, VS Code и Codex указывают свои данные с помощью Client ID Metadata Document, поэтому ничего вводить не нужно. Claude, Claude Code, Cursor и Gemini CLI используют предварительно зарегистрированный client ID.

Подключение клиента

Пошаговые инструкции по настройке Claude Code, Claude, ChatGPT, VS Code, Cursor, Gemini CLI и Codex, включая необходимый для каждого клиента client ID, приведены в документации: Подключение клиента.

Например, в VS Code добавьте файл .vscode/mcp.json в корень проекта:

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

Запустите сервер с помощью команды MCP: List Servers, а затем войдите в систему в открывшемся окне браузера.

Использование сервера

После подключения сервера и входа в систему сформулируйте запрос обычным языком — ассистент сам выберет нужные инструменты.

Передавайте изображение по ссылке. Инструменты для работы с изображениями принимают общедоступный URL изображения в формате JPEG или PNG, которое VerifEye загружает самостоятельно. Изображение, прикреплённое к переписке, нельзя передать инструменту. Поэтому разместите изображение в доступном месте и отправьте ассистенту ссылку на него. Лучше использовать предварительно подписанную ссылку, срок действия которой истекает через несколько минут, а не постоянно общедоступный URL. Если сервер предоставляет verifeye_get_upload_url, а ваш клиент может самостоятельно отправлять HTTPS-запросы, клиент может загрузить изображение напрямую. Требования к изображениям приведены в документации.

Выберите регион. По умолчанию каждый вызов выполняется в EU (eu), если вы не укажете US (us). Коллекции привязаны к региону, поэтому при работе с одной коллекцией каждый раз указывайте один и тот же регион.

Примеры запросов

Ссылки на изображения приведены для примера: замените их ссылкой на собственное изображение. Запросы 2–5 связаны между собой и используют коллекцию и лицо, добавленные в запросе 2.

#ЗапросРезультат
1«Оцени примерный возраст и пол человека на изображении https://example.com/photos/visitor.jpg».verifeye_identify_face анализирует лицо и возвращает оценки. Лицо и изображение не сохраняются.
2«Создай коллекцию VerifEye с названием front-desk-visitors и добавь в неё лицо с изображения 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?»Если на фото изображён человек, добавленный в запросе 2, вызов verifeye_identify_face с указанием этой коллекции вернёт Existing, а также faceId и ключ. Для остальных людей результатом будет NotExisting. Новые лица не добавляются.
4«Сравни лицо на изображении https://example.com/photos/check-in.jpg с лицом visitor-1042 из коллекции front-desk-visitors».verifeye_get_face_by_key находит faceId, а verifeye_compare_face возвращает показатель сходства и вердикт VerifEye isMatch.
5«Удали лицо visitor-1042 из коллекции front-desk-visitors».verifeye_get_face_by_key находит лицо, а verifeye_delete_face безвозвратно удаляет его шаблон. Это действие нельзя отменить.

Многие клиенты запрашивают подтверждение перед выполнением вызова — например, перед добавлением или удалением лица.

Инструменты

Каждый инструмент принимает параметр region (eu или us; по умолчанию — eu), который определяет, где обрабатывается изображение и где хранится коллекция. Коллекции привязаны к регионам: коллекция, созданная в eu, недоступна из us.

ИнструментНазначениеСохраняет или удаляет данные
verifeye_identify_faceАнализирует лицо или лица на изображении и, если указать коллекцию, ищет их в нейНет
verifeye_onboard_faceДобавляет лицо или лица с изображения в коллекцию, чтобы позднее распознавать человекаСохраняет шаблон лица
verifeye_compare_faceСравнивает лицо или лица на изображении с одним добавленным лицомНет
verifeye_delete_faceУдаляет одно добавленное лицоБезвозвратно
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Возвращает временную форму для загрузки одного изображенияНет

Параметры, результаты и коды ошибок для каждого инструмента приведены в документации.

Биометрические данные и согласие

Эти инструменты обрабатывают данные лица, относящиеся к биометрическим данным. Перед выполнением вызова вы обязаны получить действительное информированное согласие и соблюдать требования законодательства о конфиденциальности и биометрических данных, применимые к людям на ваших изображениях (например, GDPR, BIPA и CCPA).

  • verifeye_onboard_face сохраняет шаблон лица, который остаётся в системе до удаления.

  • verifeye_delete_face, verifeye_reset_collection и verifeye_delete_collection безвозвратно удаляют шаблоны лиц.

  • Возраст — это оценка примерного возраста, а не юридическое подтверждение возраста. Пол — демографическая оценка, а не характеристика идентичности, заявленная самим человеком. Совпадение лиц указывает на сходство, но само по себе не подтверждает личность.

  • Вызовы инструментов выполняются от имени вашей учётной записи VerifEye и учитываются в лимитах её использования.

Ссылки