VerifyAX

VerifyAX MCP サーバー

VerifyAX の公式 Model Context Protocol（MCP）サーバーです。クラウドでホストされるブリッジを介して、AI ツールから VerifyAX プラットフォーム上のエージェント登録、シナリオ生成、シミュレーション実行、評価結果の取得を、安全かつリアルタイムに行えます。

はじめに · サポート対象のツール · セキュリティ · 独自環境にデプロイ · 問題を報告

---

VerifyAX MCP サーバー公式版は、MCP 互換の AI クライアントと、エージェント評価プラットフォームのVerifyAXをつなぐブリッジです。設定すると、API スクリプトを書かなくても、自然言語でエージェントの登録、シナリオの生成、シミュレーションの実行、評価結果の取得を行えます。

VerifyAX MCP サーバーを使用すると、次のことができます。

• エージェントを登録してテストする（A2A または API）。評価の前に接続を確認できます。
• スキルタグからシナリオを生成し、1 回のツール呼び出しで完了を待つことができます。
• 評価を実行し、手動でポーリングすることなく、スコア、トランスクリプト、クレジット使用量を確認できます。

これは verifyax-api スキルを補完するものであり、置き換えるものではありません。スキルはコードを書く開発者向け、MCP サーバーは会話形式のワークフロー向けです。

目次

• サポート対象のクライアント
• サポート対象のツール
• 開始する前に
• MCP サーバーのインストール
• 仕組み
• ワークフローの例
• ヒントとコツ
• データとセキュリティ
• トラブルシューティング
• サポートとフィードバック
• 免責事項
• 開発者向け
• ライセンス

---

対応クライアント

VerifyAX MCP サーバーは、Streamable HTTP または stdio に対応した MCP 互換クライアントで利用できます。

クライアント	セットアップの参照先
OpenAI ChatGPT	コネクター／MCP ガイド
Claude（Claude.ai、Code、Desktop）	Claude MCP ドキュメント
Cursor	Cursor MCP ドキュメント
Visual Studio Code（GitHub Copilot）	VS Code MCP ドキュメント
GitHub Copilot CLI	Copilot CLI について
Google Gemini CLI	Gemini CLI MCP ドキュメント
Amazon Quick Suite	MCP 統合ガイド

mcp-remote 経由で接続できるクライアントであれば、ホストされたエンドポイント https://mcp.verifyax.com/mcp も利用できます。

重要

Claude.ai のカスタムコネクターでは、サインインなし を選択し、Authorization ヘッダーを使用してください。 このサーバーは OAuth ではなく VerifyAX API キーで認証するため、Settings → Connectors → Add custom connector で次のように設定します。

1. URL：https://mcp.verifyax.com/mcp
2. 認証：サインインなし — ダイアログでは「OAuth ではなく API キーを使用するサーバー向け」と説明されています。今すぐサインイン は選択しないでください。このサーバーは OAuth メタデータを公開していないため、OAuth を試みると失敗します。
3. Request headers で、Authorization に Bearer sk-ver-api-... を設定します。

これで 17 個すべてのツールが表示され、Claude.ai ではツールごとに承認を設定できます（読み取り専用 12 個と書き込み／削除 5 個に分類されます。generate_scenario と evaluate_agent はクレジットを消費するため、書き込み／削除のグループには承認を必須にすることをお勧めします）。

サーバー 0.3.5 以降が必要です。それ以前のビルドでは Bearer スキームの大文字と小文字を区別して照合していたため、正規化するクライアントが拒否され、「サーバーに接続できませんでした。」とだけ表示されていました。X-VerifyAX-API-Key ヘッダーはサーバーで使用できますが、Claude.ai のヘッダーフィールドではこの名前が拒否されるため、Authorization を使用してください。

ヒント

Claude の詳しいセットアップ手順と、VerifyAX のスキルおよび SDK との比較については、docs/using-verifyax-with-claude.md を参照してください。

---

サポートされているツール

ユーザーの意図に対応する17個のツールです。ブロッキングツールは内部でポーリングし、処理が完了したときにのみ結果を返します（通常は30秒～5分）。

領域	ツール	ブロッキング
エージェント	register_agent · list_agents · delete_agent	—
シナリオ	list_compatible_tags · recommend_scenario_tags · search_scenario_tags · generate_scenario · list_scenarios · get_scenario · delete_scenario	はい（generate_scenario）
評価	evaluate_agent · list_recent_runs · get_run_details · get_evaluation_report · get_run_output	はい（evaluate_agent）
使用状況	get_usage_summary · preview_run_cost	—

メモ

ツールの説明（Claude がツールを選ぶ際に参照する内容）とその根拠については、 docs/tool-descriptions.md をご覧ください。パッケージレベルのリファレンス： packages/mcp-server/README.md。

---

始める前に

要件は接続方法によって異なります。

リモート HTTP（mcp.verifyax.com でホスト）

• VerifyAX API キー（コンソールの「Settings → API Keys」）
• Streamable HTTP に対応した MCP クライアント、または mcp-remote プロキシの実行に必要な Node.js 18+

ローカル stdio（npx 経由の verifyax-mcp-server）

