MCP サーバー

ADHDev は、外部の MCP クライアントが ADHDev セッションをツールとして使えるように、MCP stdio サーバーを提供します。このサーバーは @adhdev/mcp-server として公開されており、メインのクラウド CLI からは adhdev mcp としてもラップされています。

Claude Desktop のような MCP クライアントに、アクティブな ADHDev セッションを一覧表示させたり、チャット履歴を読ませたり、メッセージを送らせたり、待機中のプロンプトを承認させたりしたいときに使ってください。Mesh モードでは、フルの Repo Mesh コーディネーターツールサーフェスになります。

モード

モード	MCP サーバーが使用するトランスポート	ツール
ローカル standalone	http://localhost:3847 standalone API	基本 15 ツール + screenshot + Mesh ブートストラップ 3 ツール（合計 19）
IPC	localhost:19222 のクラウドデーモンローカル IPC	同じ基本 15 ツール + Mesh ブートストラップ 3 ツール、screenshot を除く（合計 18）
Mesh	ローカルまたは IPC + --repo-mesh <id>	コーディネータースコープのセット — 下記の Mesh ツール を参照
Worker	ローカルまたは IPC + --worker	最小限の委任ワーカーツールセット: report_completion、progress_update、peer_context_pull、git_status、git_log、git_diff（合計 6 ツール）、デーモンが起動

ローカルモードは OSS/セルフホストサーフェスの一部です。standalone のセットアップと認証の詳細については、OSS ドキュメントを参照してください:

• Self-hosted Setup
• Self-hosted Local API

サーバーの起動

# Local mode: requires a running standalone daemon
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password

OSS パッケージを直接実行することもできます:

npx @adhdev/mcp-server
npx @adhdev/mcp-server --mode ipc --repo-mesh mesh_abc123

環境変数もサポートされています:

ADHDEV_PASSWORD=my-standalone-password adhdev mcp
ADHDEV_MESH_ID=mesh_abc123 adhdev mcp

Claude Desktop の設定

{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp"]
    }
  }
}

Mesh モード（コーディネータースコープのツール）:

{
  "mcpServers": {
    "adhdev-mesh": {
      "command": "adhdev",
      "args": ["mcp", "--mode", "ipc", "--repo-mesh", "mesh_abc123"]
    }
  }
}

標準モードのツール

標準モード（--repo-mesh なし）は、直接セッション制御のサーフェスに加えて、Mesh がまだ存在しない状況で MCP のみのエージェントが先に Mesh を作成できるようにする、3 つの Mesh ブートストラップツールを公開します。

セッションとデーモン

• list_daemons — 接続されたデーモンの ID を報告します。
• list_sessions — デーモン上の利用可能なセッションを検出します。
• launch_session / stop_session — CLI/IDE エージェントのライフサイクルを管理します。
• check_pending — 承認待ちのセッションを一覧表示します。

チャットと承認

• read_chat — 選択したセッションの最近のチャットを読みます。
• read_chat_debug — 選択したセッションのチャット状態に関する境界付きデバッグバンドル。
• spec_debug — プロバイダースペック解析用のデバッグヘルパー。
• send_chat — 選択したセッションにメッセージを送ります。
• approve — 承認プロンプトを承認または拒否します。

Git

• git_status, git_diff, git_log, git_checkpoint, git_push — ワークスペースの git 操作を管理します。

ローカル専用

• screenshot — デーモンを通じて現在の IDE ウィンドウをキャプチャします。P2P/ローカルデーモンへのアクセスが必要なため、ローカルモードでのみ利用可能で、IPC では利用できません。

Mesh ブートストラップ（ローカル・IPC いずれの標準モードでも利用可能 — まだ Mesh が存在しない場合の経路）

• mesh_create — 新しい Mesh を作成し、任意で現在のワークスペースを最初のノードとして登録します。mode: "plan" で呼ぶと、Mesh を作成/参加した場合に何が起きるかを提案するだけで何も書き込まない読み取り専用の dry-run になります — まずこちらを実行してください。
• mesh_add_node — 既存のワークスペースを既存の Mesh のノードとして登録します。

