Nymrel

Nymrel ホスト型 MCP

https://mcp.nymrel.com/mcp の本番ソースです。

公開サーバーでは、意図的に認証情報不要の読み取りツールを 4 つだけ公開しています。

• nymrel_audit_website
• nymrel_find_domain
• nymrel_golf_bag_gap
• nymrel_social_clip_score

ベンダー提供のクライアントには追加の Nymrel API コントラクトが含まれていますが、プロバイダーまたは認可の境界が本番利用に対応するまで、ホスト型エントリーポイントでは tools/list から除外しています。

結果コントラクトと監査アプリ

公開されている 4 つのデータツールでは、成功時およびエラー時の出力スキーマが明示されています。 有効な上流ペイロードでは、元のフィールドとエビデンスが保持されます。測定値が欠落している場合、または無効な場合は、isError: true とともに INVALID_RESULT が返されます。安全な上流エラーにも MCP のエラービットが付与されます。テキスト結果と構造化結果は一致します。

NYMREL_AUDIT_UI_ENABLED=true にすると、匿名で読み取り専用の 5 つ目のツール nymrel_render_website_audit と ui://nymrel/website-audit-v1.html が追加されます。このフラグはデフォルトでオフです。まず監査ツールを呼び出し、次にその成功結果と要求された URL をレンダラーに渡してください。レンダリングではネットワークリクエストは発生せず、呼び出し元が提供したデータの出所も認証されません。データツールは UI がなくても引き続き利用できます。ビューでは測定値が欠落している場合は不明と表示し、レポートのすべてのコンテンツにテキストノードを使用します。

ホスト型アセットは api/assets/audit-widget.html です。以前の TypeScript ハーネスにある、より高機能な署名付きレポート形式とは独立しています。ロックされた Node 依存関係と Playwright Chromium をインストールした後、リポジトリのルートから node scripts/audit-ui-smoke.mjs を実行して、ホスト型アセットをテストしてください。CI では Linux／Node 24 上で、この合成ホストテストを実行します。これは ChatGPT の受け入れテストの代わりにはなりません。

デプロイ後、scripts/verify_live_contract.py --public-results を実行して、新しい出力スキーマを必須にしてください。レビュー用デプロイでビューを有効にした後は --audit-ui を追加してください。これにより、正確なカタログ、リソースのメタデータ、合成レンダリングが検証されます。Remote 読み取りが有効なデプロイでは、--remote-read --issuer https://nymrel-remote-production.up.railway.app も指定してください（issuer の末尾にスラッシュは付けません）。リリースを比較する場合、検証ツールは引き続き、以前のライブカタログと互換性のあるデフォルト設定を使用します。

本番環境で UI を有効にする前に、ChatGPT のツールカタログを更新し、evals/workflow-adoption-cases.json を実行してください。データからビューへのフロー、テキストへのフォールバック、モバイル、テーマの変更、エラー、信頼できないページコンテンツを検証します。デプロイしたコミット、ホスト、タイムスタンプ、エビデンスを記録してください。フラグを false に設定すると、ビューをロールバックできます。コントラクト変更全体をロールバックするには、直前のリリースを再デプロイしてください。

Remote 読み取りでは、バックエンドのペイロードが保持されます。保留中の結果には、曖昧さのない空でない call.id または callId が含まれている必要があります。不正な保留中の結果はフェイルクローズされます。_meta["nymrel/readState"] は再開用ツールを指定し、元の操作の再送信を禁止します。プラグインスキルでは、1 ターンあたりのステータス確認を 3 回までに制限します。プロキシ自体が行うバックエンド呼び出しは 1 回だけで、自動再試行はしません。

ソースに基づく判断、検証、残るターゲットホストのゲートについては、../docs/chatgpt-workflow-adoption-2026-09-29.md を参照してください。

公開ツールワークベンチ

NYMREL_TOOLS_UI_ENABLED=true を設定すると、ほかの機能とは独立して nymrel_open_tools と ui://nymrel/tools-v1.html が追加されます。オープナーは、グローバルナビゲーションまたは スレッドから {} を受け取り、4 つのツールのカタログのみを返します。起動時に分析は実行されません。 ビューでは同梱の MCP Apps SDK を使用し、フォーム送信時に既存のデータツールを呼び出します。 フルスクリーンのみをサポートし、ホストのテーマとディープリンクを適用します。アプリ内の設定では、 このブラウザーで表示方法のみを保存します。送信された入力と結果は保存されません。ホストが対応している場合は、 別のユーザーボタンで、選択した結果を会話コンテキストに追加できます。

