Axcient x360Recover

axcient-mcp

Axcient x360Recover 用 MCP サーバーです。BCDR の クライアント、デバイス、バックアップジョブ、ボールト、アプライアンスを扱います。 @wyre-technology/node-axcient と MCP v2 SDK 上に構築されており、2025 年頃の initialize ハンドシェイクと、2026-07-28 のステートレス エンベロープの両方を、単一の二世代対応 HTTP エントリーポイントから提供します。

認証情報

x360Portal で API キーを生成します：Settings → API Keys（ Axcient のキー管理ガイドを参照）。

.env.example をコピーします。このファイルでは CONDUIT_S2S_SECRET を空のままにします。

• ローカル／stdio（Claude Desktop、CLI）： AXCIENT_API_KEY を設定します。stdio トランスポートでは CONDUIT_S2S_SECRET は使用しません。
• ホスト型／ゲートウェイ： WYRE MCP Gateway がリクエストごとに X-Axcient-Api-Key を挿入します（AUTH_MODE=gateway）。ゲートウェイの Compose サービスでは AXCIENT_API_KEY を設定せず、env_file も使用しません。

変数	必須	説明
AXCIENT_API_KEY	stdio および AUTH_MODE=env で必須	x360Portal API キー
MCP_TRANSPORT	いいえ	stdio（デフォルト）または http
AUTH_MODE	いいえ	gateway（Docker イメージおよび Compose のデフォルト）または env。gateway モードでは各 /mcp リクエストに X-Axcient-Api-Key が必要で、AXCIENT_API_KEY へのフォールバックは行いません。env は S2S 認証に成功した後にのみ、この変数を使用します。
CONDUIT_S2S_SECRET	HTTP では必須	サービス間シークレット。空または既知のプレースホルダーの場合、HTTP サーバーはエラーをログに記録してゼロ以外の終了コードで終了します。Compose はこの値がないと起動しません。実際の値をコミットしないでください。openssl rand -hex 32 で生成できます。
MCP_ALLOW_INSECURE_DEV	いいえ	CONDUIT_S2S_SECRET なしで HTTP を起動する場合に限り、ローカル開発用として 1 に設定します。プロセスは警告をログに記録し、X-Gateway-S2S を強制せず、127.0.0.1 のみでバインドします。より広い範囲を指定した MCP_HTTP_HOST は無視されます。プレースホルダーのシークレットは引き続き拒否されます。
MCP_HTTP_HOST	いいえ	実際の CONDUIT_S2S_SECRET が設定されている場合のバインドアドレス。デフォルトは 127.0.0.1 です。コンテナーイメージでは 0.0.0.0 に設定されています。
MCP_HTTP_PORT	いいえ	HTTP ポート。デフォルトは 8080 です。

/health と /healthz は認証不要のままで、認証情報を読み取りません。

X-Gateway-S2S の署名

MCP_TRANSPORT=http で CONDUIT_S2S_SECRET が設定されている場合、すべての /mcp リクエストに X-Gateway-S2S を含める必要があります。

X-Gateway-S2S: t=<unix seconds>,v1=<hex hmac-sha256>

v1 は、CONDUIT_S2S_SECRET を鍵として、ASCII メッセージ t=<unix seconds> に対して計算した HMAC-SHA256 を 16 進数でエンコードしたものです。タイムスタンプはサーバーの時計との差が 300 秒以内である必要があります。ヘッダーがない場合、または無効な場合は 401 を返します。シークレットがログに記録されることはありません。

import { createHmac } from "node:crypto";

const t = Math.floor(Date.now() / 1000);
const v1 = createHmac("sha256", process.env.CONDUIT_S2S_SECRET).update(`t=${t}`).digest("hex");
const xGatewayS2s = `t=${t},v1=${v1}`;

AUTH_MODE=gateway では、/mcp に X-Axcient-Api-Key も必要です。このヘッダーがないリクエストは 401 を返し、AXCIENT_API_KEY へのフォールバックは行いません。

ローカルで実行（stdio）

npm install
npm run build
AXCIENT_API_KEY=your-key npm start

HTTP として実行（ゲートウェイ／ホスト型）

CONDUIT_S2S_SECRET="$(openssl rand -hex 32)" MCP_TRANSPORT=http AUTH_MODE=env AXCIENT_API_KEY=your-key npm start
# → http://127.0.0.1:8080/mcp, health at http://127.0.0.1:8080/health

シークレットなしのローカル HTTP は開発専用です。127.0.0.1 にバインドされ、警告がログに記録されます。

MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

Docker

イメージはコンテナー内の 0.0.0.0（MCP_HTTP_HOST）でリッスンし、デフォルトで AUTH_MODE=gateway になります。ポートをループバックに公開し、S2S シークレットを渡してください。gateway モードでは、Axcient API キーは各リクエストの X-Axcient-Api-Key として送信され、環境変数からは読み取られません。

docker build --platform linux/amd64 --build-arg GITHUB_TOKEN=$(gh auth token) -t axcient-mcp .
docker run \
  -e CONDUIT_S2S_SECRET=your-s2s-secret \
  -p 127.0.0.1:8080:8080 \
  axcient-mcp

Compose は CONDUIT_S2S_SECRET が設定されていないと起動せず、AUTH_MODE=gateway で実行され、127.0.0.1:8080:8080 を公開します。また、AXCIENT_API_KEY は挿入しません。

CONDUIT_S2S_SECRET=your-s2s-secret GITHUB_TOKEN=$(gh auth token) docker compose up

単一テナントの HTTP（AUTH_MODE=env）でも S2S シークレットが必要で、その後 AXCIENT_API_KEY を使用します。

docker run \
  -e CONDUIT_S2S_SECRET=your-s2s-secret \
  -e AUTH_MODE=env \
  -e AXCIENT_API_KEY=your-key \
  -p 127.0.0.1:8080:8080 \
  axcient-mcp

ツール

20 個のツールをフラットな構成で提供します（ルーターはありません。フリートの約 25 ツールというしきい値を大きく下回っています）。

ツール	説明
axcient_test_connection	組織レコードを取得して API キーを検証します
axcient_get_organization	API キーに対応する組織を取得します
axcient_list_clients / axcient_get_client	クライアント（顧客／サイトのレコード）
axcient_get_d2c_agent_token	D2C エージェント登録トークンを発行します
axcient_list_devices / axcient_list_devices_by_client / axcient_get_device	デバイス
axcient_get_device_autoverify / axcient_get_device_restore_points	AutoVerify と復元ポイント
axcient_list_jobs_by_device / axcient_get_job / axcient_get_job_history	バックアップジョブ
axcient_list_vaults / axcient_get_vault	ボールト
axcient_get_vault_threshold / axcient_set_vault_threshold	ボールトの接続しきい値
axcient_list_appliances / axcient_list_appliances_by_client / axcient_get_appliance	アプライアンス

この構成には破壊的なツールはありません。x360Recover の公開 API（v0.3.1）には削除／無効化操作がないため、確認／追加情報要求のフローは組み込まれていません。このサーバーのエラーメッセージに SDK からそのまま表示される既知の API の挙動（エラー形式の不整合、リストエンドポイントのスキーマ文書の不具合）については、node-axcient の README を参照してください。

ライセンス

Apache-2.0