← 홈으로
문서 · Developers

Micky CLI · MCP

회의 지식을 터미널과 AI 에이전트로 꺼내 쓰는 공식 가이드입니다. 설치부터 Claude Code 연결까지 5분이면 됩니다.

시작하기

쓰는 방법은 두 가지예요. 대부분은 Micky를 자기 AI(Claude Code·Cursor·Codex·Gemini)에 연결해 자연어로 묻습니다 — 명령어를 외울 필요 없이 “지난 회의에서 이거 어떻게 정했지?”처럼요. 터미널에서 명령을 직접 치는 방식은 스크립트·자동화용으로 따로 있고요. 아래 설치·로그인 후 'AI에 연결'까지 하면 몇 분이면 됩니다.

준비물
  • Node.js 18 이상 (npm 포함)
  • Micky 계정 — 읽기 명령은 로그인만으로, AI 생성(ask·digest)은 베타 승인 계정
  • macOS · Linux · Windows(WSL 권장) 지원

1. 설치

npm으로 전역 설치합니다. 별도의 레지스트리 로그인 없이 GitHub 릴리스에서 바로 받습니다.

npm install -g https://github.com/Marco-Joshua/micky-cli-releases/releases/download/v0.1.3/micky-ai-0.1.3.tgz

설치가 끝나면 아래로 확인하세요.

micky --version
Tip
회사 프록시·사내망이라 설치가 막히면, 브라우저로 위 URL의 .tgz를 내려받아 `npm i -g ./micky-ai-0.1.3.tgz`로 설치하세요.

2. 로그인

브라우저가 열리고 Google로 로그인하면 세션이 CLI에 안전하게 저장됩니다(~/.micky). 한 번만 하면 됩니다.

micky login
브라우저가 자동으로 안 열리면 터미널에 표시된 URL을 직접 붙여넣으세요. 로그인 상태는 `micky whoami`로 확인합니다.

3. AI에 연결해 자연어로 쓰기 (MCP)

여기가 핵심입니다. MCP(Model Context Protocol)를 켜면 당신이 쓰는 AI가 회의를 도구로 직접 봅니다. 명령어 대신 그냥 평소처럼 대화하면 돼요 — “지난 회의에서 이거 어떻게 하기로 했지?” 하면 AI가 알아서 회의를 찾아 답합니다.

쓰는 에이전트에 맞춰 한 번만 등록하세요. 명령을 실행하면 설정 스니펫이 출력되고, 안내대로 넣으면 끝입니다.

micky mcp install claude

Cursor 등 다른 MCP 클라이언트는 위 명령이 출력하는 설정 스니펫을 각자의 MCP 설정에 그대로 붙여 쓰면 됩니다.

연결되면 에이전트에 생기는 도구

  • semantic_search — 의미로 회의 찾기 (무료)
  • create_digest — 여러 회의를 하나의 산출물로
  • ask_micky — 전체 회의 지식에 질문
  • list_meetings · get_meeting · get_transcript — 회의 조회
  • list_action_items — 미완 액션 횡단
  • open_loops — 미완 약속을 긴급도 버킷으로
  • get_usage — 사용량 확인

이제 AI에게 이렇게 말하면 돼요

“이번 스프린트 회의들에서 나온 내 액션 아이템만 모아서 정리해줘”
“지난 API 설계 회의에서 인증 방식 뭘로 정했는지 찾아줘”
“저번 기획 회의 결정대로 이 결제 함수 구현해줘”
“고객사 A랑 했던 회의들 요약해서 다음 미팅 브리핑 만들어줘”
“최근 회의들에서 아직 안 끝난 약속들만 뽑아줘”
“지난주 회의 내용으로 팀 공유용 마크다운 정리해줘”

활용 사례

터미널에서, 그리고 AI 에이전트 안에서 — 실제로 이렇게 씁니다.

AI 에이전트

코딩하다 회의 맥락이 필요할 때

"지난 API 설계 회의에서 인증 방식 뭘로 정했지?"

Claude Code·Cursor가 알아서 그 회의를 찾아 답해요. 슬랙을 뒤질 필요 없이 흐름 그대로.

터미널

매주 팀 주간보고

micky digest <이번주 회의 id들> --mode actions

여러 회의의 할 일이 담당자별 한 장으로. 크론에 걸어 매주 자동으로 받아요.

터미널

미팅 5초 전 브리핑

micky search "A사 온프레미스 조건" --semantic

그 얘기가 나온 회의를 크레딧 0으로 즉시 소환. 단어가 달라도 맥락으로 찾아요.

AI 에이전트

회의 결정대로 작업 위임

"지난 기획 회의에서 정한 결제 플로우대로 이 함수 구현해줘"

에이전트가 회의 결정을 참조해 코드까지 만들어요. 스펙을 다시 설명할 필요 없이.

터미널 명령어 (고급)

명령어를 외울 필요는 없어요 — 위처럼 AI에 물려 자연어로 쓰는 게 기본입니다. 이 명령들은 스크립트·CI·크론에 넣거나 터미널을 선호할 때 쓰세요. 어떤 명령에든 `--json`을 붙이면 스크립트용 JSON으로 나옵니다.

명령하는 일비용
micky meetings최근 회의 목록무료
micky meeting <id>한 회의의 메타 + 요약 + 결정 + 액션무료
micky transcript <id>전사 원문 전체무료
micky search "<검색어>"제목·요약 키워드 검색무료
micky search "<검색어>" --semantic의미(임베딩)로 회의 랭킹 — 단어가 달라도 맥락으로무료
micky digest <id...> --mode <mode>여러 회의를 하나로 (summary·actions·decisions·email)LLM
micky ask "<질문>"전체 회의 지식에 자연어로 질문 (RAG)LLM
micky actions미완 액션 아이템 전체 회의 횡단무료
micky loops미완 약속을 긴급도 버킷으로 (지남·임박·예정·미정)무료
micky export <id> -o note.md회의록을 마크다운으로 내보내기무료
micky usage크레딧·녹음 사용량무료
semantic search
`--semantic`은 임베딩으로 뜻이 가까운 회의를 찾습니다. “결제 정산”으로 검색해도 “빌링 마감 회의”가 잡혀요. LLM 합성이 없어 크레딧이 들지 않습니다.
digest
`--mode`는 summary(기본) · actions · decisions · email 중 하나입니다. 회의 id는 공백으로 여러 개(최대 60), `micky meetings`나 `search`에서 얻으세요.

문제 해결 · 참고

ask·digest가 402 오류를 내요

AI 생성 명령은 베타 승인 계정에서 동작합니다. micky usage로 상태를 확인하세요. 읽기 명령(search·transcript·export)은 로그인만으로 바로 됩니다.

--semantic 결과가 비어 있어요

회의가 아직 임베딩되기 전일 수 있어요. 회의가 끝나고 잠시 뒤 자동으로 색인되니 조금 기다렸다 다시 시도하세요.

명령을 못 찾는다고 나와요

설치가 끝났는지, 새 터미널을 열었는지 확인하세요. 최신 버전은 아래 릴리스에서 받을 수 있어요.

다음 단계

GitHub 릴리스 (최신 버전) →