AdaptOrch

AdaptOrch MCP

adaptorch.com · adaptorchctl 韓国語ガイド · 設定 · ツール · Claude Code ガイド · 公開 · 論文

AdaptOrch MCP は、AdaptOrch 用の MCP アダプターです。Claude Code やその他の MCP クライアントから、ホストされたコントロールプレーンに作業を送信し、取得可能な実行ステータス、範囲を限定した観測結果、アーティファクトへの参照を返します。ルーティングと実行はエンジンが担います。トレースへのアクセスには明示的な full プロファイルが必要です。このアダプターは、研究用途に限定された推論テープのリプレイ API を公開しません。

コーディングエージェントがパッチは動作すると言っていて、マージ前にその証拠を確認したい場合や、タスクが大きすぎる、曖昧すぎる、あるいは単一の一度きりの応答に任せるにはコストがかかりすぎる場合にご利用ください。

Claude Code → AdaptOrch MCP → route topology → run with synthesis → retrieve artifacts

API キーを取得する

AdaptOrch では認証が必要です。次の 2 つの手順でトークンを取得してください。

1. サインアップ → adaptorch.com/app/signup
2. API キーを作成 → adaptorch.com/app/api-keys → キーを生成します（ado_ で始まります）

そのキーを ADAPTORCH_CONTROL_PLANE_TOKEN として使用します。

export ADAPTORCH_CONTROL_PLANE_TOKEN="ado_..."
export ADAPTORCH_API_KEY="$ADAPTORCH_CONTROL_PLANE_TOKEN"

モデルを使用するホスト実行には BYOK が必要です。プロバイダーの認証情報はローカル環境に保管してください。

export ADAPTORCH_MCP_PROVIDER="openai"
export ADAPTORCH_MCP_PROVIDER_MODEL="gpt-4.1-mini"
export ADAPTORCH_MCP_PROVIDER_API_KEY="<provider-api-key>"

これらの値は MCP ツールの引数や JSON 本文のフィールドではありません。ローカルラッパーは実行の送信ヘッダーにのみこれらを付与し、エラーからプロバイダーキーを秘匿します。直接 HTTP クライアントでは、設定したヘッダーが他のリクエストにも付与される場合があります。クライアントのシークレット処理設定を確認してください。

OAuth BYOK（現行ソース）： openai_codex は、呼び出し元が所有する OAuth アクセストークンを同じキー欄で受け付けます。その場合は ADAPTORCH_MCP_PROVIDER_AUTH_TYPE=oauth と ADAPTORCH_MCP_PROVIDER_ACCOUNT_ID=<your-account-id> を設定します。長時間稼働するローカル MCP では、静的なキーの代わりに ADAPTORCH_MCP_PROVIDER_API_KEY_COMMAND=<trusted-token-helper> を使用できます。このヘルパーは呼び出し元が用意し、新しいアクセストークンのみを出力する必要があります。ログインと更新はクライアント側で行います。更新トークン、Cookie、認証ファイル全体は絶対に送信しないでください。コントロールプレーンとローカルエンジンの両方が、このソース契約に対応している必要があります。RQ ディスパッチは、引き続きリクエストスコープの認証情報を拒否します。

サインアップ → MCP → ダッシュボードの実行一覧

1. /app/signup でサインアップし、/app/api-keys を開きます。
2. ado_* キーを生成し、未加工の値を一度だけコピーします。
3. ローカルの MCP 環境でのみ、ADAPTORCH_CONTROL_PLANE_TOKEN として設定します。
4. Claude Code から adaptorch_run または adaptorch_list_runs を実行します。
5. ダッシュボードの /app/runs を更新すると、同じテナントの実行一覧を確認できます。

한국어 요약: 가입 → /app/api-keys에서 ado_* 생성 → MCP env에 설정 → Claude Code에서 실행/목록 확인 → 대시보드 /app/runs에서 같은 실행 목록 확인.

トークン	目的	入手方法
ADAPTORCH_CONTROL_PLANE_TOKEN	AdaptOrch API 呼び出しすべて（実行、ステータス、アーティファクト）	サインアップ後にダッシュボードで入手
ADAPTORCH_MCP_HTTP_AUTH_TOKEN	ローカルの HTTP MCP エンドポイントを保護します	自分で設定します（安全な文字列なら何でも可）

