코스 카탈로그

AI를 위한 도구 만들기

실제 클라이언트가 불러오는 MCP 서버와 스킬을 출시하세요.

고급
레슨 16개
프로젝트 2개
약 2.5시간
EN · UZ · KO

‘AI를 도구에 연결하기’가 MCP가 무엇인지 가르쳤다면, 이 강좌는 그것을 실제로 출시하는 방법을 다룹니다. 출발점은 당신이 진짜로 설계 대상으로 삼아야 할 호출자입니다 — 문서를 절대 열어보지 않고, 도구 이름만 보고 경로를 정하며, 당신이 돌려준 모든 단어에 토큰을 지불하는 모델이죠. 도구·리소스·프롬프트·스킬 중에서 무엇을 쓸지 고르고, initialize에서 tools/list를 거쳐 tools/call까지 이어지는 세션을 stdio와 streamable HTTP 위에서 추적하며, 당신의 도구 목록이 매 턴마다 얼마의 비용을 발생시키는지 계산합니다. 그다음 모델이 실제로 마주하는 부분을 설계합니다: 이름과 설명, 핸들러에 도달하기 전에 잘못된 호출을 거절하는 스키마, 모델이 곧바로 행동할 수 있을 만큼 작은 반환값, 그리고 무엇을 고쳐야 하는지 정확히 알려주는 오류. 이어서 stdio 서버를 세우고 실제 클라이언트에 등록해 승인 대기에서 연결됨으로 넘어가는 과정을 확인하고, 프론트매터가 실제로 작동하는 SKILL.md를 작성합니다. 마지막은 신뢰의 영역입니다 — 라우팅과 실행을 분리해 측정하는 eval, 프로덕션에서 만나는 네 가지 실패 유형, 동의를 전제로 설계한 권한, 그리고 남들이 불러오기 전에 감사할 수 있도록 버전을 매기고 배포하는 방법.

커리큘럼

섹션 1
당신이 노출하는 표면
모델이 당신의 서버에서 실제로 보는 것: 프리미티브, 트랜스포트, 그리고 도구 목록의 토큰 비용.
1. 당신의 사용자는 모델입니다
2. 올바른 프리미티브 고르기
3. stdio, HTTP 그리고 핸드셰이크
4. 발견과 토큰 비용
섹션 2
도구 설계하기
이름, 스키마, 반환값, 오류 — 모델이 실제로 만지는 네 가지 표면.
1. 이름과 설명이 곧 API입니다
2. 실수를 막는 스키마
3. 반환값 설계하기
4. 모델이 복구할 수 있는 오류
섹션 3
서버와 스킬 출시하기
stdio 서버를 세우고, 실제 클라이언트에 등록하고, 에이전트가 스스로 불러오는 스킬을 작성합니다.
1. 서버 세우기
2. 클라이언트에 연결하기
3. 스킬 작성하기
4. 스킬, 서버, 서브에이전트
섹션 4
믿을 수 있게 만들기
라우팅과 실행을 분리해 재는 eval, 실제로 만나게 될 실패 유형, 동의를 전제로 한 설계, 그리고 남들이 감사할 수 있는 것을 내보내기.
1. 에이전트 도구를 위한 eval
2. 현장의 실패 유형
3. 설계에서 시작하는 권한과 동의
4. 배포, 버전 관리, 신뢰