Claude Code 개인 비서 에이전트 구축 With MCP & Sub Agent

소개

이번 스터디에서는 개발 이외의 영역에서 Claude Code를 어떻게 활용할 수 있는지 실험해보았습니다. Codex나 Gemini CLI는 얕게 경험한 적이 있었지만, Claude Code는 이번이 처음 설치였습니다. 스터디의 주제 자체가 "개발 외의 활용"이었기에, CLI 환경에서 Claude Code를 개인 비서처럼 활용하는 사례를 만들어보고자 했습니다 🧑‍💻.

특히 Claude Code의 Sub Agent 기능을 적극 활용하여, 메인 에이전트는 오케스트레이션(프롬프트 체이닝)만 담당하고, 실제 기능은 각 Sub Agent가 수행하는 구조를 설계했습니다.

현재 구현된 개인 비서는 할일/일정 관리 기능을 중심으로 동작하며, 앞으로 점차 기능을 확장할 계획입니다.

진행 방법

🧠 설계

메인 에이전트

역할: Sub Agent들을 조율하고 사용자 요청을 적절히 분배하는 오케스트레이션 레이어

서브 에이전트 구성

메모리 에이전트
- 개인 비서로서의 지시사항을 최신 상태로 업데이트
- ./CLAUDE.md 파일을 유동적으로 수정해, 장기 기억 및 MCP/Sub Agent 변경사항 반영
형상관리 에이전트
- Git/GitHub MCP를 통해 버저닝 및 롤백이 가능하도록 형상 관리 수행
- 변경 사항 발생 시 자동 커밋/푸시
할일/일정 관리 에이전트
- 사용자의 요청을 받아 할일(Task)은 Linear에, 일정(Schedule)은 Google Calendar에 기록
- Linear: 기간 내 수행할 작업 관리
- Calendar: 특정 이벤트나 고정 시간 일정 관리

🔧 MCP 연결 상황

[✅] GitHub MCP: https://github.com/github/github-mcp-server
[✅] Linear MCP: https://linear.app/docs/mcp
[❌] Google Calendar MCP: 인증 실패 (Dispatch URL 문제 → 해결 방법 불명). Smithery를 통한 연결을 시도했으나 인증 오류 발생.

📂 에이전트별 설정과 실행

메모리 에이전트

프롬프트 예시:

현재 변경 사항을 확인하고 CLAUDE.md를 작성해. claude-md-manager agent를 이용해.

결과: MCP 및 Sub Agent 변경사항이 CLAUDE.md에 잘 기록됨 ✅

형상관리 에이전트

정책 설정:

### Branch 정책
* main branch에서는 직접 작업하지 않는다.
* 작업은 별도 branch에서 수행 후 merge.

### Commit 정책
* commit 메시지는 상세하게.
* 여러 주제는 commit 분리.

### Push 정책
* commit 시 GitHub MCP로 push까지 자동 진행.
* push 실패 시 pull → merge → 재시도.

실행 예시:

저장소는 https://github.com/tot0rokr/PersonalAssistant.git 이거야. 장기기억해. 그리고 변경 사항에 대해서 커밋 푸시 해

결과: commit 및 push 정상 완료 ✅

할일/일정 관리 에이전트

프롬프트 설정:

# 할일 및 일정 관리

## 기본 원칙
* 사용자 요청 기반으로만 추가/변경/삭제
* 장기 일정 조정은 반드시 사용자 확인 후 반영

## 할일(Task)
* Linear MCP 활용
* due date 필수, priority는 Low 기본값
* 라벨: Home, Work, Side Project 등 분류

## 일정(Schedule)
* Google Calendar MCP 활용 (연동 실패 상태)
* 카테고리: Leisure, Social, Travel, Event

테스트 요청:

오늘 저녁 8시 전에 크몽 답장 해야한다고 할일 생성해

결과: Linear MCP에 Task 등록 성공 ✅ / Calendar MCP는 실패 ❌

결과와 배운 점

✅ 성과

Sub Agent를 활용해 메인은 오케스트레이션, 서브는 전문 기능 수행하는 구조 실현
GitHub, Linear MCP 연동 성공 → 개인 비서의 기본 기능 확보
CLI 환경에서 충분히 개인 비서 활용 가능성 확인

⚠ 문제점

토큰 과소비 이슈
- 클로드를 잘 안써서 API로 연결했는데 순식간에 5$ 소모함 ㅎㄷㄷ
- /context로 확인 시, MCP만 50k 토큰 소모 (전체의 25%)
- 대화 없이 새 세션 시작 시에도 기본 33k 토큰 사용
- GitHub MCP가 특히 토큰을 과도하게 사용

Google Calendar MCP 인증 실패
- Dispatch URL 문제로 인해 연동 불가

🔧 앞으로의 계획

과도한 토큰 소모와 불필요한 컨텍스트 낭비를 막기 위해 메인 에이전트는 MCP를 전혀 사용하지 않고, 오직 Sub Agent만 MCP를 활용하게 하고 싶음 → 현재 구조상 불가능해 보임
Calendar MCP 대체 방안 (Smithery 재검증 또는 다른 연동 방법) 시도 예정

도움 받은 글

🎯 마무리 메시지
이번 시도로 "Claude Code도 충분히 개인 비서 역할을 할 수 있다"는 가능성을 확인했습니다. 토큰 관리와 MCP 인증 문제가 남아있지만, Sub Agent 기반 구조 덕분에 앞으로 다양한 기능을 점진적으로 추가할 수 있을 것 같습니다 🚀.

다음 단계에서는 더 정교한 자동화 기능을 붙여 진짜 비서 같은 Claude Code로 발전시켜보겠습니다 🙌.

📣 24기 블라인드 판매가 시작되었습니다!