プラン料金と月間実行クォータは、インストール済みパッケージではなく、ホスト型プランカタログに基づきます。BYOK プロバイダーへの料金は AdaptOrch のサブスクリプションとは別です。AdaptOrch キーはプロバイダーキーではありません。

エンジンに委譲される任意のアルゴリズム制御（最新）

AdaptOrch MCP は、任意のアルゴリズム制御をインストール済みの adaptorch エンジンに転送します。このラッパーはこれらのアルゴリズムを実装していません。これらはクイックスタートの既定値ではなく、ベンチマーク／評価やオペレーター向けの制御として扱ってください。

制御	対象範囲	検証済みの動作
ADAPTORCH_REPRODUCIBLE	ベンチマーク／評価のベータ機能	ベンチマークの時計／RNG ソースを固定し、記録のタイミング／パスの各フィールドを正規化します。ライブプロバイダーの出力、並列スイートの記録順序、カセット、トレース、レポートのタイミング集計は対象外です。
manifest_canonical_sha256	ベンチマークマニフェスト	adaptorch.benchmarking.manifest_canonical_sha256 としてインポートできます。正規化された非揮発性のマニフェストフィールドをハッシュ化します。
ADAPTORCH_ROUTER_ACCURACY_GATE	オンラインルーター	既定値は point です。wilson は、学習済みモデルの採用に Wilson 下限を使用します。retrain_window、min_loo_accuracy、min_posterior、quality_floor、use_quality_weights、use_failure_evidence、exploration_rate、max_observations、cv、kfold_k などのオペレーター向け設定と組み合わせてください。
pass_rate_credit / quality_signal	オンラインルーターの学習	compute_quality は、ファジーマッチングの前に完全一致する回答トークンの照合を試みます。pass_rate_credit はオプトインの部分クレジットです。既定で AdaptOrchEngine のルーターフィードバックが変わるとは主張しないでください。
ADAPTORCH_PAPER_SEMANTIC_WEIGHT	合成	既定値は 0.35 です。意味的重みが 0 以外の場合、および CJK／ハングルの入力がある場合は、ネイティブの高速パスではなく Python によるスコアリングを使用します。
prefer_multi_model_ensemble_singleton	ルーティングのしきい値	3 状態です。未設定の場合、アンサンブルプロバイダーが少なくとも 2 つあり、合成モードが direct 以外であれば自動的に有効になります。ただし、明示的な debate-singleton の設定が優先されます。明示的な false は自動設定を無効にします。MCP ヒントの prefer_ensemble_singleton は、同じ意味で true／false／null を受け付けます。
synthesis_mode	合成	サポートされているモードは paper、robust、robust_lite、stable_hybrid です。fourier_aggressive は stable_hybrid の別名です。サービング専用の auto は制御プレーンに選択を依頼するもので、エンジンの追加アルゴリズムではありません。
output_extractor	アンサンブル抽出	エンジンの抽出器は final_answer と multiple_choice_letter です。MCP の値 none は「抽出器なし」を意味し、転送されません。
verification_status	エビデンスレポート	GET /v1/runs/{run_id}/evidence は、execution_status、verification_status（NOT_RUN、PASSED、FAILED、INCONCLUSIVE）、verification_source（vera_v2、verification_items、none）を追加します。検証チェックがすべて PASSED の場合にのみ PASSED となります。実行レベルのチェックが単独である場合は実行状況が報告されるため、判定は NOT_RUN のままです。adaptorch-client 0.1.5 はこの 3 つすべてを型定義していますが、それより古いサーバーでは None のままです。
is_training_eligible	オンラインルーターの学習	verification と gold_label の結果ソースのみが、ナイーブベイズルーターの学習、または LinUCB バンディットの更新に使用されます。自己一貫性および未記録のソースは保存されますが、報酬は与えられません。バンディットの状態はバージョン 2 として保存され、バージョン 1 のファイルでは、対象となる観測値のみが再生されます。
ADAPTORCH_EVIDENCE_BASIS_ENABLED	制御プレーンのスイッチ	既定ではオフです。制御プレーンで有効にすると、GET /v2/runs/{run_id}/evidence にチェックごとの basis が追加されます。このラッパーのリモートプロファイルでは、エンジンの include_evidence_basis 引数は公開されません。

研究論文

