2026 OpenClaw：リモート物理 Mac で MCP を接続——stdio と Streamable HTTP の再現 Runbook（spawn ENOENT、プロトコル不一致、ツールタイムアウト＋CLI 断片＋FAQ）

2. stdio と Streamable HTTP：どちらのトランスポートか

同一ホストでは動く部品を最小にし、サーバー共有やプロキシ認証が必要になったら HTTP に移行します。

3. 再現可能な 7 ステップ

1. 身元の固定 — OpenClaw を所有するユーザー、LaunchAgent のラベル、launchctl print 相当で見える cwd を記録する。
2. ゲートウェイ抜きで stdio 再生 — 同一ユーザーで /bin/bash -lc 'which node; node -v' と、env ファイルまで揃えた MCP 起動コマンドを実行する。
3. stdio 設定の硬化 — command の絶対パス、明示の args、任意の cwd、env（下記 JSON 参照）。
4. HTTP 経路（任意） — MCP HTTP を 127.0.0.1 にバインドし、nginx／Caddy で TLS 終端。curl -v で Accept 交渉を確認する。
5. 版の固定 — OpenClaw 内の MCP クライアントとサーバー側 SDK／パッケージの major.minor を一致させ、変更履歴に両方を 1 行で残す。
6. タイムアウト予算 — 現実的入力で tools/call の P95 を測り、クライアント待ちを P95×1.5 程度にしつつハード上限を設ける。
7. ログ契約 — initialize／tools/list／tools/call を相関 ID 付き JSON 1 行で出す。

常時エージェントを再起動耐性まで含めて固める場合は、Cron／バックアップ／JSONL 可観測性の手順を別 Runbook と突き合わせ、同じ「無人 Mac」前提で環境変数と plist を二重管理しないようにしてください。

4. CLI 設定断片（JSON 例）

キー名は利用中の OpenClaw／ホスト設定に合わせてください。重要なのは絶対パスと明示 env です。

{
  "mcpServers": {
    "repo-tools": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/usr/local/lib/mcp-servers/repo-tools/dist/main.js"],
      "cwd": "/Users/shared/mcp/repo-tools",
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/bin:/bin",
        "NODE_ENV": "production"
      }
    }
  }
}

{
  "mcpServers": {
    "legacy-npx": {
      "command": "/bin/bash",
      "args": ["-lc", "exec npx --yes @example/[email protected]"],
      "env": { "HOME": "/Users/shared" }
    }
  }
}

{
  "mcpServers": {
    "http-shared": {
      "url": "https://mcp.internal.example.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_EDGE_TOKEN}"
      }
    }
  }
}

5. 症状別 Runbook

5.1 spawn ENOENT（stdio）

5.2 プロトコル版／406（Streamable HTTP）

サーバーとクライアントのハンドシェイクログを並べて比較します。サーバーが text/event-stream を期待しているのにプロキシが gzip を噛ませてフラッシュしないと、パッケージの版表記は揃っていても「版不一致」に見える停滞が起きます。

5.3 ツールタイムアウト

（A）モデル／ルータ待ち、（B）ゲートウェイ上流、（C）MCP サーバー内部の 3 タイマーを図にします。最もタイトな層から広げ、トレースでキュー滞留が証明された隣接層だけを緩めます。長尺の Git／依存取得は ビルドキャッシュと越境レイテンシの記事 と同様、単一ブロッキング呼び出しに押し込めない方が安全です。

6. SLO 資料に貼れる数値

• 約 4W — Apple Silicon Mac mini の待機電力の目安。軽量ゲートウェイ＋ SSH を載せた TCO 試算に使える x86 タワーとの対比値。
• 25 秒 — 共有ノード上で「速い」tools/call P95 の経験則上限。超えるならツール分割や部分結果ストリームへ寄せ、タイムアウトだけを無限に伸ばさない。
• 600 秒 — 大規模リポジトリ走査などのメンテ用途は非同期ジョブ＋ポーリングへ逃がし、単一 MCP 呼び出しで塞がない。

7. FAQ