소개
17기에서 욕심이 앞서 PRD가 비대해졌던 경험을 지나, 18기 2탄은 “작게 시작해서 빠르게 피드백 받기”에 집중했습니다. 이번에 제가 몰입한 두 가지는 다음이에요:
FastAPI로 백엔드 골격 완성 (헬스체크/주문/잔고/포지션 등 기본 엔드포인트)
MCP 기반 에이전트 세팅으로 개발 루프 가속 ⟶ Context7 MCP로 최신 레퍼런스 주입, KIS Code Assistant MCP로 한국투자증권 OpenAPI 코드 리뷰 보조
아이러니하게도, 에이전트가 있다고 해서 바로 정답이 나오진 않았어요. 하지만 로그와 컨텍스트를 성실히 먹여주면 점진적으로 고쳐나간다는 걸 몸소 느꼈습니다.
진행 방법
1) MCP 에이전트: Context7 + KIS Code Assistant
이번 주 베스트사례 발표에서 지영님의 사례를 보고 클로드 코드에 MCP를 손쉽게 설치하였습니다. 지영님 감사합니다. Context7의 MCP를 설치해서 유용하게 사용하였고, KIS(한국투자증권) 사이트를 보니 코딩도우미 MCP를 지원하고 있었습니다. 두 MCP를 이용하여 코드리뷰하는 agent를 만들었고 유용하게 사용하였습니다.
(1) Context7 MCP로 “최신 문서” 바로 먹이기
사용 이유: 레거시/환각 코드를 줄이고 현재 버전의 공식 문서/예시를 프롬프트에 직접 주입
효과: “API가 바뀌었는데요?” 류의 삽질이 크게 줄어듭니다
(2) KIS Code Assistant MCP 도입
지난주에 손수 만든 KIS.md 대신, KIS Code Assistant MCP를 설치하여 코드리뷰에 활용
장점: 인증/주문/체결 등 KIS OpenAPI 규약 맥락을 에이전트가 바로 이해 → 리뷰 응답의 품질이 상승
(예고) KIS Trading MCP 오픈 예정: LLM이 시세/주문 등 실시간 상호작용을 더 직접적으로 수행할 수 있는 길이 열릴 전망
2) FastAPI 백엔드 구현
에이전트들을 이용해서 초기 코드는 금방 짜고 초기 검토도 진행하였습니다.
다만 FastAPI쪽 구현 난이도가 높다보니 한번에 완성되진 않았습니다.
3) 계속된 코드 무한 코드 수정
로그를 잘 먹이면 잘 고친다
서버의 로그를 이미지로 붙여 주니 점진적으로 정확도가 높아졌습니다.
팁: Claude Code가 이미지 첨부(Alt+V)를 지원 → 콘솔/로그 캡처를 통째로 전달해 맥락 손실 최소화
토큰/세션 이슈 주의
MCP/Agent 사용 시 토큰 사용량 급증 → 컨텍스트를 의도적으로 줄이고, 로그는 필요한 구간만 잘라서 전달
에러 사례: 특정 세션에서 API Error가 반복 → 새 채팅으로 리셋하여 진행 (대화 기록 손실 리스크 인지)
결과와 배운 점
✅ FastAPI 기본 기능은 구현 완료. 카톡봇 연동 전 단계에서 엔드포인트 등 안정화
🔍 메신저봇 쪽 에러가 있는 것으로 추정, 현재 검증 중
🤖 에이전트는 만능이 아님. 로그/컨텍스트를 충실히 제공해야 성능이 오른다
🧠 MCP + 커스텀 커맨드는 개발 루프를 체감적으로 줄여준다 (문서 찾아다니는 시간 ↓)
⚠️ 토큰 한도/세션 안정성이 발생할 수 있음 → 중간 중간 /compact 실행 요약 로그/필수 컨텍스트만 전달, 필요 시 세션 리셋
다음 계획
메신저봇 오류 원인 확인
주식봇 완성
도움 받은 글
마치며
“에이전트가 답을 주는 게 아니라, 우리가 답을 꿰어가도록 돕는다.”
MCP/에이전트, 커스텀 커맨드까지 갖추면 개발 속도는 정말 빨라집니다. 다만 로그/컨텍스트 공수와 토큰 관리가 뒤따라야 해요. 다음 편에서는 메신저봇 오류를 털고 자동매매 루틴의 엔드투엔드 시연까지 가보겠습니다. 🚀
