MCP 서버 구축 가이드

무엇을 해주나

• MCP(Model Context Protocol) 서버의 범위, 신뢰 경계, 전송 방식(stdio/HTTP), 신원 흐름을 먼저 정의하게 만듭니다.
• 도구(tool) 카탈로그를 만들 때 입력/출력/오류 스키마, 부작용(읽기·쓰기·삭제·과금·외부 전송) 분류, 데이터 등급, 인가 모드, 멱등성을 명시하도록 강제합니다.
• 단위·통합·인가·프로토콜 상호운용성 테스트 목록과 "실제로 실행한 증거만 보고하라"는 검증 원칙을 제시합니다.
• 배포·롤백·모니터링·자격증명 폐기 절차와 사고 대응 흐름까지 다룹니다.
• 동봉된 설계 템플릿, 도구 매니페스트 검증 스크립트, 설계 체크리스트를 함께 활용합니다.

이런 분께 추천

• 새 MCP 서버를 처음 만들거나 기존 API·DB를 MCP로 노출하려는 백엔드/플랫폼 개발자
• 사내 MCP 서버를 프로덕션에 올리기 전 보안·인가 리뷰가 필요한 팀
• 도구 스키마와 오류 규약을 표준화하려는 AI 에이전트 엔지니어

활용 예시

1. "재고 조회용 읽기 전용 MCP 서버를 만들어줘" → 지역 기반 접근 제한, 결과 개수 상한, 원가 마스킹, 권한 위반 시 일반화된 forbidden 응답 테스트까지 설계.
2. "티켓 수정 도구를 추가하고 싶어" → 초안(draft)과 적용(apply) 도구를 분리하고, 티켓 ID·패치 해시·행위자에 결합된 단기 승인과 멱등성 처리를 추가.
3. "기존 MCP 서버 설계를 검토해줘" → 매니페스트 린트 실행, 스키마 경계 테스트, 테넌트 교차 접근·토큰 오디언스 오류 케이스 점검 결과를 증거와 함께 보고.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/seb1n/awesome-ai-agent-skills/HEAD/agent-engineering/mcp-server-building/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 seb1n/awesome-ai-agent-skills 의 agent-engineering/mcp-server-building 폴더를 내 ~/.claude/skills/mcp-server-building/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.