• Node.js ≥ 20
• クライアント設定に指定する VerifyAX API キー（VERIFYAX_API_KEY）

npm パッケージには2つのバイナリ（verifyax-mcp-server と verifyax-mcp-server-http）が含まれています。npx を使用する際は、stdio バイナリ名を明示的に指定してください。

---

MCP サーバーをインストールする

リモート HTTP（推奨）

ホストされているエンドポイント：

https://mcp.verifyax.com/mcp

initialize リクエストで VerifyAX API キーを送信してください。ホストされているサーバーはキーを保存しません。各クライアントセッションはそれぞれ独自のキーを使用します。

Cursor（ネイティブ URL — v0.48+）：

{
  "mcpServers": {
    "verifyax": {
      "url": "https://mcp.verifyax.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-ver-api-..."
      }
    }
  }
}

transport フィールドは追加しないでください。Cursor は URL から Streamable HTTP を検出します。Authorization の代わりに "X-VerifyAX-API-Key": "sk-ver-api-..." を使うこともできます。

Claude Desktop / ネイティブ HTTP に対応していないクライアント（mcp-remote）：

claude_desktop_config.json に追加します（「Settings → Developer → Edit Config」）：

{
  "mcpServers": {
    "verifyax": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.verifyax.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${VERIFYAX_AUTH}"
      ],
      "env": {
        "VERIFYAX_AUTH": "Bearer sk-ver-api-..."
      }
    }
  }
}

このサーバーは Streamable HTTP のみを使用し、レガシーな SSE には対応していないため、--transport http-only を使用してください。Authorization の代わりに --header 経由で X-VerifyAX-API-Key: sk-ver-api-... を渡すこともできます。

設定を変更した後は、MCP クライアントを再起動してください。

ローカル stdio

Claude Code:

claude mcp add verifyax --env VERIFYAX_API_KEY=sk-ver-api-... -- npx -y -p @verifyax/mcp-server verifyax-mcp-server

メモ

ここでは意図的にバージョンを固定していません。そのため、このコマンドは常に最新のサーバーを取得します。 正確なバージョンを固定しているのは verifyax-mcp プラグインのみです（@verifyax/mcp-server@<plugin version>）。マーケットプレイスのプラグインでは、プラグインのバージョンが上がったときにのみ、新しいサーバービルドがユーザーに提供されることが保証されるためです。手動で設定する場合はそのような保証がないため、最新リリースを追跡するのが適切なデフォルトです。再現性が必要な場合は、独自にバージョンを固定してください：-p @verifyax/[email protected]。

パッケージには2つのバイナリ（verifyax-mcp-server、verifyax-mcp-server-http）が含まれており、どちらもパッケージ名と一致しないため、-p … verifyax-mcp-server でバイナリ名を明示しています。そのため、npx -y @verifyax/mcp-server のみを指定すると、「could not determine executable to run」エラーが発生します。

Claude Desktop:

{
  "mcpServers": {
    "verifyax": {
      "command": "npx",
      "args": ["-y", "-p", "@verifyax/mcp-server", "verifyax-mcp-server"],
      "env": { "VERIFYAX_API_KEY": "sk-ver-api-..." }
    }
  }
}

設定を変更した後はクライアントを再起動し、実行したい内容を自然言語で説明してください。

---

仕組み

アーキテクチャと通信

1. MCP クライアントは https://mcp.verifyax.com/mcp（リモート HTTP）に接続するか、npx -p @verifyax/mcp-server verifyax-mcp-server（ローカル stdio）を起動します。
2. クライアントは初期化時にお客様の VerifyAX API キーを送信します（HTTP の場合は Authorization: Bearer … または X-VerifyAX-API-Key、stdio の場合は VERIFYAX_API_KEY 環境変数）。
3. サーバーはお客様に代わって VerifyAX API を呼び出します。ブロッキングツール（generate_scenario、evaluate_agent）は内部でジョブのステータスをポーリングし、処理が完了してから結果を返します。

権限と料金

• アクションの範囲は、API キーに紐付けられたワークスペースです。
• 使用量とクレジットは、MCP サーバーの運用者ではなく、お客様の VerifyAX ワークスペースに課金されます。
• ホスト型サーバーはテレメトリーを送信せず、セッション間で API キーを保持しません。

セルフホスティング

同じ HTTP サーバーをご自身のインフラストラクチャ（例：Google Cloud Run）で実行します。 deploy/gcp/README.md を参照してください。

---

ワークフローの例

接続したら、タスクを自然言語で説明してください。使用するツールはクライアントが選択します。

エージェントの設定

• 登録：「A2A エージェントを https://my-agent.example.com に登録し、アクセス可能であることを確認してください。」
• 一覧表示：「ワークスペースに登録されているエージェントを教えてください。」

シナリオの作成

• タグの確認：「インタビューシナリオで使用できるスキルタグを一覧表示してください。」
• 生成：「empathy と coordination のタグを付けた info_exchange シナリオを生成してください。」

評価

• 評価の実行：「エージェント X をシナリオ Y に対して評価し、スコアを要約してください。」
• 履歴の確認：「直近のシミュレーション実行の詳細を表示してください。」