AdaptOrch MCP は AdaptOrch の研究系列に基づいています。arXiv で論文をご覧ください。

• 要旨ページ：arxiv.org/abs/2602.16873
• HTML 版論文：arxiv.org/html/2602.16873v1

_{図のプレビューは arXiv の HTML 版を参照しています。}

## インストール

利用方法は3つあります。エージェント、プログラム、ターミナルのどれに該当するかに応じて選んでください。

リリース状況（2026-09-20）： adaptorch-mcp 0.5.2 は、 adaptorch-mcp-client ランチャーと adaptorch[api]>=0.1.2,<0.2 依存関係を含めて公開されています。 クライアント専用の代替パッケージ adaptorch 0.2.0 は公開されていません。以下に記載する新しい SDK のポーリング機能とレスポンス安全性機能は、このソースリビジョンについての説明です。これをプッシュしても、PyPI のバージョンが再公開されたり、以前のライセンス付与が取り消されたりすることはありません。

ソースの更新（2026-10-26、公開ではありません）： ワークスペースのエンジンのピンを a490658c に移動しました。これは、エンジンのランブックにホスト型 コントロールプレーンで稼働中と最後に記録されていたリビジョンです。 adaptorch-client と adaptorch-cli 0.1.5 は、読み取り時にキープアライブ接続を再利用し（TLS 1.2 以上、クライアントごとの CA ストア読み込みは1回）、証拠検証の判定を型付けし、大きなレスポンスの解析を約2倍高速化します。ローカル MCP コネクターも同じトランスポートを共有し、HTTP リスナーには上限が設けられました。また、adaptorchctl run wait は --timeout を遵守するようになりました。 ネットワークとトランスポートに関する注意事項を参照してください。

ソースの更新（2026-09-08、公開ではありません）： このチェックアウトでは、リクエスト単位の SDK BYOK、上限付きの読み取り専用ポーリング、サブジェクトにバインドされたレスポンス、型付きアルゴリズム観測が追加されています。ローカル MCP ファサードは、再試行を行わずリダイレクトを無効にしたトランスポートを使用し、プライベートな診断情報を公開せずに、リクエストされたモードと選択されたモードを保持します。クライアントの契約と検証記録を参照してください。

1. ホスト型 MCP — インストール不要（推奨）

コントロールプレーンは、https://adaptorch.com/mcp で HTTP 経由の MCP を提供しています。HTTP MCP に対応するクライアントであれば、ado_* キーを使って直接接続できます。

: "${ADAPTORCH_API_KEY:?Set your AdaptOrch API key}"
: "${ADAPTORCH_MCP_PROVIDER:?Set your provider}"
: "${ADAPTORCH_MCP_PROVIDER_MODEL:?Set your model}"
: "${ADAPTORCH_MCP_PROVIDER_API_KEY:?Set your provider key}"
claude mcp add --transport http adaptorch https://adaptorch.com/mcp \
  --header "Authorization: Bearer ${ADAPTORCH_API_KEY}" \
  --header "X-Provider: ${ADAPTORCH_MCP_PROVIDER}" \
  --header "X-Provider-Model: ${ADAPTORCH_MCP_PROVIDER_MODEL}" \
  --header "X-Provider-Key: ${ADAPTORCH_MCP_PROVIDER_API_KEY}"

モデルを使った実行を設定する前に、上記の4つの環境変数をすべて設定してください。CLI は、これらの役割に ADAPTORCH_API_KEY、ADAPTORCH_PROVIDER、ADAPTORCH_PROVIDER_MODEL、ADAPTORCH_PROVIDER_API_KEY を使用します。シェル展開によってヘッダーの値がクライアント設定に保存される場合があります。そのファイルは非公開にし、決してコミットしないでください。

ツールの検出で確認できるのは接続性であり、モデルの実行やテストの合格ではありません。 ホスト型サービスは、サポート対象の実行記録と利用可能な成果物を提供します。 リポジトリのコマンドチェックには、別途設定された実行環境が必要です。 ホスト環境で共有するコマンド検証は、デフォルトで無効になっています。

Cursor、Codex、Gemini CLI、VS Code、Windsurf の設定例：https://adaptorch.com/mcp-docs。

stdio のみに対応するクライアント（Claude Desktop、古い Cursor ビルド）からは、mcp-remote を介して同じエンドポイントに接続できます。AdaptOrch のインストールは不要です。

