에이전트 스킬로 구축하기

에이전트 스킬로 구축하기 (Build with Agent Skills)

에이전트 스킬을 사용해 AI 코딩 어시스턴트가 MCP 서버 설계와 구현을 안내하도록 만들어 보세요. 에이전트 스킬은 설계 결정(배포 모델, 도구 패턴, 인증)을 인코딩해서, 에이전트가 사용 사례를 파악하고 맞는 서버를 생성해 주는 이식 가능한 명령어 집합이에요.

출처: 문서

본문

에이전트 스킬은 작업에 필요한 도메인 지식을 AI 코딩 어시스턴트에게 주는 이식 가능한 명령어 집합이에요. MCP 개발을 위해선 설계 결정(배포 모델, 도구 패턴, 인증)을 인코딩해서, 여러분의 에이전트가 사용 사례를 파악하고 그에 맞는 서버를 생성해 주도록 도와줘요.

제공되는 스킬

MCP 개발용 참조 스킬 세트가 mcp-server-dev 플러그인으로 제공됩니다. 이 플러그인은 세 가지 조합 가능한 스킬을 제공해요.

스킬 용도
build-mcp-server 진입점. 사용 사례를 파악하고, 배포 모델과 도구 설계 패턴을 고르며, 특화 스킬로 라우팅해요.
build-mcp-app 채팅 안에 인라인으로 렌더링되는 상호작용 UI 위젯(폼, 피커, 대시보드)을 추가해요.
build-mcpb 로컬 stdio 서버를 런타임과 함께 패키징해서, Node나 Python 없이도 설치할 수 있게 해 줘요.

각 스킬은 SKILL.md 파일과 함께, 에이전트가 필요할 때 읽는 references/ 폴더의 보조 자료(인증 흐름, 도구 설계 패턴, 위젯 템플릿, 매니페스트 스키마)를 담고 있어요. 파일은 공개 형식을 따르며 표준을 구현하는 어떤 에이전트에서든 동작합니다. 예를 들어 Claude Code에 설치하려면:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install mcp-server-dev

다른 에이전트라면 스킬 또는 확장 카탈로그를 확인하거나, 스킬 디렉터리(SKILL.md 및 references/)를 에이전트의 스킬 위치에 복제하면 됩니다.

구축 시작하기

스킬을 설치한 뒤, 에이전트에게 MCP 서버 구축을 도와달라고 요청하세요. 진입 스킬은 자연어 요청에 반응해 발동되며, 에이전트의 스킬 호출 문법으로 직접 호출할 수도 있어요.

스킬은 코드를 쓰기 전에 짧은 발견(discovery) 단계를 실행합니다. 다음과 같은 질문을 기대할 수 있어요.

  • 무엇에 연결하는지 — 클라우드 API, 로컬 프로세스, 파일시스템, 하드웨어
  • 누가 사용할지 — 여러분 자신, 팀, 또는 설치하는 모든 사람
  • 액션 표면 크기 — 소수의 작업인지, 큰 API를 감싸는 것인지
  • 사용자 상호작용 요구 — 일반 텍스트 결과인지, elicitation을 통한 구조화된 입력인지, 풍부한 UI 위젯인지
  • 업스트림 인증 — API 키, OAuth 2.0, 또는 없음

시작 메시지에 이미 이 내용이 담겨 있으면, 에이전트는 권장 사항으로 바로 건너뜁니다.

배포 경로

발견 결과에 따라 스킬은 네 가지 경로 중 하나를 권장하고 그에 맞게 스캐폴딩해요.

원격 Streamable HTTP 는 클라우드 API를 감싸는 모든 것의 기본값이에요. 설치 마찰이 없고, 한 번의 배포로 모든 사용자를 서빙하며, 서버가 리다이렉트와 토큰 저장을 처리할 수 있으므로 OAuth 흐름이 제대로 동작하죠. 참조 스킬에는 Cloudflare Workers와 이식 가능한 Express/FastMCP 설정용 스캐폴드가 포함돼 있어요.

MCP apps 는 검색 가능한 피커, 차트, 라이브 대시보드 같은 채팅 안에서 렌더링되는 인터랙티브 위젯으로 서버를 확장해요. 스킬은 elicitation의 평면 폼 제약이 맞지 않을 때 build-mcp-app으로 넘겨줍니다.

MCP Bundles (MCPB) 는 로컬 서버를 런타임과 함께 단일 .mcpb 아카이브로 패키징해서, 사용자가 Node나 Python을 설정하지 않고도 설치할 수 있게 해 줘요. 서버가 사용자의 머신에 닿아야 할 때(로컬 파일 읽기, 데스크톱 앱 구동, localhost 서비스 통신) 이 경로를 사용하세요. 스킬은 build-mcpb로 넘겨줍니다.

로컬 stdio 는 프로토타이핑용으로 계속 사용 가능하며, 배포할 준비가 되면 MCPB로 업그레이드하는 경로가 명시돼 있어요.

다음 단계

에이전트가 서버를 스캐폴딩한 뒤에는 도구 설명과 오류 처리를 반복하고, 테스트 후 배포하세요.

더 알아보기 (Learn more)