Lesson (강의 단원)lecturedraftFri May 08

단원 — 4 요소 ③ 연결 (호환성과 확장성)

별칭: 4 요소 연결 단원 · MCP Subagent 단원 · 모델+도구=에이전트 단원

#4-elements#connection#mcp#subagent#mailbox#harness-engineering#tool-explosion#lecture-core

한 줄 명제

모델 + 도구 = 에이전트. 도구는 모델의 손과 발이다. 도구가 늘어도 무너지지 않게 호환성과 확장성을 기록하는 일이 연결 요소다.

강의 흐름 (12 분)

① 모델 + 도구 = 에이전트 (2 분)

여기서 모델이 에이전트가 된다. 가장 결정적인 구분.

모델 자체는 토큰 인 → 토큰 아웃 함수 일 뿐. 텍스트 생성기다. 에이전트가 아니다. 두뇌만으로는 세상에 아무 영향을 못 준다 — 파일 하나 못 읽고, 명령 하나 못 실행하고, API 하나 못 부른다.

모델이 에이전트가 되는 순간은 — 외부 도구가 연결되는 순간. 도구는 모델의 손과 발:

도구	닿는 곳
Read · Write · Edit	파일 시스템에 닿는 손
Bash	셸을 실행하는 발
WebSearch · WebFetch	인터넷에 닿는 더듬이
MCP 서버	외부 서비스에 닿는 인공 신경
Subagent (Task)	격리된 컨텍스트에서 일하는 분신

모델 + 도구 = 에이전트. 이게 공식이다.

도구 없이는 그냥 챗봇이고, 도구가 붙는 순간부터 에이전트 라 부른다. 그래서 연결 요소가 단순 옵션이 아니라 에이전트의 정체성.

② Claude Code 약 40 도구 + MCP (2 분)

Claude Code 도구 약 40 개:

파일 도구: Read, Write, Edit, MultiEdit
검색 도구: Glob, Grep
실행 도구: Bash
웹 도구: WebSearch, WebFetch
계획 도구: TodoWrite, Plan
위임 도구: Task tool — 서브에이전트 호출

여기에 MCP (Model Context Protocol) — Anthropic 표준화 외부 도구 통합 프로토콜. JSON-RPC 기반, 사용자가 만든 MCP 서버를 Claude Code 에 붙이면 그 서버의 도구들이 Claude Code 의 도구로 등록. GitHub MCP, Slack MCP, Database MCP — 어떤 외부 서비스든 MCP 로 박을 수 있다.

Tool.ts 베이스만 약 29,000 줄. 그중 상당량이 도구별 권한 분리 코드. 각 도구마다 독립된 permission gate — Read 가 허용돼도 Write 는 별도 허용 필요. 단일 글로벌 권한이 아니다.

상세: term/mcp

③ 호환성 + 확장성 (2 분)

연결 요소를 한 단어로 표현하면 호환성 이고, 또 한 단어로 표현하면 확장성.

호환성 — 어떤 도구를 붙여도 잘 동작. Claude Code 가 처음부터 알지 못한 도구라도 MCP 표준만 따르면 즉시 붙음. Subagent 에 다른 도구 셋을 주어도 — 같은 인터페이스로 결과 돌아옴.

확장성 — 도구가 늘어나도 시스템이 무너지지 않음. 10 개에서 50 개로 늘어도:

권한 분리가 도구별로 기록되어 있고
Subagent 격리로 컨텍스트 부풀림 막혀 있고
ToolSearch 로 도구 정의가 on-demand 로드

④ Subagent + Mailbox 격리 (3 분)

Claude Code 의 가장 흥미로운 패턴 中 하나 — Multi-Agent 패턴.

Lead Agent (메인 세션, 사용자와 대화)
    ↓ Task tool 로 호출
Subagent 1 (격리 컨텍스트, 작업)
    ↓ 작업 중 위험한 것 만나면
Mailbox → Lead 에 요청 (대기)
    ↓ Lead 가 평가 → 승인/거부
Subagent 1 재개 → 결과 반환

왜 이렇게 설계했는가 — 셋이 묶여 있다:

차원	값
공간 분리	Subagent 가 격리된 컨텍스트 → Lead 의 컨텍스트가 안 부풀음
시간 병렬화	여러 Subagent 가 동시에 도니까 처리량 증가
권한 격리	Subagent 는 위험 작업을 직접 승인 못 함. 반드시 Lead 의 결정 거침

핵심: 이 셋을 한 패턴이 동시에 푼다. 그리고 — 본 위키의 HIAO 1-N-N 패턴이 정확히 이 구조. Master + Cluster Manager + Specialized Agent. 우리가 외부적으로 의식해서 박은 패턴이 — 역으로 Claude Code 안에서도 동작하고 있다.

상세: concept/hiao-1-n-n · case/subagent-mailbox-isolation · concept/subagent-driven-development

⑤ MCP 의 4 요소 trade-off (2 분)

MCP 는 매력적. 외부 서비스를 즉시 도구로 붙일 수 있다. 그래서 사람들이 무한정 MCP 추가 본능에 빠진다. 도구 많을수록 에이전트가 강해진다고 믿는다.

그런데 그 본능이 4 요소 전체를 약화시킨다:

위험	값
도구 폭발	너무 많이 연결 → 모델이 잘못된 도구를 선택. 컨텍스트 윈도우 잠식
도구 실종	핵심 MCP 가 죽거나 인증 만료 → 에이전트가 멎거나 환각으로 메움. 손발 마비

처방 — 절제와 격리:

필요한 도구만 노출
도구 헬스체크
Subagent 로 도구 셋 격리
depth=1 로 재귀 폭발 방지

연결은 격리와 절제로만 안전해진다.

상세: concept/mcp-trade-off

⑥ 연결 요소의 한 줄 (1 분)

연결이 호환·확장으로 기록되었다. 그러나 도구가 잘 닿아도 — 잘못된 결과 위에 잘못된 결과가 쌓이면 무너진다. 다음 단원은 검증.

4 엔지니어링 통합 기록

본 단원은 연결 = 하네스 + 에이전틱 을 기록:

하네스 엔지니어링: 본 단원의 주 무대. MCP / 권한 게이트 / Subagent 격리
에이전틱 엔지니어링: Subagent + Mailbox = HIAO 1-N-N 의 루프 결정 흐름
컨텍스트 엔지니어링: 도구 정의가 컨텍스트를 먹음 — 절제 ❌ 시 공간 부패
프롬프트 엔지니어링: 도구 인자도 모델이 기록하는 프롬프트 — 도구 디스크립션이 곧 프롬프트 설계

→ 4 분야 모두 연결 요소 위에서 기록됨. concept/4-engineering-disciplines 통합 기록 규칙 정합.

다음 단원으로

lesson/4elements-verification-hooks (검증 요소).

출처

60_service/6006 booklet-vibe-coding-4-elements/_combined_book.md §396~450 (5 장 — 연결 — 호환성과 확장성).