ホストによる受け入れが完了するまでは、このフラグはデフォルトでオフです。ルートから npm run test:ui を実行し、実際のホスト環境でのワイヤーテストを行ってください。verify_live_contract.py --tools-ui は、有効なカタログ、エントリーポイント、起動、リソース、表示／CSP メタデータが正確であることを確認します。 --audit-ui や --remote-read --issuer ... と組み合わせて実行できます。 プラグインファミリーの一覧と受け入れマトリックスについては、拡張機能の記録を 参照してください。

アクティベーションを保留するプライベートハンドオフアダプター

このソースには、同じ @Nymrel MCP タグの背後で、将来提供予定の認証が必要な 2 つのツール用アダプターも含まれています。 デフォルトでは無効です。

• nymrel_submit_private_handoff
• nymrel_get_private_handoff_status

公開コントラクトとプライベートコントラクトは分離されています。4 つの本番ツールは 引き続き匿名での読み取り専用です。プライベートな送信／ステータス確認の呼び出しでは、呼び出し元のトークンを 直接の FastMCP RemoteAuthProvider で検証したうえで、受け入れ済みの /api/agent/v1/handoffs REST コントラクトにプロキシします。MCP レイヤーでは、ツールの引数としてベアラートークンを 受け取らず、共有サーバー認証情報を保持せず、プロジェクトを選択せず、実行権限を付与しません。

NYMREL_PRIVATE_HANDOFF_MCP_ENABLED=true のみを設定しても、ブリッジは有効化されません。 NYMREL_PRIVATE_HANDOFF_OAUTH_ISSUER には、Nymrel が所有するルートレベルの HTTPS OAuth 発行者を指定する必要があります。 その JWKS は /oauth2/jwks に配置されている必要があります。エッジは https://mcp.nymrel.com/mcp を対象とする RS256 JWT のみを受け入れ、その後、呼び出されたプライベートツールで 宣言された単一の正確なスコープを適用します。Nymrel REST API も同じクレームを個別に検証し、 安定したプロバイダーの sub を失効ポリシーおよびプロジェクト許可リストのポリシーに対応付けます。 無関係なプロバイダーのトークンは 401 で拒否され、有効化とはみなされません。プロバイダーのシークレット、 本番トークン、テスターの識別情報、実際の顧客コンテンツは、ソース管理に含まれていません。

固定された FastMCP 3.4.10 の統合では、OpenAI が必須とするトップレベルの securitySchemes フィールドをフレームワークの暗黙的な動作に委ねません。ホストの list-tools アダプターが このフィールドを明示的に公開し、古いクライアント向けに _meta にも同じ値を保持します。 コントラクトテストでは、すべての公開ツールに noauth が設定され、各プライベートツールには正確な OAuth スコープが 設定されていることを必須とします。また、このアダプターは、プライベートツールの呼び出しで有効なトークンまたはスコープが 不足している場合に、完全な _meta["mcp/www_authenticate"] チャレンジを返します。 本番環境での有効化前に、対象クライアントでの OAuth カナリアテストを必ず実施してください。

検証

デプロイ可能なランタイムは Python 3.13 に固定されています。クリーンな環境を作成し、レビュー済みのランタイムと テストツールをインストールしてください。

py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip==26.2.1
.\.venv\Scripts\python.exe -m pip install -r requirements-test.txt
.\.venv\Scripts\python.exe -m pip check
.\.venv\Scripts\python.exe -m ruff check --config pyproject.toml api tests
.\.venv\Scripts\python.exe -m compileall -q api
.\.venv\Scripts\python.exe -m pytest tests -q
.\.venv\Scripts\python.exe -m pip_audit --strict --progress-spinner off -r requirements.txt

プライベートアダプターの合成データ限定ゲートは次のとおりです。

.\.venv\Scripts\python.exe -m pytest tests/test_private_handoff.py -q

デプロイ

このディレクトリを既存の nymrel-mcp Vercel プロジェクトにリンクし、テストを実行してから、 既存の保護されたリリース手順に従い、このクリーンなコミットからデプロイしてください。 本番エイリアスの準備が整ったら、tools/list と、公開されている各ツールの呼び出しが 1 回ずつ成功することを確認してください。 ソース、PR、またはローカルテストの結果は、デプロイの証明にはなりません。

個別の同意、保持期間、AuthKit テナント、テスターのサブジェクト、専用ストレージ、プロジェクト許可リスト、 および本番環境での合成データ用ゲートが承認されるまで、プライベート機能をデプロイしないでください。 それまでは、本番環境で確認できるツールは公開ツール 4 つのみです。