좋은 MCP 도구 정의와 형편없는 정의의 차이

MCP 도구는 함수와 설명을 정의하면 AI 모델이 적절할 때 호출하는 방식으로 간단하다.

도구 정의의 품질이 AI가 유용한지 아니면 계속 혼란스러운지를 결정한다.

도구 이름은 시니어 엔지니어가 쓸 법하게: 동사+명사+컨텍스트 — 일반적인 이름을 피하라(예: get_data 대신 get_overdue_device_patches처럼 명확하게).

파라미터는 유형, 기본값, 명확한 설명을 명시하라(예: days_since_last_patch 기본 30, os_filter는 선택적).

관심사를 분리해 도구를 집중시키고, Conexor.io 사례에서 컬럼 수준 설명과 파라미터 타입을 추가하면 AI 쿼리 정확도가 향상됐다.