FairValid для AI-ассистентов

Проверяйте адреса электронной почты с помощью AI-ассистента, отслеживайте задания проверки и просматривайте результаты в рабочем пространстве FairValid. Этот пакет подключается к размещённому на стороне FairValid серверу Model Context Protocol (MCP) и включает навык для работы с проверками, кредитами, повторными попытками и интерпретацией результатов.

Сервер: https://mcp.fairvalid.com/mcp

Транспорт: Streamable HTTP

Издатель и поддержка: FairValid · nayeem@fairvalid.com

Документация: fairvalid.com/help/mcp

Подключение рабочего пространства

Используйте OAuth в совместимом клиенте. Войдите в систему и подтвердите доступ на сайте FairValid, затем выберите существующий Live API key с необходимыми разрешениями. Подключение будет использовать его рабочее пространство, области доступа и лимит расходов. Владелец или менеджер рабочего пространства может управлять ключами на странице API keys. Отзыв выбранного ключа прекращает связанные с ним подключения.

Для автоматической регистрации общедоступного клиента не требуется ни встроенный секрет клиента, ни его настройка.

Не вставляйте ключи, пароли, коды OAuth или токены в чат. Если клиент использует заголовки bearer, настройте существующий ключ в защищённых параметрах учётных данных. Для тестовых данных в песочнице можно использовать прямой Test key; при подключении через OAuth сейчас доступны только Live keys.

Поддерживаемые форматы пакетов

Клиент	Конфигурация в составе пакета
Claude / Claude Code	Отдельный пакет плагина в claude
ChatGPT / Codex	Отдельный переносимый пакет плагина в openai
Grok Build	Плагин и файлы MCP, совместимые с Claude, а также общий навык
Cursor	`.cursor-plugin/plugin.json`, `mcp.json` и общий навык
Gemini CLI	Корневой `gemini-extension.json` и общий навык
Hermes Agent (Nous Research)	Нативная настройка HTTP OAuth и общий навык в разделе examples
OpenClaw	Отдельный комплект в формате Claude в openclaw
Другие клиенты MCP	Конфигурации для конкретных поставщиков в разделе examples

Наличие конфигурации пакета не означает, что он опубликован в каталоге плагинов, и не гарантирует успешное подключение во всех клиентах. Доступ к учётной записи поставщика, разрешения, проверка и принятие пакета нативным клиентом — отдельные этапы.

В Claude Code версии 2.1.275 или новее установите плагин в рамках сеанса командой

/plugin install fairvalid --marketplace moonlitnayeem/fairvalid-ai.

Для более ранних версий сначала выполните /plugin marketplace add moonlitnayeem/fairvalid-ai, затем — /plugin install fairvalid@fairvalid.

Эти команды соответствуют официальной инструкции по установке.

Каталог плагинов устанавливает отдельный пакет из папки claude/. Проверить эту папку можно командой

claude plugin validate /path/to/fairvalid-ai/claude --strict --profile directory.

Пользователи могут проверить и загрузить локальную общедоступную копию репозитория командой

claude --plugin-dir /path/to/fairvalid-ai/claude.

Для Gemini CLI можно установить общедоступный репозиторий командой

gemini extensions install https://github.com/moonlitnayeem/fairvalid-ai.

Для выполнения этих команд указанная копия репозитория или опубликованный репозиторий должны существовать.

Перед использованием инструментов ознакомьтесь с запросами клиента на подтверждение доверия и завершите подключение через OAuth.

Возможности

Инструмент	Назначение	Разрешение
`fairvalid_verify_email`	Отправить на проверку один адрес	`submit`
`fairvalid_submit_job`	Отправить на проверку пакет из 1–5 000 адресов	`submit`
`fairvalid_get_job`	Получить статус и сводку задания	`read`
`fairvalid_get_results`	Получить до 50 результатов на странице	`read`
`fairvalid_cancel_job`	Отменить оставшуюся часть задания	`submit`
`fairvalid_get_balance`	Проверить текущий баланс кредитов рабочего пространства	`balance`

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