Mesh が存在するようになったら、--repo-mesh <mesh_id> を付けて MCP サーバーを再登録し、Mesh モードに切り替えることで、下記の完全なコーディネーターツールセットが使えるようになります — Mesh モードはツールサーフェスに追加するのではなく、完全に置き換えます。

Mesh ツール

Mesh ツールは Mesh モード（--repo-mesh）でのみ利用可能です。標準ツールを、コーディネータースコープのツールセットに置き換えます。

名前と個数の権威ある情報源はコードです

このページはツールをファミリーごとにまとめて紹介する概要です。正確な名前・現在の個数・完全な入力スキーマの権威あるリストは、oss/packages/mcp-server/src/tools/mesh-tool-schemas.ts の ALL_MESH_TOOLS です。以下のリストとコードが食い違う場合はコードが正しい — このリストは過去に一度古くなったことがあります。

ステータスと検査

• mesh_status — 集約スナップショット: すべてのノードのヘルス、git 状態、アクティブなセッション、復旧のヒント、デーモンごとのビルド/陳腐化情報。
• mesh_list_nodes — Mesh 設定から作る軽量なノード一覧: すべてのノードのワークスペースパス、マシン識別、ノードポリシー、機能（ライブの git やセッションは含みません — それは mesh_status）。
• mesh_read_chat — 委任されたエージェントのチャット履歴を読みます。
• mesh_read_debug — 委任されたセッションのための境界付きデバッグバンドル。
• mesh_read_terminal — 委任されたセッションの現在の生の PTY ビューポート（今まさに人間が画面で見ているもの）を読みます。
• mesh_git_status — ノードワークスペースの git 状態を取得します。
• mesh_read_node_logs — ノードのデーモンログファイルを grep します（末尾だけでなくファイル全体）。
• mesh_task_history — Mesh の台帳: タスク、完了、失敗、チェックポイント、ノードとミッションのライフサイクル。kind（1 つまたはカンマ区切り）、since、node で絞り込み、新しい順に tail 件を返します。
• mesh_ledger_query — mesh_task_history の非推奨エイリアス（非推奨エイリアスを参照）。
• mesh_review_inbox — コーディネーターを待っているレビュー/承認保留項目。
• mesh_list_pending_approvals — 現在承認判断を待っているすべてのセッションの Mesh 全体リスト。
• mesh_route_preview — 現在のインメモリ mesh/キュー/クォータファクトのスナップショットから、仮想のタスクがどこに、なぜルーティングされるかをプレビューする読み取り専用・フェッチなしのツール（容量優先の順序、難易度の下限、フィットネス構成要素、クォータボーナス、ゲート結果を含む）。enqueue・書き込み・CLI プローブ・クォータ更新は一切行いません。

ディスパッチ・セッション・制御

• mesh_send_task — 委任されたエージェントセッションに自然言語のタスクを直接送ります。
• mesh_launch_session — Mesh ノードに新しいエージェントセッションを起動します。
• mesh_send_keys — 委任されたワーカーセッションに構造化されたキーシーケンスを注入します。
• mesh_restart_daemon — Mesh ノードのデーモンを再起動します。
• mesh_approve — 委任されたエージェントの保留中のアクションを承認/拒否します。
• mesh_answer_question — 委任されたセッションが待機している多肢選択の質問（AskUserQuestion）に答えます。
• mesh_checkpoint — ノードワークスペースに git チェックポイントを作成します。
• mesh_cleanup_sessions — ノード上の古くなった、または孤立した委任セッションを停止/整理します。mode: "prune_stale_direct" を指定すると、代わりに Mesh 全体の古い直接ディスパッチのレコードを整理します（execute: true でない限り dry-run）。

作業キューとミッション

