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

문제 해결

자주 나오는 증상과 해결법입니다.

일부 repo가 대시보드에 안 떠요

기본값은 **org 제한 없음(모든 레포 수집)**이라 보통은 다 잡히지만, allowed_orgs/allowed_dirs 필터를 설정해 뒀다면 그 범위 밖의 repo는 제외됩니다. (remote가 아예 없는 로컬 폴더는 org 필터와 무관하게 수집됩니다.)

확인:

# 안 뜨는 repo의 remote org 확인
git -C <경로> config --get remote.origin.url
# 현재 설정 확인
cat ~/.config/taco/config.json

해결 — org 제한을 없애거나 필요한 org를 추가한 뒤 소급 재수집:

// ~/.config/taco/config.json
"allowed_orgs": []                       // 제한 없음
// 또는
"allowed_orgs": ["inflearn", "inflab"]   // 여러 org 허용
taco collect --full --sync

심볼릭 링크 주의: allowed_dirs가 설정돼 있는데 작업 폴더가 심볼릭 링크를 통해 접근된다면, 도구가 기록한 실제 cwd가 allowed_dirs 경로 prefix와 안 맞아 걸러질 수 있습니다. allowed_dirs를 비우거나 실제 경로로 맞추세요. → 설정

taco mcp가 안 떠요

/mcp에 taco가 없다면:

  1. /plugin에서 taco 플러그인을 최신으로 업데이트(또는 taco plugins 재실행).
  2. Claude Code 재시작(.mcp.json은 시작 시 로드).
  3. taco -v로 CLI가 설치돼 있는지 확인(플러그인이 taco 바이너리를 실행).

→ MCP 서버

데이터가 서버로 안 올라가요

taco doctor      # 로그인/서버/큐 상태
taco sync        # 미전송분 강제 전송
  • auto_sync가 꺼져 있으면 hook이 로컬에만 쌓습니다. taco init에서 켜거나 config에서 "auto_sync": true.
  • 로그인이 만료됐으면 taco login으로 재로그인.
  • 지금 상태가 궁금하면 taco status로 마지막 수집·전송 시각을 확인하세요.

로그인 · 세션 문제

대시보드에서 세션이 자주 끊기거나 무한 리다이렉트가 났던 이슈는 배포로 해결됐습니다. 여전히 이상하면 브라우저의 taco_session 쿠키를 지우고 재로그인하세요.

그 밖에

taco doctor가 대부분의 설정/연결 문제를 짚어줍니다. 먼저 실행해 보세요.

이 페이지
일부 repo가 대시보드에 안 떠요taco mcp가 안 떠요데이터가 서버로 안 올라가요로그인 · 세션 문제그 밖에