CPN 한국어 자습서 · 외부 문서 한국어 미러
MCP 문서 · Develop
Build with Agent Skills · 원문: modelcontextprotocol.io/docs/develop/build-with-agent-skills
아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.
에이전트 스킬을 사용해 AI 코딩 어시스턴트가 MCP 서버 설계 및 구현을 수행하도록 안내합니다.
에이전트 스킬은 AI 코딩 어시스턴트에게 작업에 필요한 도메인 지식을 제공하는 이식 가능한 명령 집합입니다. MCP 개발에서는 배포 모델, 도구 패턴, 인증 등의 설계 결정 사항을 인코딩하여 에이전트가 사용 사례를 파악하고 적합한 서버를 스캐폴딩할 수 있게 합니다.
MCP 개발 스킬 참조 세트는 mcp-server-dev 플러그인으로 제공됩니다. 세 가지 스킬로 구성됩니다.
| 스킬 | 목적 |
|---|---|
build-mcp-server |
진입점. 사용 사례를 파악하고, 배포 모델과 도구 설계 패턴을 선정한 후, 전문 스킬로 라우팅합니다. |
build-mcp-app |
채팅 내에서 인라인으로 렌더링되는 대화형 UI 위젯(폼, 피커, 대시보드)을 서버에 추가합니다. |
build-mcpb |
사용자가 Node 또는 Python 없이 설치할 수 있도록 로컬 stdio 서버를 런타임과 함께 패키징합니다. |
각 스킬은 SKILL.md 파일과 에이전트가 필요 시 읽는 참고 자료(references/ 폴더 — 인증 흐름, 도구 설계 패턴, 위젯 템플릿, 매니페스트 스키마)를 포함합니다. 파일은 오픈 포맷을 따르며 표준을 구현하는 모든 에이전트에서 사용할 수 있습니다. 예를 들어, Claude Code에 설치하려면 다음과 같이 실행합니다.
/plugin marketplace add anthropics/claude-plugins-official /plugin install mcp-server-dev
다른 에이전트의 경우 스킬 또는 확장 카탈로그를 확인하거나, 스킬 디렉터리(SKILL.md 및 references/)를 에이전트의 스킬 위치에 클론하세요.
스킬이 설치되면 에이전트에게 MCP 서버 구축을 도와달라고 요청합니다. 진입 스킬은 자연어 요청으로 실행하거나, 에이전트의 스킬 호출 구문을 사용해 직접 호출할 수 있습니다.
스킬은 코드를 작성하기 전에 짧은 탐색 단계를 실행합니다. 다음 사항에 대한 질문을 예상하세요.
초기 메시지에서 이 내용을 이미 다룬 경우, 에이전트는 권장 사항으로 바로 이동합니다.
탐색 결과에 따라 스킬은 다음 네 가지 경로 중 하나를 권장하고 스캐폴딩을 수행합니다.
원격 Streamable HTTP는 클라우드 API를 래핑하는 모든 경우의 기본값입니다. 설치 부담이 없고, 단일 배포로 모든 사용자를 지원하며, 서버가 리디렉션과 토큰 저장을 처리할 수 있어 OAuth 흐름이 올바르게 작동합니다. 참조 스킬에는 Cloudflare Workers 및 이식 가능한 Express/FastMCP 설정을 위한 스캐폴드가 포함됩니다.
MCP 앱은 검색 가능한 피커, 차트, 라이브 대시보드 등 채팅에서 렌더링되는 대화형 위젯으로 서버를 확장합니다. 엘리시테이션의 플랫 폼 제약이 맞지 않을 때 스킬은 build-mcp-app으로 전환합니다.
MCP 번들(MCPB)은 로컬 서버를 런타임과 함께 단일 .mcpb 아카이브로 패키징하여, 사용자가 Node나 Python 설정 없이 설치할 수 있게 합니다. 서버가 사용자 머신에 접근해야 할 때 이 경로를 사용합니다. 로컬 파일 읽기, 데스크탑 앱 제어, 또는 localhost 서비스 통신 등이 해당됩니다. 스킬은 build-mcpb로 전환합니다.
로컬 stdio는 프로토타이핑에 계속 사용 가능하며, 배포 준비가 되면 MCPB로 업그레이드할 수 있습니다.
에이전트가 서버를 스캐폴딩하면 도구 설명과 오류 처리를 개선하고, 테스트 후 배포합니다.
원문(영어): https://modelcontextprotocol.io/docs/develop/build-with-agent-skills · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Model Context Protocol)에게 있습니다.
원문(영어): https://modelcontextprotocol.io/docs/develop/build-with-agent-skills