• mesh_enqueue_task — アイドルなノードが自律的にクレームするタスクをキューに追加します（target_node_id / prefer_worktree ルーティング、task_mode、mission_id、depends_on、および任意の owned_paths 宣言をサポートします。これにより、Mesh 内の他の場所で重複する code_change タスクが、競合させる代わりにクレーム時点で拒否されます）。既存のタスクに depends_on で新しいタスクを連結していくのが、多段階の計画を組み立てるデフォルトの方法です — 作業が判明するたびに、計画は一度に 1 つずつリンクを伸ばしていきます。depends_on を持つタスクは、完了時に先行タスクが報告した内容を要約した「Upstream results」の付記を自動的に受け取ります。
• mesh_enqueue_batch — 複数のタスク（とその depends_on の関係）を 1 回の呼び出しでアトミックにキューに追加します。いずれかの項目が無効な場合はバッチ全体がロールバックされます。ステップがすでに確定している計画のための便利機能で — タスクを連結していくデフォルトの方法ではありません（上記の mesh_enqueue_task を参照）。
• mesh_view_queue — 現在のアクティブな作業の信頼できる情報源（pending/assigned/terminal）。
• mesh_queue_cancel / mesh_queue_requeue — キューに入っているタスクをキャンセルまたは再キューします。
• mesh_mission_upsert — ミッションの作成/更新（目標のグルーピング + ライフサイクルステータス）。
• mesh_mission_list — 目標、ステータス、リアルタイムのタスク進捗（合計/保留/割当済み/完了/失敗）とともにミッションを一覧表示します。
• mesh_reconcile_ledger — ピアの境界付きスライスに対してローカルの台帳を照合します。
• mesh_note — action: "record" / "forget"：将来のコーディネーターが引き継ぐ永続的な運用メモを記録または撤回します。

ブートストラップと設定（Mesh モード。上記の標準モードブートストラップ 2 種とは別物）

