Cozlab

[바이브 코딩] 4. 함정 : 바이브 코딩이 무너지는 순간

잘 굴러가던 바이브 코딩이 어느 순간 헛돌기 시작한다. 컨텍스트 초과, 큰 리팩터, 애매한 요구. 무너지는 지점과 처방.

AI 코드는 그럴듯한데 미묘하게 틀릴 때가 있다. 없는 라이브러리를 부르고, 오래된 API를 쓰고, 보안 구멍을 남긴다. 검수 기준을 세워야 한다.

바이브 코딩 도구는 크게 두 갈래다. 에디터 안에서 돕는 Cursor, 터미널에서 자율적으로 일하는 Claude Code. 성격이 다르니 쓰는 자리도 다르다.

코드를 한 줄씩 치던 시대에서, AI에게 방향을 주고 결과를 검수하는 시대로 넘어왔다. 바이브 코딩이 실제로 어떻게 굴러가는지.

MCP 서버는 결국 모델이 실제 도구를 실행하는 통로다. 편해진 만큼 열어준 문도 넓어졌다. 인증·권한·프롬프트 인젝션을 짚는다.

날씨 예제는 예제일 뿐이다. 이미 굴러가는 사내 REST API를 MCP 도구로 감싸면, 챗봇이 우리 시스템과 대화하기 시작한다.

서버를 만들었으면 이제 Claude가 그 도구를 쓰게 해야 한다. 설정 파일 한 곳만 고치면 된다. 연결부터 디버깅까지.

말로만 개념을 잡으면 안 와닿는다. 파이썬으로 도구 하나 노출하는 최소 MCP 서버를 직접 만들어 본다. 데코레이터 하나면 끝이다.

도구 하나 붙일 때마다 매번 다른 방식으로 연동하다 지쳤다. MCP는 그 연결을 표준으로 만든 규격이다. USB-C에 비유해 개념을 잡아본다.

검색한 문서를 프롬프트에 넣고 근거만으로 답하게 만드는 마지막 단계. 환각을 줄이는 지시문과 프롬프트 캐싱까지.