{
  "mcpServers": {
    "adaptorch": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://adaptorch.com/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer ado_..." }
    }
  }
}

（args 内のスペースがクライアントによって正しく扱われない場合の回避策として、スペースなしの Authorization:${...} と、env 内の値を使用する方法がドキュメントに記載されています。）

2. Python SDK — ホスト型 API、標準ライブラリのみ

pip install adaptorch-client

adaptorch-client には実行時依存関係がなく、機能、ID、実行の送信／一覧表示／詳細表示／キャンセル、証拠、成果物の一覧表示に対応しています。現在のソースでは、ホスト型 BYOK 用に、送信ごとの ProviderCredential が追加されています。リポジトリへのプッシュと PyPI リリースは別のものです。ソースのインストールと BYOK の例を参照してください。

3. このパッケージ — ローカルエンジンが必要

adaptorch-mcp は AdaptOrch 親エンジンをプロセス内でラップします。互換性のあるエンジンがインストールされている環境向けです。このパッケージの依存関係によって、公開済みの 0.1.x エンジンがインストールされます。上記のホスト型エンドポイントにはローカルエンジンは不要です。

uvx --python 3.12 --from adaptorch-mcp==0.5.2 adaptorch-mcp-client --help

Claude Code のユーザーがすぐに効果を実感できる理由

初回実行で得られるメリット	ツール	チャットで変わること
証明の曖昧さを軽減	adaptorch_get_run	Claude は、セレクターの内部情報を公開したり、PASS を証明として扱ったりすることなく、範囲を限定した Correctness Wall のビューを確認できます。
複数ステップの実行	adaptorch_run	タスクをエンジンのルーティングおよび合成経路に委任し、報告された結果を確認できます。
成果物の検出	adaptorch_get_artifacts	正しさの証明として扱うことなく、利用可能な成果物の参照を取得できます。
より安全なセットアップ支援	adaptorch-mcp-doctor	ユーザーはトークンを漏らすことなく、編集済みの診断情報を貼り付けられます。
高速なインストールサイクル	adaptorch-mcp-smoke	initialize + tools/list により、ローカルの MCP 接続設定を検証できます。

測定結果：方向性を示すペア比較結果と、未達成のゲート

両方の条件で同じ 30 件、同じシード、同じセッション（Cerebras 上の gemma-4-31b）を使用するため、ペア差分によって実行ごとの変動が相殺されます。

条件	正解率
ベースライン（堅牢、検証ゲートなし）	86.7%
AdaptOrch 検証ゲートあり	100.0%

この台帳ファミリーでのペア差分は +13.3pp、95% CI は [+3.3, +26.7] です。 集計判定および事前定義されたファミリーゲートは通過しませんでした。公開されている エビデンス JSON には、 significant=false、aggregate_significant=false、gate_passed=false、 official_claim_allowed=false が記録されています。これは方向性を示す結果であり、証明済みの結果ではないとお考えください。

対象範囲：合成台帳スイートを用いた、再現可能な内部回帰エビデンス （エビデンス実験 paired_confirmatory_ledger。全実行 ID と再現コマンドは コアリポジトリに同梱）。公式のサードパーティベンチマークではありません。

ホスト型カーネルでご自身のワークロードを実行できます。 adaptorch.com — $0 の Starter プランには API キーと 月 50 回の実行枠が含まれます。BYOK プロバイダーの使用料は別途請求されます。 最新の上限についてはプランカタログをご確認ください。

シナリオベンチマークの推定

_{信頼度で重み付けしたシナリオ推定（8.0/10）。推定される向上幅であり、測定済みのベンチマーク結果ではありません。}

アーキテクチャ

パッケージ

パス	パッケージ	用途
packages/adaptorch-mcp	adaptorch-mcp	adaptorch.mcp_server を利用する Python CLI ラッパー

このラッパーは、実行時の動作を意図的に adaptorch.mcp_server に委任します。これにより、MCP ツール、リソース、プロンプト、安全性チェック、トランスポートを、最新の AdaptOrch コアリリースに揃えられます。

クイックスタート

ローカル開発