• mesh_init — 既存の git プロジェクト向けのワンクリックオンボーディング: インストール済みの CLI プロバイダーを検出し、リポジトリの .adhdev/* 設定 3 ファミリー（Refinery、worktree bootstrap、change-impact）を提案します。デフォルトはプレビューで、write: true で適用します。 mode: "reinit" はすでに初期化済みのリポジトリ向けの同じ操作で、overwrite のデフォルトが true になり、現在値 vs 提案値の diff を返します。
• mesh_config — kind で選ぶリポジトリ設定ヘルパー。kind: "refine" と kind: "change_impact" は読み取り専用のヘルパーで、mode（schema / validate / suggest）で操作を選択します。kind: "mesh_json" はマシンローカルの Mesh エントリから、リポジトリにコミットされる .adhdev/mesh.json を書き込みます（write: true でない限り dry-run）。下記の廃止されたツール名を参照。

ノード

• mesh_clone_node — ノードを分離された git ワークツリーノードに複製します。
• mesh_remove_node — （ワークツリー）ノードを削除し、オプションでセッションを整理します。
• mesh_cleanup_worktree_nodes — ブランチがマージ/プッシュ済みであることが証明され、すべての安全除外条件を通過した、収束済みのローカルワークツリーノードの安全な削除を計画（デフォルトは dry-run）または実行します。
• mesh_fast_forward_node — デフォルトでは安全に dry-run し、または明示的に実行して、エージェントセッションを起動せずに明確な clean fast-forward を行います。fetch/recheck、merge --ff-only、オプションのサブモジュール更新、事後のステータス検証のみを使用します。

Refinery（ワークツリー → ベースへの収束）

• mesh_refine_node / mesh_refine_batch — 1 つまたは複数のワークツリーブランチをベースへ収束させます（検証 → マージ → プッシュ → クリーンアップ）。どちらも既定では計画をプレビューするだけで、execute: true を渡すまで何も実行しません。

ノードスロット（プロバイダー/モデル/思考レベルのルーティング）

• mesh_node_slots — ノードのスロットリスト（プロバイダー/モデル/思考レベルを難易度クラスに紐付け）を action で操作します：list は現在のスロットを一覧表示し、set はスロットリストを提案（dry-run）または適用し、propose はノードにインストールされている CLI エージェントを自動検出して能力スロットのプロファイル案を作成する読み取り専用の操作です（「とりあえず許可すればスロットを自動で判断してくれる」経路）。propose は書き込みを一切行いません — レビュー後、mesh_node_slots({ action: "set", node_id, slots: proposedSlots, write: true }) で案を適用してください。スロットの書き込みは全体置き換えのため、手動で調整したスロットが失われる可能性があります。

Worker モード

adhdev mcp --mode ipc --worker は、Repo Mesh ワーカーセッション（Mesh コーディネーターが他のエージェントセッションにタスクをディスパッチし、それらがワーカーとして動作します）で使われる最小限の委任ワーカーツールセットを起動します。このモードは通常、デーモン自身がワーカーセッションを起動するときに立ち上げるものであり、手動で実行するものではありません — ワーカープロセスは、デーモンが提供するセッションバインド（ADHDEV_WORKER_SESSION_BIND）またはタスクトークン（ADHDEV_WORKER_TASK_TOKEN）を必要とします。--worker は --repo-mesh より優先されます: ワーカーセッションがコーディネーターツールセットを得ることは決してありません。

Worker ツール: report_completion、progress_update、peer_context_pull、git_status、git_log、git_diff。

廃止されたツール名

2026-09-26 に、同じ対象を扱っていたツールを action / kind / mode 引数で選ぶ 1 つのツールにまとめ、Mesh ツールを 60 個から 48 個に統合しました。すべての機能は引き続き利用できます。旧名は tools/list に掲載されなくなり、転送もされません：呼び出すと置き換え先のツールと追加すべき引数を示すエラーが返るため、古いプロンプトで動くエージェントも次の呼び出しで回復できます。

旧名	代わりに呼ぶもの
mesh_node_slots_list	mesh_node_slots + action: "list"
mesh_node_slots_propose	mesh_node_slots + action: "propose"
mesh_node_slots_set	mesh_node_slots + action: "set"
mesh_record_note	mesh_note + action: "record"
mesh_forget_note	mesh_note + action: "forget"
mesh_reinit	mesh_init + mode: "reinit"
mesh_refine_config	mesh_config + kind: "refine"
mesh_change_impact_config	mesh_config + kind: "change_impact"
mesh_write_mesh_json_config	mesh_config + kind: "mesh_json"
mesh_plan_onboarding	mesh_create + mode: "plan"
mesh_prune_stale_direct	mesh_cleanup_sessions + mode: "prune_stale_direct"

グラフオーケストレーションのツール（mesh_graph_view、mesh_graph_gate、mesh_graph_node_patch）は 2026-09-30 に代替なしで削除されました。タスクは depends_on で連結してください。

MAGI ツール（mesh_magi_review、mesh_magi_collect、mesh_magi_kind_panel）は 2026-09-30 に削除されました。呼び出すと代替手段を示すエラーが返ります: 同じ読み取り専用の質問を異なるプロバイダーの 2〜3 個のワーカーに mesh_send_task で送り、report_completion を待ってから自分で答えを統合してください。

mesh_refine_plan は 2026-10-08 に削除されました。これは mesh_refine_node の既定のドライランのエイリアスでした。呼び出すと mesh_refine_node を案内するエラーが返ります。mesh_refine_node は何も実行せずに同じ計画を返します。

mesh_coordinator_prompt_append（廃止名 _get / _set を含む）は 2026-10-08 に、マシンごとの ~/.adhdev/coordinator-prompts/ ファイルとともに削除されました。デーモンはこれらのファイルを読み込まなくなりました。呼び出すと代替手段を示すエラーが返ります: プロジェクトのコーディネーターに常に適用する指示はリポジトリの .adhdev/mesh.json の coordinator.systemPromptAppend に書き（mesh_config、kind: "mesh_json"）、教訓は mesh_note で記録してください。

非推奨エイリアス

mesh_refine_config_schema、mesh_suggest_refine_config、mesh_validate_refine_config、およびその change-impact 版（mesh_change_impact_config_schema、mesh_suggest_change_impact_config、mesh_validate_change_impact_config）は上記の統合より前の名前です。tools/list には掲載されませんが、サーバーは互換性のためディスパッチを継続し、対応する kind と mode で mesh_config に転送します。新しい呼び出し側は mesh_config を直接使ってください。

mesh_ledger_query は mesh_task_history の非推奨エイリアスです。2026-10-08 に kind / since / node のフィルターは mesh_task_history に移りました。1 リリースの間は引き続き掲載され動作します（完全なペイロード、tail の既定値 50）が、その後削除されます。新しい呼び出し側は mesh_task_history を使い、完全なペイロードが必要なら verbose: true を渡してください。

関連リファレンス

• CLI コマンド
• API キー
• REST API