FairValid

開発者向け

MCP で AI エージェントを接続

ChatGPT、Claude、Hermes、Grok、Codex を設定し、接続を確認して、検証の利用額を管理します。

APIキーを管理APIリファレンス

クライアントを選択

エンドポイント: https://mcp.fairvalid.com/mcp。トランスポート: Streamable HTTP。

API キーまたは OAuth サインインで接続します。対象となる ChatGPT、Claude、Grok の接続では OAuth を利用できます。お使いのクライアントのアカウントおよびロールの要件を以下でご確認ください。Codex、Claude Code、Hermes は API キーによる直接接続にも対応しています。

API キーを使うクライアントの場合は、ワークスペースの Owner または Manager として APIキー でラベル付きの Test キーを作成してください。キーはクライアントの保護された認証情報、または所定の環境設定に保存してください。キーをプロンプト、ツール引数、URL、コミットされた設定ファイルに含めないでください。

OAuthフローでは、サインインと同意のためにfairvalid.comが開きます。要求された権限をカバーする既存のLive APIキーを選択し、そのワークスペースと累計上限を確認してください。承認すると、そのキーのスコープの範囲内で、要求された権限がまとめて付与されます。AIクライアントにキーを貼り付ける必要はありません。選択したキーを無効化すると、その接続も終了します。OAuthはライブキーを使用します。サンドボックスにはテストキーによる直接接続をご利用ください。

クライアントの手順は2026年10月23日に確認済みです。ホスト型MCPプロトコルは、公式SDKによる本番環境の受け入れテストに合格しています。ただし、記載されているすべてのクライアントがテスト済みという意味ではありません。ご利用前に、お使いのクライアントで接続確認を完了してください。

ChatGPT

以下のOAuth設定を使用してください。現在、カスタムMCP接続には、Web版のChatGPT BusinessまたはEnterprise/Eduと、MCPを含むプラグインを作成する権限が必要です。Businessでは管理者またはオーナーである必要があり、Enterprise/Eduでは特定のメンバーに権限を付与できます。

  1. 「プラグイン」を開き、プラスボタンを選択してから「カスタム MCP サーバーを追加」を選択します。現在のプラグインのフローでは開発者モードは不要です。
  2. 接続名を FairValid とし、公開HTTPSエンドポイントとして https://mcp.fairvalid.com/mcp を入力してください。
  3. 自動クライアント登録によるOAuthを選択してください。FairValidは公開クライアント登録を使用するため、クライアントIDやクライアントシークレットを入力する必要はありません。いずれのフィールドにもAPIキーを入力しないでください。
  4. 上記のFairValidのサインインと同意を完了してください。ChatGPTの警告を確認したうえで「プラグインとして作成」を選択し、検出された6つのツールを確認します。
  5. プラグインをインストールし、新しい会話を開いて @ を入力し、FairValid を選択します。実際の検証をリクエストする前に、下記の読み取り専用の接続チェックを実行してください。

公式ドキュメント：OpenAI：カスタム MCP サーバーを接続する · OpenAI：OAuth 認証

Claude ウェブ版・デスクトップ版

OAuthを使用したリモートのカスタムコネクタを使用します。これはClaudeのWeb版とDesktop版で共通の、アカウントに紐づいた接続で、Anthropicのサーバーを経由して動作します。TeamおよびEnterpriseでは、まず組織のOwnerがコネクタを追加します。組織ライブラリを管理できるカスタムロールを持つEnterpriseメンバーも追加できます。

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

  1. 「カスタマイズ」→「コネクタ」→「カスタムコネクタを追加」を開きます。管理対象の組織の場合は、オーナーまたは対象となる Enterprise ロールのユーザーが「組織設定」→「コネクタ」→「追加」→「カスタム」→「Web」から開始します。
  2. FairValidとhttps://mcp.fairvalid.com/mcpを入力してください。
  3. 「今すぐサインイン」を選択します。OAuthクライアントの選択肢が表示された場合は、「自動で登録」を選択してください。手動登録用のクライアントIDとシークレットのフィールドは空欄のままにしてください。
  4. fairvalid.com にログインし、選択したライブキーと権限を確認して、接続を承認してください。会話のコネクター設定から FairValid を有効にしてください。
  5. 以下の読み取り専用の接続チェックを実行してください。サンドボックスチェックは、Request headers を介してテスト API キーで接続した場合にのみ使用してください。

公式ドキュメント：Anthropic: カスタムコネクタと認証 · Anthropic: リモートコネクタの提供状況

Claude Code

