에이전트 스킬로 빌드하기 (Build with Agent Skills)¶
MCP 서버를 처음부터 설계하다 보면 막상 어디서부터 손을 대야 할지 막막해요. 어떤 배포 방식을 쓸지, 도구를 어떻게 나눌지, 인증은 어떻게 처리할지 — 결정해야 할 게 한두 가지가 아니거든요. 에이전트 스킬(Agent skills)은 바로 여기서 힘을 발휘해요.
에이전트 스킬은 AI 코딩 어시스턴트에게 특정 작업을 위한 도메인 지식을 주는 휴대 가능한 명령 집합(portable instruction set) 이에요. MCP 개발에서는 배포 모델, 도구 패턴, 인증 같은 설계 결정을 미리 스킬 안에 담아 둡니다. 그러면 에이전트가 당신의 사용 사례를 먼저 물어보고, 거기에 맞는 서버를 스캐폴딩해 줄 수 있어요.
사용 가능한 스킬¶
MCP 개발용 참조 스킬 세트가 mcp-server-dev 플러그인으로 제공돼요. 이 플러그인은 세 개의 스킬로 구성되어 있죠.
| 스킬 | 역할 |
|---|---|
build-mcp-server |
진입점이에요. 사용 사례를 물어보고, 배포 모델과 도구 설계 패턴을 고른 뒤 전문 스킬로 연결해 줘요. |
build-mcp-app |
채팅 안에 인라인으로 렌더링되는 인터랙티브 UI 위젯(폼, 피커, 대시보드)을 추가해요. |
build-mcpb |
로컬 stdio 서버를 런타임과 함께 패키징해서, Node나 Python 없이도 설치할 수 있게 해 줘요. |
각 스킬은 SKILL.md 파일과 함께 references/ 폴더를 동봉해요. 이 폴더에는 인증 흐름, 도구 설계 패턴, 위젯 템플릿, 매니페스트 스키마 같은 보조 자료가 있고, 에이전트가 필요할 때 읽어요. 이 파일들은 공개 형식을 따르기 때문에 표준을 구현한 어떤 에이전트에서도 동작해요.
예를 들어 Claude Code에 설치하려면 이렇게 하면 돼요.
다른 에이전트를 쓴다면 스킬이나 확장 카탈로그를 확인하거나, 스킬 디렉터리(SKILL.md + references/)를 에이전트의 스킬 위치에 복제하면 됩니다.
빌드 시작하기¶
스킬을 설치했다면 에이전트에게 MCP 서버를 만들어 달라고 요청해 보세요. 진입 스킬은 자연어 요청에 반응해서 발동되고, 에이전트의 스킬 호출 문법으로 직접 호출할 수도 있어요.
스킬은 코드를 쓰기 전에 짧은 탐색(discovery) 단계를 먼저 실행해요. 물어보는 내용은 대략 이렇죠.
- 어디에 연결하나요 — 클라우드 API, 로컬 프로세스, 파일시스템, 하드웨어
- 누가 쓸까요 — 당신 혼자, 팀 전체, 아니면 설치하는 모든 사람
- 액션 범위는 얼마나 되나요 — 몇 개의 연산인지, 아니면 큰 API를 통째로 감싸는 건지
- 사용자 상호작용이 필요하나요 — 평범한 텍스트 결과, elicitation을 통한 구조화 입력, 또는 풍부한 UI 위젯
- 업스트림 인증 방식은요 — API 키, OAuth 2.0, 아니면 인증 없음
시작 메시지에 이미 이런 내용이 담겨 있다면 스킬은 건너뛰고 바로 추천으로 넘어가요.
배포 경로¶
탐색 결과에 따라 스킬은 네 가지 경로 중 하나를 추천하고 그에 맞춰 스캐폴딩해요.
원격 Streamable HTTP 는 클라우드 API를 감싸는 작업이라면 기본값이에요. 설치 장벽이 없고, 배포 한 번으로 모든 사용자를 처리하며, OAuth 흐름도 제대로 동작해요 — 서버가 리다이렉트와 토큰 저장을 처리할 수 있기 때문이죠. 참조 스킬에는 Cloudflare Workers용 스캐폴드와 휴대 가능한 Express/FastMCP 설정이 포함되어 있어요.
MCP 앱 은 서버를 확장해서 채팅 안에 검색 가능한 피커, 차트, 실시간 대시보드 같은 인터랙티브 위젯을 렌더링해 줘요. elicitation의 플랫 폼 제약으로 맞지 않을 때, 스킬은 build-mcp-app으로 인계해요.
MCP 번들(MCPB) 은 로컬 서버를 런타임과 함께 단일 .mcpb 아카이브로 패키징해서, 사용자가 Node나 Python을 설정하지 않고도 설치할 수 있게 해 줘요. 서버가 사용자의 머신에 닿아야 할 때 — 로컬 파일을 읽거나, 데스크톱 앱을 조종하거나, localhost 서비스와 통신할 때 — 이 경로를 쓰면 돼요. 이 경우 스킬은 build-mcpb로 인계해요.
로컬 stdio 는 프로토타이핑용으로 여전히 사용할 수 있고, 배포할 준비가 되면 MCPB로 업그레이드하는 경로가 명시되어 있어요.
다음 단계¶
에이전트가 서버를 스캐폴딩하고 나면, 도구 설명과 에러 처리를 다듬은 다음 테스트하고 배포하면 돼요.
- MCP Inspector — 서버의 도구, 리소스, 프롬프트를 인터랙티브하게 테스트해요.
- 클라이언트에 연결하기 — 로컬 또는 원격 설정으로 서버를 MCP 클라이언트에 연결해요.
- Registry에 게시하기 — MCP Registry에서 서버를 찾을 수 있게 만들어요.
응답은 AI로 생성되며 실수가 포함될 수 있습니다.