[Tool] Kiro CLI 2.0 실무 활용 - MCP 연동과 Headless Mode로 워크플로우 확장

Kiro CLI 2.0

4월에 Kiro CLI 2.0이 출시되면서 두 가지 핵심 기능이 추가됨:

1. Headless Mode: UI 없이 프로그래밍 방식으로 에이전트 실행
2. Windows 지원: 크로스 플랫폼 확장

실무에서 가장 임팩트가 컸던 건 Headless Mode임. CI/CD 파이프라인에 AI 에이전트를 끼워넣을 수 있게 됨.

---

MCP 서버 연동: Notion 업무 자동화

Kiro는 MCP(Model Context Protocol) 서버를 연결하여 외부 서비스와 상호작용할 수 있음. Notion MCP를 연결하면 에이전트가 직접 Notion 페이지를 읽고 쓸 수 있음.

활용 사례: 업무 일지 자동 생성

프로젝트에서 하루 작업이 끝나면 에이전트에게 “오늘 커밋 기반으로 업무 일지 작성해줘”라고 하면:

1. git log --since="today" 로 오늘 커밋 목록 조회
2. 변경된 파일과 커밋 메시지 분석
3. Notion MCP를 통해 업무 일지 DB에 새 페이지 생성
4. 카테고리, 설명 자동 채움

매일 10분씩 쓰던 업무 일지가 한 문장으로 끝남.

활용 사례: 트러블슈팅 문서 → Notion 동기화

docs/troubleshooting/ 에 작성된 트러블슈팅 문서를 Notion의 기술 위키에 자동으로 동기화. 마크다운 → Notion 블록 변환까지 에이전트가 처리.

---

Headless Mode: CI에 AI 에이전트 통합

Headless Mode는 --headless 플래그로 실행하며, stdin/stdout으로 프로그래밍 방식 제어가 가능함.

활용 사례: PR 자동 리뷰

#!/bin/bash
# .github/workflows/ai-review.sh
DIFF=$(git diff main...HEAD)

echo "다음 diff를 보안 관점에서 리뷰하라. 이슈가 있으면 JSON으로 출력." | \
  kiro chat --headless --agent analyst-security --stdin

PR이 올라오면 CI에서 보안 에이전트가 자동으로 diff를 분석하고, 이슈가 있으면 코멘트를 남기는 구조.

활용 사례: 배포 전 체크리스트 자동 검증

# deploy-check.sh
echo "serverless.yml의 IAM 권한이 최소 권한 원칙을 준수하는지 검증하라." | \
  kiro chat --headless --agent analyst-security --stdin

배포 전에 IAM 정책이 과도하게 열려있지 않은지 자동 검증. dynamodb:* 같은 와일드카드 권한이 있으면 경고.

---

메인 에이전트의 MCP 설정

// .kiro/agents/ebt-dashboard.json (발췌)
{
  "tools": [
    "read", "write", "shell", "aws",
    "report", "introspect",
    "delegate", "subagent",
    "grep", "glob", "code",
    "@context7",
    "@sequential-thinking"
  ],
  "mcpServers": {},
  "useLegacyMcpJson": true
}

useLegacyMcpJson: true로 설정하면 프로젝트 루트의 mcp.json에서 MCP 서버 설정을 읽음. Notion, GitHub, AWS 등 여러 MCP 서버를 한 곳에서 관리 가능.

---

Headless + Pipeline 조합

Headless Mode와 Pipeline을 조합하면 완전 자동화된 코드 품질 게이트를 만들 수 있음:

# CI pipeline step
kiro pipeline run --headless --target "src/" --output results.json

# results.json의 review.approved가 false면 CI 실패
APPROVED=$(jq -r '.stages.review.approved' results.json)
if [ "$APPROVED" != "true" ]; then
  echo "Code quality gate failed"
  exit 1
fi

evaluate → improve → review 파이프라인을 CI에서 돌리고, review 단계에서 approved: false가 나오면 빌드를 실패시키는 구조.

---

정리

기능	활용	효과
MCP (Notion)	업무 일지 자동 생성, 문서 동기화	일일 10분 절약
Headless Mode	PR 자동 리뷰, 배포 전 검증	수동 리뷰 부담 감소
Headless + Pipeline	CI 코드 품질 게이트	자동화된 품질 관리

Kiro CLI 2.0의 Headless Mode는 “AI 에이전트를 대화형으로만 쓰는” 한계를 깨뜨림. 스크립트에서 호출하고, CI에 끼워넣고, cron으로 돌릴 수 있게 되면서 활용 범위가 완전히 달라짐.