Claude Codeは、APIキーによる直接接続に対応しています。Claude Codeを起動する環境でFAIRVALID_API_KEYを設定してください。最初のチェックにはテストキーを使用します。実際のシークレットはプロジェクトファイルに含めないでください。

  1. 以下の設定をプロジェクトの .mcp.json に統合してください。既存のサーバーはそのまま残してください。ファイルには環境変数の参照をそのまま記載し、キーの値は記載しないでください。
  2. FAIRVALID_API_KEY を利用できる状態で Claude Code を起動してください。プロジェクトの MCP 設定の承認を求められた場合は承認してください。
  3. claude mcp list を実行し、セッション内で /mcp を確認してください。FairValid が接続され、6 つのツールが公開されていることを確認したら、以下のサンドボックスチェックを実行してください。
{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

公式ドキュメント：Anthropic: Claude Code の MCP 設定

Hermes Agent

この手順はNousResearch Hermes Agent向けです。リモートHTTPトランスポートはBearerヘッダーに対応しています。CLIはキーをアクティブなプロファイルの.envにMCP_FAIRVALID_API_KEYとして保存し、config.yamlには環境変数への参照を保持します。

  1. 以下の add コマンドを実行してください。認証が必要かどうかを尋ねられたら「yes」と答え、マスク表示される API key / Bearer token のプロンプトにテスト API キーを入力してください。
  2. 検出されたツールを確認し、必要な FairValid ツールを有効にしてください。セットアップは正常に接続される必要があります。エラー後に無効な接続を保存しても、セットアップは完了したことになりません。
  3. hermes mcp test fairvalid を実行してから、新しいセッションを開始するか /reload-mcp を実行してください。その後、以下のサンドボックスチェックを実行してください。Hermes ではツール名にサーバー名のプレフィックスが付く場合があります。
hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

公式ドキュメント：NousResearch：MCP 設定 · NousResearch：MCP 接続チェック · NousResearch：ヘッダー認証 CLI の実装

Grok Bot と Grok

Grok Bot と Grok.com では設定画面が異なります。個人用の Grok Bot では、下記のリクエストを使って Bot に FairValid の追加を依頼してください。この方法は、情報ペインに「詳細」「ライブラリ」「コンピューター」のみが表示され、「セットアップ」セクションがない場合にも使えます。

Team Bot では、さらに Bot のオーナーまたはマネージャーに「情報ペイン → Setup → Plugins」が表示されます。この設定画面を利用するには、デスクトップアプリで Team Bot へのアクセス権が必要です。OAuth を使用する場合、各メンバーは自分のアカウントでサインインします。

Grok.com では grok.com/connectors → New Connector → Custom を使用します。https://mcp.fairvalid.com/mcp を入力し、認証を完了してください。Business および Enterprise チームでは、先に管理者によるコネクタのプロビジョニングが必要な場合があります。これは Grok Bot プラグインとは別の接続です。

xAI APIで構築したボットも別扱いです。その開発者がサーバーコードでリモートMCPヘッダーを設定します。この手順は、Grok Botに汎用のAuthorizationヘッダー入力欄があることを示すものではありません。

  1. 以下のリクエストを使って、カスタムのリモートHTTPS MCP接続を追加するようBotに依頼してください。Team Botの場合は、そのオーナーまたはマネージャーが「Setup → Plugins」から追加することもできます。
  2. When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
  3. fairvalid.comでFairValidへの同意を完了してください。必要に応じて、各チームメンバーがそれぞれ自分のアカウントを接続します。
  4. BotにFairValidのツール一覧を表示させ、以下の読み取り専用の接続チェックを実行してください。ツールが検出されただけでは、検証が完了したことにはなりません。
Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

公式ドキュメント：xAI：Grok Bot プラグインとリモート HTTPS · xAI：Grok.com カスタムコネクタ · xAI：API 開発者向けリモート MCP

Codex

CodexからAPIキーで直接接続します。Codexプロセスで利用可能な環境にFAIRVALID_API_KEYを設定し、最初のチェックにはTestキーを使用してください。単独で起動したデスクトップアプリは、ターミナルの環境を引き継がない場合があります。

  1. 以下のコマンドを実行して、リモートの Streamable HTTP サーバーを登録してください。このコマンドで保存されるのは環境変数の名前であり、API キーそのものではありません。
  2. codex mcp list を実行し、接続を読み込むために新しい Codex セッションを開始してください。セッションの MCP ツールに FairValid が表示されることを確認してください。
  3. Codex アプリを使用する場合は、その実行ホストで変数を利用できるようにし、必要に応じてアプリを再起動するか新しいセッションを開いてください。CLI での設定が成功しても、すでに実行中のアプリの環境が変更されたとは限りません。
  4. 検出された6つのツールを確認し、以下のサンドボックスチェックを実行してください。
codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

公式ドキュメント：OpenAI：Codex の MCP 設定

処理を送信する前に接続を確認してください

以下に記載の6つのツールがすべて検出されたことを確認してください。クライアントによっては、ツール名に独自の接頭辞が付く場合があります。ツールが検出されれば接続は確認できますが、検証が成功したことを示すものではありません。

OAuthまたはLive APIキーを使用する場合は、残高の権限を付与したうえで、まずエージェントに引数なしでfairvalid_get_balanceを呼び出すよう指示してください。残高の読み取りでは検証クレジットは消費されません。サンドボックスのサンプルをライブ接続で送信しないでください。

Test APIキーを使用する場合は、代わりに以下のサンドボックスでのチェック手順に従ってください。ライブ検証ではクレジットが確保・消費されることがあります。チェックする権限のあるアドレスを選び、明示的に送信をリクエストしてください。

接続に失敗した場合は、アカウントのコネクタ権限、エンドポイント、未設定の環境変数、キーまたは権限付与の失効を確認してください。権限エラーや利用上限エラーの場合は、再試行する前に付与されたスコープまたは上限を見直してください。新しい冪等キーを使っても原因は解決しません。

無料のサンドボックスチェックから始める

fv_test_キーを使用し、以下の例でfairvalid_verify_emailを呼び出してください。Testキーによる単一アドレスのチェックでは、シミュレートされた結果が直接返されます。プロバイダーへの呼び出し、本番の検証、クレジットの消費はいずれも発生しません。

その他の予約済みサンプルは undeliverable@example.com、risky@example.com、unknown@example.com、pending@example.com、error@example.com です。pending と error は意図的なシミュレーションであり、実際のメールボックス確認ではありません。単一アドレスの pending サンプルには、ポーリング対象のジョブはありません。

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

ツールと権限

fairvalid_verify_email は email と idempotency_key を受け取ります。fairvalid_submit_job は emails、idempotency_key、任意の name を受け取り、1〜5,000 件のアドレスに対応します。本番環境での送信には submit スコープが必要です。

fairvalid_get_job は job_id を受け取り、状態を読み取ります。fairvalid_get_results は job_id と、任意で cursor、filter、search を受け取り、一度に最大 50 件の結果を読み取ります。本番環境での読み取りには read スコープが必要です。

fairvalid_cancel_job は job_id を受け取り、キャンセルをリクエストします。処理中のチェックは完了する場合があります。本番環境でのキャンセルには submit スコープが必要です。fairvalid_get_balance は引数を取らず、balance スコープを持つ本番キーが必要です。テストキーでは本番のクレジット残高を読み取れません。

ワークスペースはキーによって決まります。ツールはAPIキーやワークスペースを引数として受け付けません。スコープの確認、無効化、利用上限、ワークスペースのクレジットのルールは、顧客向けAPIと同様にMCPにも適用されます。

実行中のジョブを結果まで追跡

OAuthまたはfv_live_キーを使用する場合、単一検証と一括検証のいずれも非同期ジョブとして送信されます。acceptedのレスポンスとjob_idは処理が受け付けられたことを示すものであり、メールボックスのチェックが完了したことを意味するものではありません。処理時間はキューと検証プロバイダーによって異なります。

ジョブフローをサンドボックスで試すには、予約済みのサンプルアドレスを使って fairvalid_submit_job を呼び出してください。サンドボックスのジョブでは、プロバイダーへの呼び出しやクレジットの消費なしに、状態、結果、キャンセル、リプレイを利用できます。

  1. 固定の idempotency_key を指定して 1 回だけ送信し、返された job_id を保持してください。
  2. その job_id で fairvalid_get_job を呼び出してください。ポーリングの間隔は空け、一時的なエラーが発生した場合は間隔を延ばしてください。
  3. 同じ job_id で fairvalid_get_results を呼び出してください。next_cursor が null になるまで、返された next_cursor を cursor として渡してください。カーソルは元のフィルターと検索条件を保持します。
  4. ジョブの状態と各結果の両方をご確認ください。不明、キャッチオール、チェック中の結果は、メールボックスが有効であることを示すものではありません。

作業を重複させずに再試行

どちらの送信ツールでも、8〜128文字の英字、数字、ドット、コロン、アンダースコア、ハイフンで構成される idempotency_key が必要です。応答が不確かな場合は、同じAPIキーまたはOAuth接続、同じ idempotency_key、変更していない入力で再試行してください。リプレイは基になるAPIキーの範囲で適用されます。OAuthアクセストークンをローテーションしても同じIDが維持されますが、別のAPIキーを選択して再送信すると、新たな実行が作成される場合があります。既存のべき等キーでジョブのペイロードを変更した場合は拒否されます。新しいべき等キーは、意図的に新しい実行を行う場合にのみ使用してください。

結果を読み取る前にisErrorを確認してください。顧客向けAPIに到達した呼び出しでは、そのレスポンスとHTTPステータスがstructuredContentに含まれます。引数の検証エラーではテキストコンテンツのみが返される場合があります。APIエラーのcodeを確認し、再試行のヒントがあればそれに従ってください。タイムアウトや一時的なエラーが発生しても、元の送信が行われなかったとは限りません。

ライブキーではワークスペースのクレジットを消費できます。自律型エージェントを接続する前に累計上限を設定してください。消費済みと確保済みのクレジットはどちらも上限に含まれます。完了した有効・無効のチェックは1クレジットを使用します。不明、未確定のキャッチオール、技術的な失敗では、最終的に検証のクレジットは消費されません。

さらにサポートが必要ですか?

ログインして非公開のサポートチケットを作成してください。

サポートに問い合わせる