git clone [email protected]:dmae97/Adaptorch-MCP.git
git clone [email protected]:dmae97/adaptorch.git  # alongside Adaptorch-MCP
cd Adaptorch-MCP
uv sync --all-packages --extra dev
uv run adaptorch-mcp --help

uv.lock では、公開済みの adaptorch git リビジョンがエンジンとして固定されています。ローカルのエンジンチェックアウトに対してラッパーを検証するには（アルゴリズムの同等性および MCP BYOK の実行）、固定バージョンの上にインストールします。

make engine-local ENGINE_PATH=../adaptorch
make check

エンジンとの合成モード、非推奨のエイリアス、トポロジー、出力抽出器に差異がある場合、packages/adaptorch-mcp/tests/test_engine_algorithm_parity.py はフェイルクローズします。

stdio MCP

Claude Code などのローカルクライアントやデスクトップ MCP ホストには stdio を使用します。

export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
adaptorch-mcp --transport stdio --base-url https://adaptorch.com

SSH 経由の stdio

別のマシンでラッパーを実行するには、SSH に stdio を中継させます。トークンはコマンドラインではなく、そのホストの環境変数に設定し、リモートシェルが何も出力しないようにしてください。

claude mcp add adaptorch -- ssh -T build-host /opt/adaptorch/bin/adaptorch-mcp \
  --transport stdio --base-url https://adaptorch.com

• -T は疑似端末を無効にするため、CR/LF の変換やエコーが JSON-RPC ストリームに届きません。ログインバナーやリモートの rc ファイル内の echo はストリームを破損させます。
• SSH はデフォルトでは ADAPTORCH_CONTROL_PLANE_TOKEN を転送しません。リモートホストで設定するか、SendEnv／AcceptEnv で明示的に許可してください。
• クライアントを設定する前にパスを確認してください。 adaptorch-mcp-smoke --command "ssh -T build-host /opt/adaptorch/bin/adaptorch-mcp"。 スモークテストでは、JSON 以外の標準出力があればその旨が報告されます。また、回答が届いた後も SSH セッションが標準出力を開いたままの場合に、停止しなくなりました。
• セッションが切断されると、サーバーは標準入力で EOF を検出して終了します。すでに送信済みの実行はコントロールプレーン上で続行されます。再送信はせず、resume_run_id または adaptorchctl run wait で再度読み取ってください。

HTTP MCP

ローカルゲートウェイ、リバースプロキシ、またはリモート MCP クライアントには HTTP を使用してください。

export ADAPTORCH_CONTROL_PLANE_TOKEN="<upstream-adaptorch-token>"
export ADAPTORCH_MCP_HTTP_AUTH_TOKEN="<client-facing-mcp-token>"

adaptorch-mcp \
  --transport http \
  --base-url https://adaptorch.com \
  --http-host 127.0.0.1 \
  --http-port 8765

認証付きのヘルスチェック：

python - <<'PY'
import os
from urllib.request import Request, urlopen

request = Request(
    "http://127.0.0.1:8765/mcp/health",
    headers={"Authorization": f"Bearer {os.environ['ADAPTORCH_MCP_HTTP_AUTH_TOKEN']}"},
)
with urlopen(request) as response:
    print(response.read().decode("utf-8"))
PY

リスナーはループバックにのみバインドし、同時接続数を ADAPTORCH_MCP_MAX_SSE_SUBSCRIBERS（エンジンのデフォルトは 64）に通常のリクエスト用の 64 を加えた数に制限します。上限を超えると、無制限に処理をキューイングせず、503 を返します。シャットダウン時は、開いているストリームの終了を最大 10 秒間待機します。また、レスポンスに server ヘッダーは含まれません。

ネットワークとトランスポートに関する注意事項

経路	トランスポート	動作
SDK／adaptorchctl → コントロールプレーン	HTTPS（TCP）	GET／HEAD は、ソケットで EOF が検出されない場合、アイドル状態の keep-alive 接続を最大 4 秒間再利用します。POST／PUT は常に新しい接続を開き、一度だけ送信されます。再利用した接続をピアがすでに閉じていた場合、読み取りは新しい接続で一度だけ再送信されます。タイムアウトは再送信されません。
ローカル MCP コネクター → コントロールプレーン	HTTPS（TCP）	同じ keep-alive ハンドラーを使用するため、エンジンによる実行状態のポーリングで、状態を読み取るたびに TCP と TLS のハンドシェイクが発生しなくなります。
MCP クライアント ↔ ローカルラッパー	stdio、または SSH 経由の stdio	改行区切りの JSON-RPC。SSH 経由の stdio を参照してください。
MCP クライアント ↔ ローカルラッパー	ループバック上の HTTP（TCP）	ベアラートークン、同時接続数の制限、10 秒間のグレースフルシャットダウン。