使用量と費用

• 事前確認：「このシナリオを自分のエージェントに対して実行するには、何クレジットかかりますか？」
• 概要：「直近5回のシミュレーション実行にかかった費用を教えてください。」

メモ

ブロッキングツールの処理には30秒〜5分かかる場合があります。繰り返し呼び出さず、結果が返るまでお待ちください。

---

ヒントとコツ

AGENTS.md にデフォルトを追加する

プロジェクトのルートにある AGENTS.md ファイルに以下を追加すると、確認のための呼び出しや不適切なタグの組み合わせを減らせます（書式についてはAGENTS.md の規約を参照してください）。

## VerifyAX MCP

When connected to verifyax:

- **MUST** call `recommend_scenario_tags`, `search_scenario_tags`, or `list_compatible_tags` before `generate_scenario`
- **MUST NOT** combine QnA tags with other tags (QnA must be the sole tag)
- **MUST** use `preview_run_cost` when the user asks about credits before `evaluate_agent`
- Blocking tools (`generate_scenario`, `evaluate_agent`) take 30s–5min — do not retry manually

コードのワークフローにはスキルを使用する

スクリプト、CI、またはカスタムの複数ステップのロジックには、MCP ツールの代わりに verifyax-api スキルまたは @verifyax/sdkを使用してください。

---

データとセキュリティ

• ホスト型エンドポイントへのすべての通信には**HTTPS（TLS）**が使用されます。
• 認証にはAPI キーを使用します。すべてのアクションで VerifyAX ワークスペースの権限が適用されます。
• ホスト型サーバーは API キーを保存しません。各セッションで個別にキーを指定します。
• MCP サーバーはテレメトリーを送信せず、VerifyAX API とのみ通信します。
• 破壊的なツール（delete_agent、delete_scenario）はリソースを完全に削除します。呼び出す前にユーザーに確認してください。

API キーはVerifyAX コンソール（Settings → API Keys）で管理します。アクセスをすぐに遮断するには、そこでキーを無効にしてください。

---

トラブルシューティング

• 「VERIFYAX_API_KEY is not set」 — キーがサーバーに届いていません。（stdio）の env ブロック、または HTTP の Authorization ／ X-VerifyAX-API-Key ヘッダーを確認してください。
• 認証に失敗する — キーが無効、取り消し済み、または別の環境のものです。コンソールで新しいキーを発行してください。
• ツール呼び出しが表示されない — MCP クライアントは起動時にツールを読み込みます。サーバーを追加した後、クライアントを再起動するか、新しいセッションを開始してください。
• Cursor で HTTP 接続に失敗する — mcp-remote に --transport http-only を指定して試すか、URL が /mcp で終わっていることを確認してください。
• ログを確認したい場合 VERIFYAX_MCP_LOG_LEVEL=debug を設定してください。ログは構造化 JSON 形式で stderr に出力されます。stdout は MCP プロトコル専用です。

---

サポートとフィードバック

このプロジェクトは、Conscium の VerifyAX チームが保守しています。

• バグ報告と機能リクエスト： issue を作成する
• 開発者向け資料： CONTRIBUTING.md（メンテナーとフォーク向け）
• 外部からのプルリクエストは受け付けていません — お問い合わせには issue をご利用ください

---

免責事項

MCP クライアントは、VerifyAX API キーとワークスペースのクレジットを使用して、エージェントの登録、シナリオの生成、評価の実行、リソースの削除を行えます。最小権限（スコープを限定したキー、必要最小限のワークスペースアクセス）を使用し、影響の大きい操作は確定前に確認してください。不要になったキーは取り消してください。

Model Context Protocol は AI エージェントを外部ツールに接続し、強力なワークフローを実現しますが、構造的なリスクも生じます。大規模言語モデルは、プロンプトインジェクションや関連する攻撃に対して脆弱な場合があります。信頼できる MCP クライアントと MCP サーバーのみを使用し、各エージェントがアクセスできるツールを確認してください。

---

開発者向け

このリポジトリは、2 つのパッケージで構成された pnpm モノレポです。

パッケージ	説明
@verifyax/sdk	VerifyAX REST API 用の型付き TypeScript クライアント
@verifyax/mcp-server	SDK を基盤とする MCP サーバー（17 個のツール）

Node ≥ 20 と pnpm 10 が必要です。

pnpm install      # install workspace dependencies
pnpm build        # build all packages (topological order)
pnpm test         # run unit tests
pnpm lint         # lint
pnpm format       # format with prettier

ネットワーク接続が必要なテストスイート：pnpm test:integration（ライブ API を使用するため、VERIFYAX_TEST_KEY が必要です）と pnpm test:conformance（ビルド済み MCP サーバーを stdio 経由で起動します）。

• MCP Inspector： docs/debugging-mcp-inspector.md
• 実行計画： docs/PLAN.md
• アーキテクチャ上の決定事項： CLAUDE.md
• Cloud Run のデプロイ： deploy/gcp/README.md

---

ライセンス

Apache-2.0。詳細は LICENSE を参照してください。