MCP와 Extensions: 외부 도구 연동의 두 길

먼저 해보고 설명해요. 같은 외부 능력 “날씨 조회”를 왼쪽은 MCP 브리지, 오른쪽은 네이티브 Extension으로 동시에 붙여 봐요. 세 가지를 보세요: 도구 이름이 어떻게 생기는지, 서버가 끊길 때 모델 시점이 어떻게 바뀌는지, 두 길의 능력면이 얼마나 다른지. 「재생」으로 자동 재생하거나 「단스텝」으로 프레임마다 보세요.

먼저 용어부터요. MCP(Model Context Protocol)는 열린 프로토콜이에요. 누구나 도구 서버를 쓰면, MCP를 지원하는 클라이언트는 연결해서 그 도구를 쓸 수 있어요. DSH의 dsh-mcp-client 플러그인이 바로 그 클라이언트로, 플러그인 인스턴스 하나가 서버 하나에 붙고, stdio 서브프로세스와 streamable-http 전송을 모두 지원해요. 연결되면 하는 일은 단순해요. listTools()로 도구 목록을 받아 공개명으로 ctx.tools에 등록하고, 모델은 그걸 네이티브 도구처럼 써요.

이름 짓기가 첫 설계 포인트예요. MCP 도구마다 이름이 둘이에요. 원본명은 와이어에만 나타나고(tools/call이 씀), 모델이 보는 공개명은 mcp__서버명__원본명이에요. 형식이 Claude Code·Codex와 같고, mcp-client README가 그걸 스스로 짚어요. 이름은 DeepSeek 함수명 규칙을 지켜야 해요. 최대 64자, 영숫자·밑줄·하이픈만. 치환이나 잘림으로 이름이 바뀌면 끝에 12자리 16진 SHA-256 hash를 붙여, 서로 다른 도구 정체성이 한 이름으로 접히지 않게 해요. 전체는 (serverName, rawName)의 순수 함수예요. 연결 순서, 재동기화, 다른 서버도 도구 이름을 못 바꿔요.

export function publicToolName(serverName: string, rawName: string): string {
  const joined = `mcp__${serverName}__${rawName}`
  const normalized = joined.replace(INVALID_NAME_CHARS, '_')
  if (normalized === joined && normalized.length <= MAX_PUBLIC_NAME_LENGTH) return normalized
  const hash = createHash('sha256').update(`${serverName}\0${rawName}`).digest('hex').slice(0, HASH_LENGTH)
  return `${normalized.slice(0, MAX_PUBLIC_NAME_LENGTH - HASH_LENGTH - 1)}_${hash}`
}

두 번째 설계 포인트는 세대(generation)예요. 서버 도구 목록은 바뀔 수 있고, 바뀌면 다시 동기화해요. 동기화는 두 단계예요. 먼저 다음 세대의 도구 정의를 전부 받아 만들고, 한 단계라도 실패하면 레지스트리는 건드리지 않아 이전 세대가 그대로 살아 있어요. 다 받은 뒤에야 교환해요 — 옛 세대를 해제하고 새 세대를 등록해요.

교환 단계 작성법은 짚을 만해요. 등록 루프에서 도구를 하나 등록할 때마다 해제 함수를 표에 넣어요. 등록이 충돌을 던지면(외부 등록이 이 서버 네임스페이스를 점유했다는 뜻) catch 분기가 그 표에 있는 등록을 전부 해제해 도구를 하나도 남기지 않고, error 로그를 남겨요. 주석이 의도를 직설해요. 롤백은 모델이 완전한 한 세대만 보거나 아예 아무것도 안 보게 하려는 거지, 반쪽 세트는 절대 안 돼요.

출처: packages/mcp/mcp-client/src/tools.ts 159–172행의 등록·롤백 분기, 확인일 2026-08-13.

단선 후 재연결도 세대 위에 쌓여 있어요. stdio 서브프로세스가 죽으면 supervisor가 지수 백오프로 재시작해요. 첫 지연 기본 500ms, 매번 두 배, 상한 30초, 한 번의 중단에 최대 10회(README.zh.md 설정표). 중단 동안 마지막 정상 세대는 등록을 유지해요. 이때 호출은 실패하지만 도구 이름은 사라지지 않아요. 재연결되면 다시 발견하고, 복구된 세대가 옛 세대를 통째로 바꿔 도구가 중복되지도 새지도 않아요. serverName이 그대로면 새 세대 이름도 글자 그대로 같아 KV cache 접두사도 살아요. 예산도 있어요. 연결이 30초 넘게 살면 시도 예산을 리셋해서, 가끔 한 번 죽는 서버는 무한 복구되고, 반복 크래시 루프 서버는 예산을 다 써 해제되며 영원히 재시작하지 않아요.

마지막 설계 포인트는 놓치기 쉬워요. 이 브리지는 일부러 MCP의 tools 능력만 브리지해요. 프로토콜에는 resources(리소스)와 prompts(프롬프트 템플릿)도 있는데 DSH는 둘 다 안 붙였어요. README의 “알려진 제한과 보류 사항” 절이 솔직해요:

논리는 어렵지 않아요. harness 안에 외부 resource나 외부 prompt를 소비할 쪽이 없으니 먼저 교각을 놓을 이유가 없어요. 도구는 소비 주체가 분명해요(agent loop의 도구 호출). 그래서 도구부터 브리지해요. 필요할 때 다리를 놓는 거죠. 이미지·오디오 같은 비텍스트 결과도 손실 투영해서 모델 컨텍스트에는 자리표시자만 두고, 바이너리 페이로드는 넣지 않아요.

둘째 길은 전혀 달라요. Cordis는 DSH의 플러그인 프레임워크고, harness 전체가 Cordis 플러그인 트리예요. Extensions 서브시스템은 모델이 세션에서 Cordis 플러그인을 바로 쓰고 돌리게 해요. 코드를 쓰기 전에 cordis_inspect로 현재 런타임에 어떤 서비스·인터페이스가 있는지 묻고, cordis_define으로 소스를 제출하고, cordis_run으로 시작하고, 필요 없으면 cordis_stop이나 cordis_undefine이에요. 이 다섯 도구는 packages/extensions/tool-cordis가 등록해요.

동적 플러그인은 두 반쪽이에요. Host 반쪽은 Node 쪽 node:vm 샌드박스에서 로직을 돌리고, Browser 반쪽은 페이지에 UI를 그려요. 수명은 ctx.dynamicCordisRunner(packages/extensions/cordis-host-runner/src/index.ts 124행부터)가 한꺼번에 관리해요. Browser 반쪽이 있으면 시작할 때 승인이 필요해요. cordis/request-run 이벤트가 요청을 페이지로 보내고, 사용자가 허용해야 이어가요. 이 플러그인의 이후 버전도 함께 허용할 수 있어요(runHostHalf의 approveFutureVersions). Package 버전은 불변이고, 코드를 바꾸면 새 버전을 추가하는 거예요.

두 길을 나란히 보면 직교해요 — 각자가 한쪽을 맡아요. MCP 브리지는 프로세스 밖의 기성 능력을 마주하고, 신뢰 모델은 격리예요. 서버가 죽거나 쓰레기를 돌려주거나 끊겨도 세대와 오류 경로가 브리지 밖에 막아 두지만, 모델에게 줄 수 있는 건 도구뿐이에요. Extension은 모델이 현장에서 만든 코드를 자기 프로세스에서 돌리고, 능력면이 훨씬 커요. 도구·이벤트·서비스·UI를 다 더할 수 있지만, 매번 승인과 샌드박스 아래예요. 하나는 바깥 전기를 붙이고, 하나는 스스로 발전해요.