«Покажи мой баланс кредитов FairValid».
«Покажи текущий статус и результаты этого задания FairValid».
«Проверь эти адреса электронной почты с помощью FairValid».

Последний запрос запускает реальную проверку при подключении через OAuth или Live key.

Отправляйте только те адреса, которые вы намерены проверить и имеете право обрабатывать.

Кредиты и интерпретация результатов

При отправке данных для проверки в рабочем режиме могут резервироваться кредиты и создаваться асинхронное задание. За каждую завершённую проверку со статусом Valid или Invalid списывается один кредит. За Genuine Unknown, неразрешённый результат catch-all, технические сбои и необработанные элементы кредиты не списываются. Отмена не отменяет списание за завершённые проверки; обработка уже выполняющихся запросов может продолжиться. Лимит расходов не добавляет кредиты в рабочее пространство.

Принятое задание — это ещё не завершённая проверка. Получайте обновления статуса с увеличивающимися интервалами, соблюдайте рекомендации по повторным запросам и используйте курсор результатов, чтобы прочитать все страницы. Не смешивайте ожидающие обработки и необработанные элементы с окончательными результатами. Unknown или неразрешённый результат catch-all не подтверждает действительность адреса; статус Valid не гарантирует доставку письма во входящие.

Для обоих инструментов отправки требуется стабильный idempotency_key. Если ответ не позволяет понять, было ли выполнено действие, используйте тот же выбранный API key, тот же ключ и неизменённые входные данные. Повторное подключение с другим API key может создать новое задание, даже если idempotency_key остался прежним. Не меняйте ключ и не отправляйте запрос заново с новым ключом только для того, чтобы неопределённый запрос выглядел успешно выполненным.

Тестирование подключения и приёмки

Запрос на подключение или установку не даёт разрешения проверять адреса клиентов или отменять задания. Чтобы проверить подключение OAuth с необходимыми разрешениями, найдите шесть инструментов и вызовите fairvalid_get_balance; это чтение не расходует кредиты на проверку.

В стандартных тестах отправки используется отдельное прямое подключение с Test key и документированные тестовые данные example.com. Задания в песочнице не обращаются к реальным поставщикам и не расходуют кредиты на проверку; Test keys не дают доступа к текущему балансу.

Для контролируемого приёмочного теста в рабочем режиме требуется явное разрешение владельца рабочего пространства. Используйте только согласованные тестовые адреса, рабочее пространство, выбранный Live key и установленный лимит кредитов; списание за реальные проверки и меры защиты от повторной обработки по-прежнему действуют.

Не запускайте тесты в рабочем режиме автоматически, не используйте списки адресов клиентов в качестве тестовых данных при установке и не отменяйте задания клиентов в рамках установочных тестов.

Этот пакет не устанавливает настройки хост-системы, не запускает локальные исполняемые файлы, не задаёт хуки и не содержит учётных данных. В него входят манифесты, навык для рабочих процессов, примеры и фирменные материалы. Результаты проверки клиента, протокола в рабочем режиме и нативного клиента следует фиксировать отдельно и только в соответствии с тем, что действительно было выполнено; ни один из них не означает одобрения или публикации со стороны поставщика. См. запись о статической проверке.

Политика конфиденциальности

При вызове инструмента подключённый AI-провайдер передаёт FairValid указанные адреса, идентификаторы заданий и другие аргументы инструмента. FairValid обрабатывает их в соответствии со своей Политикой конфиденциальности и Условиями использования. AI-провайдер также обрабатывает данные переписки и инструментов в соответствии со своими условиями. Перед подключением ознакомьтесь с этими документами.

Сам пакет не добавляет аналитику, локальную базу данных или дополнительные места назначения данных.

По вопросам поддержки и обработки данных обращайтесь по адресу

nayeem@fairvalid.com.

Лицензия и бренд

Код распространения, манифесты и документация доступны на условиях лицензии MIT. Названия и логотипы FairValid указывают на издателя и не предоставляют прав на товарные знаки или разрешения заявлять о поддержке другого сервиса.