사내 위키 MCP 서버 반나절 만에 띄움 (진짜 어려운 건 description)

사내 위키·이슈 트래커를 Claude에 물려주려고 MCP 서버 직접 짬. RAG 벡터DB 박을 줄 알았는데 @modelcontextprotocol/sdk 깔고 tool 3개 정의가 끝. 반나절이면 됨.

• tool은 사실상 함수 시그니처 + 설명 한 줄. REST 핸들러 짜던 거랑 다를 게 없음
• 진짜 난관은 코드 아니라 description. '위키 검색'이라고만 적으니 모델이 이슈 번호로 위키 뒤지고 빈 쿼리 날림. '키워드는 명사 위주로'까지 박아야 똑똑해짐
• stdio 서버에서 console.log 금지. stdout이 JSON-RPC 채널이라 한 줄 찍으면 깨짐. console.error(stderr)로만

코드 난이도보다 '모델이 이 tool을 언제 부를지' 설계가 9할인 듯.