Claude Code에서 MCP 대신 CLI로 전환한 이유

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

관련 논문

• ctx – 로컬 머신의 코딩 에이전트 히스토리를 검색하는 CLI 도구

  Claude Code, Cursor, Codex 등 코딩 에이전트가 이전 세션의 논의·결정·실패 시도를 잊지 않도록 SQLite로 인덱싱해 재사용할 수 있게 해주는 오픈소스 CLI 도구다.

• Micro-Agent: Model API 내부 협업으로 Frontier 모델을 이기는 방법 (vLLM Semantic Router)

  vLLM 팀이 단일 모델 API 호출 뒤에서 여러 모델이 협업하는 'Micro-Agent' 개념을 공개했습니다. 별도의 에이전트 코드 없이 라우터 레이어에서 모델 조합을 실행해 GPT-4급 결과를 더 저렴하게 낼 수 있다는 아이디어입니다.

• Ornith-1.0: 에이전틱 코딩을 위한 자기 개선형 오픈소스 모델

  Gemma 4와 Qwen 3.5를 기반으로 파인튜닝한 코딩 특화 오픈소스 모델로, RL(강화학습)을 통해 스캐폴드(에이전트 실행 구조)까지 함께 최적화하는 방식을 주장하지만, 커뮤니티에서는 벤치마크 과최적화에 불과하다는 의심을 받고 있다.

• Tool-Augmented Agent에서의 Entity Binding 실패 분석

  AI 에이전트가 올바른 도구를 선택해도 잘못된 대상에 실행하는 'Entity Binding 실패' 문제를 정의하고, 이를 막는 실행 정책을 평가한 논문.

• Herdr: 터미널에서 여러 AI Agent를 한 번에 관리하는 Agent Multiplexer

  여러 AI 코딩 에이전트(Claude, Codex 등)를 하나의 터미널에서 동시에 실행·관리할 수 있는 Rust 기반 오픈소스 툴로, tmux처럼 세션이 유지되고 SSH로 원격 접속도 가능해 멀티 에이전트 워크플로우를 크게 단순화해준다.

• Ornith-1.0: 스스로 Scaffold를 생성하는 Agentic Coding LLM

  모델이 문제 풀이 전략(scaffold)을 직접 생성하고 개선하는 자기강화 학습 프레임워크를 적용한 오픈소스 코딩 특화 LLM으로, 9B 소형 모델부터 397B 대형 모델까지 라인업을 갖추고 SWE-Bench 등 주요 벤치마크에서 Claude Opus 4.7을 능가하는 성능을 보여줬다.

Related Resources

• https://cli.github.com/
• https://github.com/BurntSushi/ripgrep
• https://composio.dev/
• https://stripe.com/docs/stripe-cli
• https://supabase.com/docs/reference/cli
• https://vercel.com/docs/cli
• https://docs.sentry.io/cli/
• https://neon.tech/docs/reference/neon-cli