Claude Code에서 MCP 대신 CLI로 전환한 이유
Switched from MCPs to CLIs for Claude Code and honestly never going back
TL;DR Highlight
CLI는 Claude Code MCP에서 발생하던 파라미터 오류·인증 문제·타임아웃을 모두 제거했다.
Who Should Read
Claude Code로 개발 자동화를 구축 중인 개발자. 특히 MCP 설정 삽질에 지쳐 더 안정적인 에이전트 도구 연결 방식을 찾는 사람.
Core Mechanics
- MCP는 파라미터 오류, 인증 랜덤 실패, 타임아웃 등 실사용에서 잦은 문제가 발생함.
- CLI가 더 잘 작동하는 핵심 이유: Claude가 수년간의 shell script, 공식 문서, Stack Overflow로 학습돼 있어서 CLI 플래그와 엣지 케이스를 잘 암.
- 에이전트 친화적 CLI의 3가지 필수 조건: 구조화된 출력(--json, --jq), 비대화형(non-interactive) 모드, API 키 인증.
- 실전 추천 CLI 조합: gh(GitHub), ripgrep(코드 검색), composio(범용 에이전트 도구 연결), stripe(웹훅 테스트), supabase(로컬 DB), vercel(배포), sentry-cli(릴리즈 관리), neon(Postgres 브랜치).
- --json / --jq 플래그 지원 여부가 에이전트에서 CLI를 쓸 수 있는지 없는지를 가르는 핵심 기준.
Evidence
- MCP 대비 CLI는 파라미터 오류, 인증 실패, 타임아웃 등 실사용 장애 요인이 구조적으로 제거됨 (정량 수치 없음, 실사용 경험 기반).
- gh CLI는 --json + --jq 조합으로 GitHub 데이터를 구조화해 에이전트가 파싱 없이 바로 활용 가능.
- composio는 단일 CLI로 수백 개 외부 서비스를 에이전트에 연결할 수 있어 MCP 개별 설정 비용 대비 효율적.
How to Apply
- 기존에 MCP로 연결한 GitHub, Stripe, Supabase 등의 도구를 각 공식 CLI로 교체하고, --json 출력 + 환경변수 API 키 방식으로 Claude Code에 노출하면 된다.
- 새 CLI 도구를 에이전트에 붙이기 전에 '구조화 출력 있나(--json/--output json)?', '비대화형 모드 되나?', 'API 키 인증 되나?' 세 가지를 먼저 확인하는 체크리스트로 쓸 수 있다.
- composio CLI 하나만 설치하면 Claude Code가 Slack, Notion, Jira 등 수백 개 서비스를 CLI 명령 하나로 호출할 수 있어, 다수 MCP 서버 관리 부담을 줄일 수 있다.
Code Example
# 에이전트 친화적 CLI 패턴 예시
# GitHub: 구조화 출력으로 PR 목록 조회
gh pr list --json number,title,state --jq '.[] | select(.state=="OPEN")'
# Stripe: 웹훅 이벤트 로컬 테스트
stripe listen --forward-to localhost:3000/webhook --output json
# Supabase: 로컬 DB 마이그레이션
supabase db push --local
# Sentry: 릴리즈 등록
sentry-cli releases new $VERSION --format json
# Neon: Postgres 브랜치 생성 (피처 브랜치별 DB)
neon branches create --name feature/my-feature
# Ripgrep: 코드 검색 (JSON 출력)
rg 'TODO' --json | jq '.data.lines.text'Terminology
관련 논문
adamsreview: Claude Code용 멀티 에이전트 PR 코드 리뷰 파이프라인
Claude Code에서 최대 7개의 병렬 서브 에이전트가 각각 다른 관점으로 PR을 리뷰하고, 자동 수정까지 해주는 오픈소스 플러그인이다. 기존 /review나 CodeRabbit보다 실제 버그를 더 많이 잡는다고 주장하지만 커뮤니티에서는 복잡도와 실효성에 대한 회의론도 나왔다.
Claude를 User Space IP Stack으로 써서 Ping에 응답시키면 얼마나 빠를까?
Claude Code에게 IP 패킷을 직접 파싱하고 ICMP echo reply를 구성하도록 시켜서 실제로 ping에 응답하게 만든 실험으로, 'Markdown이 곧 코드이고 LLM이 프로세서'라는 아이디어를 네트워크 스택 수준까지 밀어붙인 재미있는 사례다.
AI Agent를 위한 Git: re_gent
AI 코딩 에이전트(Claude Code 등)가 수행한 모든 툴 호출을 자동으로 추적하고, 어떤 프롬프트가 어느 코드 줄을 작성했는지 blame까지 가능한 버전 관리 도구다.
Agent-Native CLI를 위한 설계 원칙 10가지
AI 에이전트가 CLI 도구를 더 잘 사용할 수 있도록 설계하는 원칙들을 정리한 글로, 에이전트가 CLI를 도구로 활용하는 빈도가 높아지면서 이 설계 방식이 실용적으로 중요해지고 있다.
Agent-harness-kit: MCP 기반 멀티 에이전트 워크플로우 오케스트레이션 프레임워크
여러 AI 에이전트가 서로 역할을 나눠 협업할 수 있도록 조율하는 scaffolding 도구로, Vite처럼 설정 없이 빠르게 멀티 에이전트 파이프라인을 구성할 수 있다.
Tilde.run – AI Agent를 위한 트랜잭션 기반 버전 관리 파일시스템 샌드박스
AI 에이전트가 실제 프로덕션 데이터를 건드려도 롤백할 수 있는 격리된 샌드박스 환경을 제공하는 도구로, GitHub/S3/Google Drive를 하나의 버전 관리 파일시스템으로 묶어준다.