MCP 서버
taco는 read-only MCP 서버를 제공합니다. Claude Code나 claude.ai·Claude 데스크톱에서 대화로 내 사용량을 조회할 수 있습니다.
연결 방식은 두 가지이며, 대상에 따라 조회 범위가 다릅니다.
| 서버 | 전송 | 조회 대상 | 연결 방법 |
|---|---|---|---|
taco (로컬) | stdio | 이 컴퓨터 기록 + 사용량 요약은 서버 폴백 | taco plugins(플러그인) |
taco-remote (원격) | HTTP | 모든 컴퓨터 합산(서버) | 커넥터 URL 추가 |
방법 A — taco CLI (taco plugins)
taco plugins가 감지된 도구에 플러그인을 설치하며 MCP 서버를 자동 등록합니다 — 로컬(taco, stdio)과 원격(taco-remote, HTTP) 둘 다.
taco plugins
- Claude Code 재시작(
.mcp.json은 시작 시 로드). /mcp에서taco·taco-remote연결 확인 → 승인. (taco-remote는 최초 1회 브라우저로 인프런 로그인)
이미 설치돼 있다면
/plugin에서 taco 플러그인을 최신으로 업데이트하거나taco plugins를 다시 실행하세요.
방법 B — 커넥터 URL (claude.ai · Claude 데스크톱)
CLI 설치 없이, 커넥터에 URL만 추가하면 모든 컴퓨터 합산 사용량을 조회할 수 있습니다.
-
claude.ai · Claude 데스크톱의 커넥터(MCP) 설정에서 아래 URL을 추가.
https://taco-api.inflearn.com/mcp -
연결하면 브라우저로 인프런 로그인(OAuth) 창이 한 번 뜹니다 → 승인하면 끝.
모든 도구는 읽기 전용입니다.
로컬 vs 서버 — 무엇을 어디서 조회하나
여러 대의 컴퓨터에서 taco를 쓰면, 로컬(이 컴퓨터) 기록만으로는 사용량이 일부만 보입니다. 그래서 도구별로 조회 대상을 나눕니다.
| 도구 | 조회 대상 | 이유 |
|---|---|---|
taco_stats · taco_sessions | 서버(모든 컴퓨터 합산) | 비용·사용량은 전체가 맞아야 함 |
taco_session · taco_search | 로컬(이 컴퓨터) | 대화 원문은 각 컴퓨터에만 있음(서버엔 미저장) |
- 사용량 도구는 서버 조회가 실패하면(오프라인·미로그인) 로컬로 자동 폴백하고, 응답의
source필드에server(모든 컴퓨터 합산)/local(이 컴퓨터만 …)으로 어느 쪽인지 표시합니다. - 대화 원문은 서버에 저장하지 않으므로, 다른 PC에서 만든 세션은 그 PC에서만 열람됩니다.
제공 도구
taco_stats
내 사용량 요약(비용·토큰·이벤트). 서버 기준 — 모든 컴퓨터 합산.
by— 분해 차원:tool|model|branch|repo(생략 시 전체 요약)since— 기간:24h|7d|4w|3m(생략 시 최근 30일)
예시 프롬프트: "이번 주 도구별 AI 비용 정리해줘", "최근 한 달 모델별 사용량은?"
taco_sessions
비용순 상위 세션(비용·실작업 시간·모델·레포). 서버 기준 — 모든 컴퓨터 합산.
limit— 최대 개수(기본 20)
예시: "비용 많이 든 세션 top 10 보여줘"
taco_session
단일 세션 상세 + 대화(프롬프트·응답·툴 호출). 이 컴퓨터의 로컬 원본에서 읽습니다(다른 PC 세션은 없을 수 있음).
id— 세션 ID (또는 앞 8자 prefix)
예시: "세션 a1b2c3d4에서 무슨 작업 했는지 보여줘"
taco_search
세션 대화에서 키워드 검색. 이 컴퓨터의 로컬 기록만 검색합니다.
query— 검색어limit— 최대 결과(기본 20)
예시: "예전에 mongo 인덱스 얘기한 세션 찾아줘"
특징
- read-only — 조회만, 데이터 변경 없음.
- 사용량은 서버(모든 컴퓨터 합산), 대화 원문은 로컬(이 컴퓨터).
- 서버 조회 실패 시 로컬 폴백 +
source표기로 어느 데이터인지 항상 알 수 있음.
문제 해결
/mcp에 taco가 안 보이면 문제 해결 — taco mcp가 안 떠요를 참고하세요.