MCP サーバー

ccmux を使用してください MCP サーバーにより、コーディング エージェントがセッションを検査し、プロジェクト ノートを読み、使用状況を確認できるようになります。セッションの作成、キーストローク、および終了は、ミューテーションを有効にした場合にのみ使用できます。

サーバー バイナリは、ccmux v0.3.0 以降に含まれています。 ccmux をインストールします クライアントに接続する前に、そのデーモンが実行されていることを確認してください。

配線してください

Claude Code で、ユーザーアカウント用のローカル stdio サーバーを登録します：

claude mcp add --transport stdio --scope user ccmux -- ccmux-mcp

走る /mcp を Claude Code 内で実行して接続を確認します。詳しくは Claude Code の MCP ドキュメント 構成範囲とトラブルシューティングについては。

プロジェクト スコープの構成の場合は、次を使用します。 .mcp.json プロジェクトのルートで:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp" }
  }
}

他の MCP クライアントでは、それぞれの設定形式を使用します。stdio サーバーを追加し、コマンドに次を指定してください： ccmux-mcp;クライアントが PATH でバイナリを見つけられない場合は、バイナリの絶対パスを使用します。

エージェントには次のツールが含まれるようになりました。

これらのツールは読み取り専用です。これらは、接続されたデーモンが利用できる情報を公開します。

何かをさせたいとき

追加 --allow-mutate をサーバー引数に追加します。プロジェクト スコープの Claude Code 構成の場合:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp", "args": ["--allow-mutate"] }
  }
}

これにより次のロックが解除されます:

デフォルトではオフになっている理由: エージェントが send_keys は、入力できるものを何でも入力できるエージェントです。フラグはオプトインです。ツールごとにオーバーライドすることはありません。ミューティング セット全体をオンにするか、オフのままにします。

フラグがないと、変更ツールが存在しません。 tools/list。引数を変更した後、クライアントを通じて MCP サーバーを再起動します。

リモートマシンを駆動する

CCMUX_HOST=mini.tail-xxxxx.ts.net:7474 ccmux-mcp
# or
ccmux-mcp --host mini.tail-xxxxx.ts.net:7474

エージェントはローカルで実行され、Mac mini 上のデーモンにクエリを実行します。変異ツールには依然として必要なものがあります --allow-mutate。同じプロトコル、同じツール - ローカルの Unix ソケットではなく、Tailscale HTTP を超えたところにあります。 「ラップトップでコーディングしているが、夜間の Claude 作業はミニで行う」場合に便利です。

これは実際には何のためにあるのか

いくつかの具体的な形状:

マルチセッション オーケストレーション。 あるセッションのエージェントが別のセッションでヘルパーを生成します (spawn_session は別のプロジェクトにあります)、完了すると出力を読み取ります (read_pane)、結果をプルバックし、ヘルパーを強制終了します。人間は関与していない。

クロスマシン作業。 ラップトップ上のエージェントが、Mac mini 上の兄弟の動作状況をチェックします (list_sessions, read_pane)、SSH を実行する必要はありません。または、mini 上で長時間実行ビルドを開始します (spawn_session MCP サーバーを構成した後 --host および --allow-mutate) し、ローカル作業を続行します。

プロジェクトメモリ。 エージェントはセッションの開始時にプロジェクトのメモを読みます (list_notes + read_note) なので、前のエージェントが行った作業が繰り返されません。メモはディスク上では単純なマークダウンです。エージェントはそれを知る必要はありません。

コスト意識。 大規模な実行を開始する前に、エージェントは次のことを確認します。 get_usage 今週の支出を確認します。 get_daemon_health すでに実行されているセッションの数を確認します。

これらには新しいインフラストラクチャは必要ありません。 ccmux にはすでにすべてがありました。 MCP は、エージェントがアクセスできるようにするためのプロトコルです。

セキュリティモデル

• トランスポート。 stdio を使用します。デーモンの Unix ソケットはユーザー単位です。HTTP 接続には同じ tailnet への参加が必要です。
• 突然変異。 フラグを反転しない限りオフになります。
• 制限付き読み取り。 read_pane は 500 行に制限されているため、バグのあるエージェントが呼び出しごとに完全なスクロールバックを要求してデーモンを下にドラッグすることはできません。
• 呼び出しごとの期限。 すべてのハンドラーは 30 秒のコンテキストで実行されます。

電流制限

サーバーはリクエスト/レスポンス ツールを提供します。ライブ サブスクリプション、ツールごとの変更権限、プロンプト ライブラリは現在利用できません。

関連ガイド

• リモートホストを構成する デーモンをターゲットにする前に。
• HTTP API リファレンスを読む ccmuxd に対して直接クライアントを構築します。

エラーまたは古いものを見つけましたか? GitHub でこのページを編集します.