Subagent MCP

Subagent MCP는 Codex 및 기타 호환 MCP 클라이언트가 하나의 정규화된 수명 주기를 통해 네이티브 외부 코딩 에이전트 하네스를 오케스트레이션할 수 있게 해주는 MIT 라이선스의 로컬 MCP입니다. 배포판, 리포지토리 및 명령 이름은 subagent-harness-mcp입니다.

Windows 관리형 미리 보기

0.1.0a1은 사전 릴리스이며 공급자 준비 완료를 의미하지 않습니다. 이 패키지에는 stdio MCP, 개정된 로컬 상태, 결정적 페이크 어댑터, 보호된 Claude Code 관리 어댑터, 보수적인 Windows 런타임 수명 주기, 옵트인 localhost 설정/활동 UI가 포함되어 있습니다.

모델 ID 및 추론 객체는 공급자 네이티브 불투명 값입니다. Subagent MCP에는 모델 허용 목록이 포함되어 있지 않으며, 대체 모델을 선택하거나 사용 크레딧을 활성화하거나 결제 설정을 변경하지 않습니다.

Claude의 네이티브 SDK는 턴이 시작된 후에만 공급자 요금 이벤트를 게시합니다. 따라서 Subagent MCP는 모든 관리 프로세스에 대해 1M 컨텍스트, 빠른 모드 및 세션 내 사용량 크레딧 명령을 비활성화합니다. 카나리는 이벤트가 allowed, isUsingOverage=false 및 거부된 초과분을 증명할 때까지 출력을 거부합니다. 일반 턴에는 정확히 동일한 영구 준비 증명이 필요하며 이후 안전하지 않은 요금/오류 이벤트가 발생하면 중단됩니다. 증거가 없거나 안전하지 않으면 정확한 런타임 변형이 일시 중지됩니다. 선택한 노력 수준은 사용자 설정과 기술이 이를 대체할 수 없도록 공급자 네이티브 프로세스 환경을 통해 다시 고정됩니다.

0.1.0a1의 경우 일반 Claude 턴은 네이티브 사용자 설정 소스만 로드합니다. 사용자 기술은 계속 사용할 수 있지만 프로젝트/로컬 CLAUDE.md, .claude 후크, 에이전트, 기술 및 선언된 프로젝트 MCP는 신뢰 게이트가 구현될 때까지 비활성화됩니다. 이는 명시적 기능 격차로 보고됩니다.

Related MCP server: AgentHub

설치 및 검사

0.1.0a1이 게시된 후 정확한 사전 릴리스를 격리된 도구 환경에 설치하십시오:

uv tool install subagent-harness-mcp==0.1.0a1
subagent-harness-mcp --version
subagent-harness-mcp ui

pipx install subagent-harness-mcp==0.1.0a1도 지원됩니다. UI는 임시 루프백 포트에서만 열리며 프로세스와 함께 중지됩니다. 에이전트 채팅 콘솔이 아닌 설정 및 읽기 전용 활동입니다.

일반 MCP 클라이언트의 경우 고정 인수와 함께 설치된 실행 파일을 사용하십시오:

{
  "command": "subagent-harness-mcp",
  "args": ["serve"]
}

Windows 수명 주기 명령은 명시적이며 --dry-run을 지원합니다:

subagent-harness-mcp install --runtime <immutable-runtime-dir> --runtime-version <version> --dry-run
subagent-harness-mcp update --runtime <immutable-runtime-dir> --runtime-version <version> --dry-run
subagent-harness-mcp rollback --dry-run
subagent-harness-mcp register --client codex --dry-run
subagent-harness-mcp uninstall --client codex --dry-run

등록은 클라이언트의 공식 명령과 정확한 읽기 백을 사용합니다. 제거 시 기본적으로 구성, 상태, 네이티브 세션 및 작업 트리가 보존됩니다.

공개 계약

MCP는 모든 어댑터에 대해 동일한 13가지 수명 주기/구성 도구를 노출합니다. 아키텍처, 어댑터 작성 및 위협 모델을 참조하십시오. 버전이 지정된 스키마는 schemas/에 있습니다: 구성, 어댑터 매니페스트, 정규화된 에이전트 설명자 및 MCP 도구.

Subagent MCP는 명시적 구성, 상태, 데이터 및 스테이징된 런타임 루트만 소유합니다. AgentBridge 상태를 사용하거나 기존 Codex/Claude 구성, 인증, 캐시, 기록 또는 프로세스를 편집하지 않습니다.

개발 및 보안

결정적 검사는 CONTRIBUTING.md를, 비공개 취약점 신고는 SECURITY.md를 참조하십시오. 라이브 공급자가 준비되었다는 증거로 페이크 어댑터, 정적 검사 또는 녹색 CI를 사용하지 마십시오. Subagent MCP는 MIT 라이선스에 따라 릴리스됩니다.