TLS ではシステムのトラストストアを使用し、証明書とホスト名を検証します。また、TLS 1.2 より古いバージョンは拒否します。環境変数 HTTP(S)_PROXY とリダイレクトは引き続き無視されます。SSL_CERT_FILE では引き続きプライベート CA バンドルを指定できます。Linux では、クライアントはレスポンスの各セグメントをただちに確認応答するため、Nagle アルゴリズムを有効にしたサーバーでも、40 ms の遅延 ACK タイマーによって再利用した接続が停止することはありません。

ループバック HTTPS で測定（連続した 100 回の読み取り、このソースリビジョン）：リクエストごとに新しい接続を使用した場合は読み取りあたり 4.1〜5.6 ms、keep-alive を使用した場合は 0.4〜0.6 ms でした。実際のネットワークでは、読み取りごとに TCP と TLS のハンドシェイクの往復分が節約されます。3 MB、5,000 件の実行を含むリストページの解析時間は 268 ms から 129 ms に短縮されました。これらはローカルでのマイクロベンチマークであり、エンドツーエンドの性能を示すものではありません。

UDP トランスポートはありません。MCP が定義しているのは stdio と Streamable HTTP であり、AdaptOrch の API はすべて TCP 上の HTTP です。このクライアントが利用できる標準ライブラリでは、HTTP/3（QUIC）は使用できません。

CLI と環境変数のリファレンス

コマンド	用途	重要なオプション
adaptorch-mcp	stdio または HTTP の MCP サーバーを起動します。	--transport {stdio,http}、--base-url、--api-token、--timeout-seconds、--stdio-framing、--http-host、--http-port、--http-auth-token
adaptorch-mcp-doctor	ローカルの診断情報を機密情報を伏せて出力します。	--json、--strict
adaptorch-mcp-smoke	stdio の initialize と tools/list を検証します。	--command、--base-url、--api-token、--timeout-seconds、繰り返し指定可能な --expected-tool

adaptorch-mcp では、公開ラッパーは次の順序でコントロールプレーンの URL を解決します。明示的に指定した --base-url、トリミングおよび検証済みの ADAPTORCH_CONTROL_PLANE_BASE_URL、ホスト型のフォールバック https://adaptorch.com の順です。adaptorch-mcp-smoke は、ベース URL が設定されていない場合、ローカル開発用のフォールバック http://127.0.0.1:8000 を使用します。再現性のある動作のため、チェックイン済みの MCP クライアント設定では --base-url を明示的に指定してください。

