taco docs
설치대시보드GitHub
시작하기
개요빠른 시작윈도우 설치 (비개발자)설치설정
수집
지원 도구CLI 명령
대시보드
대시보드 둘러보기티켓별 비용
연동
MCP 서버Jira·GitHub 연동
기타
문제 해결

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
  1. Claude Code 재시작(.mcp.json은 시작 시 로드).
  2. /mcp에서 taco·taco-remote 연결 확인 → 승인. (taco-remote는 최초 1회 브라우저로 인프런 로그인)

이미 설치돼 있다면 /plugin에서 taco 플러그인을 최신으로 업데이트하거나 taco plugins를 다시 실행하세요.

방법 B — 커넥터 URL (claude.ai · Claude 데스크톱)

CLI 설치 없이, 커넥터에 URL만 추가하면 모든 컴퓨터 합산 사용량을 조회할 수 있습니다.

  1. claude.ai · Claude 데스크톱의 커넥터(MCP) 설정에서 아래 URL을 추가.

    https://taco-api.inflearn.com/mcp
    
  2. 연결하면 브라우저로 인프런 로그인(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가 안 떠요를 참고하세요.

이 페이지
방법 A — taco CLI (`taco plugins`)방법 B — 커넥터 URL (claude.ai · Claude 데스크톱)로컬 vs 서버 — 무엇을 어디서 조회하나제공 도구특징문제 해결