MCP 서버는 다른 프로젝트 디렉토리의 에이전트에 Claude Code Agent delegate 작업을 할 수 있습니다.

각 에이전트는 프로젝트의 MCP 서버, CLAUDE.md 및 도구에 해당 프로젝트 디렉토리에서 별도의 [T0]] 세션으로 실행됩니다. 호출 에이전트는 결과를 다시 가져옵니다.

관련 프로젝트는 ** 그룹**에 묶을 수 있습니다. — 공유된 간단한 플러스 회원 목록 — 그래서 하나의 세션은 그들에 걸쳐 작업을 조정할 수 있습니다 (예를들면 코드 저장소 + infra/Portainer Gateway + analytics Gateway).

OAuth, API 키 및 Claude 구독 인증과 함께 작동합니다.

AI 에이전트: 이 README는 using 도구 — 설정: 빠른 시작 (모든 단계는 신중한 확인), 첫 번째 호출: [dispatch, 도구 선택: 어떤 도구 사용, 오류 처리: 오류 복구. on 이 repo 대신? AGENTS.md를 참조하십시오.

빠른 시작

Prerequisite: Claude Code CLI를 설치하고 인증해야 합니다. 체크인:

다음 :

Zero-setup 대안 단계 2–3 (두 번째 프로젝트 필요 없음 — 현재 디렉토리 등록):

모든 Claude Code 세션은 이제 파견 도구가 있습니다.

agent-dispatch

MCP server that lets Claude Code agents delegate tasks to agents in other project directories.

Each agent runs as a separate claude -p session in its own project directory — inheriting that project’s MCP servers, CLAUDE.md, and tools. The calling agent just gets the result back.

Related projects can be bundled into a group — a shared brief plus a member list — so one session can coordinate work across them (e.g. code repos + an infra/Portainer gateway + an analytics gateway).

Works with OAuth, API key, and Claude subscription authentication.

AI agents: this README is the canonical doc for using the tool — setup: Quick Start (every step has a deterministic verify), first call: dispatch, tool selection: Which Tool to Use, failure handling: Error Recovery. Working on this repo instead? See AGENTS.md.

Quick Start

Prerequisite: the Claude Code CLI must be installed and authenticated. Check first:

claude --version   # must print a version — if it fails, install Claude Code before continuing

Then:

pip install agent-dispatch   # or: pipx install agent-dispatch

# 1. Create config + register the MCP server with Claude Code (user scope)
agent-dispatch init

# 2. Register project directories as agents — REPLACE the example paths with
#    real directories on your machine; they must exist (~ is expanded, relative
#    paths are resolved). Descriptions are auto-generated from project files.
#    No second project handy? Use the zero-setup block below instead.
agent-dispatch add infra ~/projects/infra
agent-dispatch add backend ~/projects/backend

# 3. Smoke test — dispatches a real task to the agent added in step 2 and prints
#    the answer; exit 0 on success. Default task when none given:
#    "What project is this? Describe in one sentence."
agent-dispatch test infra

# 4. Verify the whole install — prints "All checks passed." and exits 0 on success
agent-dispatch doctor

Zero-setup alternative for steps 2–3 (no second project needed — registers the current directory):

agent-dispatch add self . && agent-dispatch test self "Say hello"