変数	用途	備考
ADAPTORCH_CONTROL_PLANE_TOKEN	上流の AdaptOrch トークンです。	--api-token を渡さない場合は必須です。
ADAPTORCH_CONTROL_PLANE_BASE_URL	--base-url が省略された場合に使用するベース URL です。	トリミングされ、HTTP(S) として検証されます。認証情報を埋め込まないでください。
ADAPTORCH_MCP_PROVIDER	BYOK プロバイダー名、または auto です。	ADAPTORCH_MCP_PROVIDER_MODEL と併せて設定します。実行の送信時にのみ転送されます。auto は、独自のキー変数（OPENAI_API_KEY、ANTHROPIC_API_KEY、GROQ_API_KEY、OPENROUTER_API_KEY、GOOGLE_API_KEY、XAI_API_KEY、OPENCODE_GO_API_KEY、OPENAI_CODEX_API_KEY、WORKBUDDY_API_KEY、DEEPSEEK_API_KEY、COMMANDCODE_API_KEY）が設定されているプロバイダーが1つだけの場合にそのプロバイダーを使用し、それ以外の場合は安全のため処理を中止します。
ADAPTORCH_MCP_PROVIDER_MODEL	BYOK プロバイダーのモデルです。	ADAPTORCH_MCP_PROVIDER と併せて設定します。実行の送信時にのみ転送されます。
ADAPTORCH_MCP_PROVIDER_API_KEY	BYOK プロバイダーのシークレットまたは OAuth アクセストークンです。	プロセス内でのみ使用され、ツールのスキーマや本文、実行以外のリクエストには含まれません。キー不要のプロバイダーに限り省略できます。
ADAPTORCH_MCP_PROVIDER_API_KEY_COMMAND	呼び出し側が管理する、ローテーションするトークン用のヘルパーです。	固定キーとは併用できません。送信ごとに1回実行され、ポーリング時やエラーの機密情報を伏せる処理では実行されません。
ADAPTORCH_MCP_PROVIDER_AUTH_TYPE	api_key または oauth です。	OAuth で現在サポートされているのは明示的に指定した openai_codex のみです。ブラウザーでのログインやリフレッシュトークンのサービスではありません。
ADAPTORCH_MCP_PROVIDER_ACCOUNT_ID	リクエスト単位の OAuth アカウント ID です。	検証され、repr やエラーには表示されず、送信時にのみ転送されます。サーバーのアカウントが借用されることはありません。
ADAPTORCH_MCP_HTTP_AUTH_TOKEN	HTTP/SSE MCP 用のクライアント向けベアラートークンです。	上流のコントロールプレーン用トークンとは別に管理してください。
ADAPTORCH_MCP_ALLOWED_ORIGINS	HTTP の許可オリジンをカンマ区切りで指定します。	ブラウザーまたはリモートの HTTP クライアントと併用してください。
ADAPTORCH_MCP_MAX_PAYLOAD_SIZE_BYTES	受け付ける HTTP リクエスト本文の最大サイズです。	パブリック環境へのデプロイでは上限を設けてください。
ADAPTORCH_MCP_REQUEST_TIMEOUT_SECONDS	HTTP リクエストのタイムアウト時間です。	HTTP サーバーのリクエスト処理に適用されます。
ADAPTORCH_MCP_MAX_SSE_SUBSCRIBERS	SSE サブスクライバーの同時接続数の上限です。	既定値は adaptorch.mcp_server によって設定されます。
ADAPTORCH_MCP_TIMEOUT_SECONDS	アプリファクトリーの使用時におけるコントロールプレーンのクライアントタイムアウトです。	ASGI アプリを組み込む場合に便利です。
ADAPTORCH_REPRODUCIBLE	ベンチマーク／評価の再現性に関するベータ機能です。	ベンチマーク／評価の範囲に限られ、一般的な実行時の決定性を保証するものではありません。
ADAPTORCH_ROUTER_ACCURACY_GATE	オンラインルーターの学習済みモデル用ゲートです。	既定値は point、または wilson です。上級者やオペレーター向けです。
ADAPTORCH_PAPER_SEMANTIC_WEIGHT	ペーパーモードにおける字句スコアと意味スコアのブレンド比です。	既定値は 0.35 です。ゼロ以外の値では、ネイティブの高速パスではなく Python によるスコアリングが使用されます。

Claude Code MCP 設定

{
  "mcpServers": {
    "adaptorch": {
      "command": "adaptorch-mcp",
      "args": [
        "--transport",
        "stdio",
        "--base-url",
        "https://adaptorch.com"
      ],
      "env": {
        "ADAPTORCH_CONTROL_PLANE_TOKEN": "${ADAPTORCH_CONTROL_PLANE_TOKEN}"
      }
    }
  }
}

その他のテンプレート：

• examples/claude_desktop_config.json
• examples/omk.mcp.json
• examples/mcp-http.env.example

チェックイン済みの例では、プレースホルダーまたは環境変数の展開を使用しています。実際の URLとトークンは、ローカルのコミット対象外の設定ファイルにのみ入力してください。

診断

実行結果には、バージョンマーカー verification_diagnostics_schema_version: "verification.diagnostics/v1"を含む verification_diagnosticsが含まれる場合があります。これらの範囲を限定した観測情報は、結果を変更しません。project_reportは信頼できないプロジェクトの申告であり、process_spawnは検証ツールの起動に関する観測情報です。 公開されるのは、定義済みのコード、スコープ、4つのPDFツール名のみです。ログは非公開のままです。 不正な形式の任意メタデータは、実行結果を失うことなく省略されます。ツールを参照してください。

秘匿化されたローカル診断情報を表示します：

