facts

이번에 공개된 agent-connector는 MCP(Model Context Protocol) 서버와 훅(Hook) 설정을 다양한 에이전트 CLI(Command Line Interface)에 일괄 배포하기 위한 도구다. 핵심 목적은 에이전트 호스트마다 서로 다른 설정 포맷과 이벤트 모델로 인해 발생하는 반복적인 설정 작업을 자동화하는 것이다.

현재 이 도구는 총 42개의 에이전트 CLI를 대상으로 설정을 생성할 수 있도록 지원한다. 개발자가 직접 MCP 서버를 구축할 때 겪는 호스트별 설정 파편화 문제를 해결하는 데 초점을 맞췄다. 특히 기존 MCP 서버인 'context-mode'를 포팅해 검증한 결과, 배포 관련 코드 규모와 관리 포인트에서 유의미한 수치 변화가 확인됐다.

검증 결과에 따르면, 호스트별 배포 코드는 기존 20,322줄에서 76줄로 감소했다. 또한, 각 CLI에 맞춰 개별적으로 작성해야 했던 훅 스크립트는 71개에서 0개로 줄어들었으며, 지원 가능한 CLI 범위는 15개에서 42개로 확대됐다. 해당 프로젝트는 Apache-2.0 라이선스로 공개되었으며, npm 패키지 `@ken-jo/agent-connector`를 통해 배포된다.

how-it-works

작동 방식의 핵심은 단일 정의를 각 호스트가 읽을 수 있는 네이티브 설정 파일로 렌더링하는 구조에 있다. 개발자는 `defineConnector()` 함수를 통해 서버, 훅, 플러그인, 마켓플레이스 정보를 한 번만 정의한다.

typescript
defineConnector({
 server,
 hooks,
 plugins,
 marketplace,
})

이 방식은 중간에 래퍼(Wrapper)를 실행하거나 독자적인 포맷을 강제하는 방식이 아니다. 대신 각 에이전트 CLI가 원래 요구하는 설정 파일 형식을 그대로 생성한다. 예를 들어 Claude Code의 경우 JSON 기반의 `mcpServers` 설정을, Codex는 TOML 기반의 `[mcp_servers.*]` 설정을, Cursor는 `mcp.json`과 `hooks.json`을, Gemini는 `.gemini/settings.json` 파일을 각각 생성해 렌더링한다.

특히 호스트마다 서로 다른 훅 이벤트 모델을 정규화하는 파이프라인을 갖추고 있다. 동일한 동작을 수행하더라도 CLI마다 이벤트 발생 시점이나 전달 인자가 다른데, agent-connector가 이 모델을 변환하여 각 호스트에 맞는 형태로 출력한다. 이를 통해 개발자는 개별 CLI의 이벤트 모델을 일일이 분석해 스크립트를 짤 필요 없이, 정규화된 정의만으로 훅을 작동시킬 수 있다.

implementation-impact

개발자와 실무자가 도입 시 가장 먼저 체감하는 변화는 설정 관리의 제어권 이동이다. 기존에는 새로운 에이전트 CLI를 도입할 때마다 해당 도구의 설정 문서와 포맷을 확인해 수동으로 파일을 수정해야 했으나, 이제는 단일 설정 파일의 업데이트만으로 42개 CLI에 동시 적용이 가능하다.

실제 운영 단계에서는 다음과 같은 명령어를 통해 배포와 관리를 수행한다.

bash

설정 일괄 설치

$ agent-connector install

잔여 설정까지 포함한 완전 제거

$ agent-connector uninstall --purge

특정 브랜드 플러그인 설치

$ plugin install brand-name

운영 효율 측면에서는 `uninstall --purge` 명령어를 통해 각 호스트에 흩어진 잔여 설정 파일을 한 번에 제거할 수 있어 환경 오염을 방지할 수 있다. 또한, 'per-tool 토큰 텔레메트리(Telemetry)' 기능을 통해 어떤 도구에서 얼마만큼의 토큰이 소비되는지 추적할 수 있어, 비용 최적화 및 성능 모니터링의 근거로 활용 가능하다.

더 나아가 SDK를 통해 자체 브랜드의 CLI를 생성할 수 있는 기능을 제공하므로, 기업 내부에서 표준화된 에이전트 환경을 구축하려는 팀은 개별 설정 파일 관리 대신 SDK 기반의 통합 배포 체계를 검토해야 한다. 상세한 구현 내용은 GitHub([https://github.com/ken-jo/agent-connector]) 및 공식 데모 페이지([https://agent-connector.ai])에서 확인할 수 있다.