adaptorch-mcp-doctor
adaptorch-mcp-doctor --json
adaptorch-mcp-doctor --strict

stdioスモークテストを実行します。トークンはプロセス引数ではなく、子プロセスの環境変数を通じて渡されます。ベースURLが指定されていない場合、スモークテストはローカル開発用にhttp://127.0.0.1:8000を対象とします。

export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
adaptorch-mcp-smoke --base-url https://adaptorch.com

期待されるJSONには、"ok": true、adaptorch_plan_catalog、および想定される コアツールのサブセットが含まれます。doctor JSONには、解決されたベースURLのソースに関する秘匿化済みのcontrolPlaneメタデータも含まれます。特定のホステッド版／コア版のリリースを検証する場合は、繰り返し指定できる--expected-tool <name>フラグを追加してください。

ツール一覧

ツール	目的
adaptorch_run	AdaptOrchのタスクペイロードを送信し、必要に応じて完了を待ちます。
adaptorch_get_run	run_idで実行サマリーと、任意の範囲限定Correctness Wallビューを読み取ります。
adaptorch_get_artifacts	実行のアーティファクトメタデータを読み取ります。
adaptorch_list_runs	最近の実行を一覧表示します。
adaptorch_get_traces	実行トレースを読み取ります（fullプロファイルのみ）。
adaptorch_cancel_run	実行のキャンセルを要求します（書き込み／破壊的操作のため、手動承認を維持してください）。
adaptorch_route_topology	DAGをAdaptOrchのトポロジールーターでローカルにルーティングします（fullプロファイルのみ）。
adaptorch_server_metrics	秘匿化されたMCPサーバーのメトリクスを読み取ります。
adaptorch_capabilities	合成モード、トポロジー、抽出器、検証ツール／VERAの語彙、コネクター、サーバー機能を読み取ります。
adaptorch_usage	呼び出し元テナントの使用状況ウィンドウ（プランレベル、期間、使用量、上限、残量、割合）を読み取ります。
adaptorch_plan_catalog	ホステッドプランのカタログを読み取ります：Starter $0、Pro $39、Team $149。

デフォルトのremoteプロファイルでは、adaptorch_get_tracesとadaptorch_route_topologyを除く9つのツールが公開されます。エンジンの読み取り専用adaptorch_navigate_evidence（固定のエビデンスパックナビゲーション。algorithm_versionのデフォルトはgraph_v5）も、fullプロファイルでのみ使用できます。adaptorch_get_runは、定義済みのoutputSchemaと安全なstructuredContentを公開します。任意のcorrectness_wallは参考用の可観測性情報であり、正しさの証明、セレクターの判断、適用の許可ではありません。

信頼できるローカルクライアントでは、そのクライアントに対して出力が安全なツールのみを 自動承認してください。adaptorch_runとadaptorch_cancel_runは手動承認を維持してください。 共有クライアントまたは本番クライアントでは、ペイロードがすでにサニタイズされていない限り、実行、アーティファクト、トレースの読み取りツールを自動承認しないでください。

ブランディングアセット

• GitHubのヒーロー画像：assets/readme-hero.png
• GitHubのフロー図：assets/mcp-flow.png
• GPT-image-2.0のラスター画像プロンプト概要：docs/brand/gpt-image-2-brief.md

パブリックリリースチェックリスト

**現在のローカルMCPラッパーは、プライベートエンジンに依存しているため、パブリックホイールのゲートでブロックされています。**ビルド／テストの成功や公開のドライランは、 そのホイールを公開する許可にはなりません。エンジンに依存しないSDK／CLIには、別途ホイールゲートがあります。

ローカルでの検証に限り：

uv run ruff check packages/adaptorch-mcp
uv run mypy packages/adaptorch-mcp/src
uv run pytest packages/adaptorch-mcp/tests -q
uv run python -m build packages/adaptorch-mcp --outdir dist

公開するには、パブリックホイールのゲートに独立して合格し、明示的なリリース承認を得る必要があります。 その後に限り、該当するパブリックパッケージについてdocs/publishing.mdに従ってください。

セキュリティ

.env、APIキー、ベアラートークン、秘密鍵、MCPクライアントトークンは決してコミットしないでください。SECURITY.mdを参照してください。

License

Proprietary — Copyright ClassicMate. All rights reserved. See LICENSE.