setup-debugger

setup-debugger skill

목적

/ait:setup-debugger는 on-device 디버깅(/ait:debug §5, 환경 3)이 쓰는 ait-devtools MCP 서버를 현재 프로젝트의 MCP 설정 파일에 등록한다. 이 파일은 호스트마다 다르다 — Claude Code는 .mcp.json, Cursor는 .cursor/mcp.json에 쓴다(판별은 2단계).

이 서버는 plugin manifest에 들어 있지 않다 — 디버깅은 프로젝트 전제 작업이고, 로컬 npx 데몬을 모든 세션에 상시 태우면 idle 비용과 공급망 표면이 생기므로 프로젝트 단위 opt-in이다. 이 skill이 그 opt-in의 단일 경로다.

완료되면:

• Claude Code면 프로젝트 루트 .mcp.json에, Cursor면 .cursor/mcp.json에 mcpServers."ait-devtools" 항목이 생긴다.
• Claude Code는 세션에서 서버를 승인·연결하면 /mcp 목록에 ait-devtools가 뜨고, Cursor는 Cursor의 MCP 목록에서 같은 항목을 켜고 승인한다. 연결되면 /ait:debug의 start_attach QR attach 경로(환경 3)가 열린다 — 이 attach 경로는 Claude Code에서 확인된 경로다.

의존

• cwd가 프로젝트 루트여야 한다 — MCP 설정 파일은 두 호스트 모두 프로젝트 루트 스코프다. 루트가 아니면 이동을 안내하고 중단한다. 이 skill은 앱 코드나 진입점을 건드리지 않으므로 프로젝트가 웹이든 Unity든 엔진 HTML5 빌드든 같은 절차다.
• npx가 Release tarball(@apps-in-toss/debugger)을 내려받아 실행하므로 전역 설치는 필요 없다. 다만 Node와 npx가 이 머신에 있어야 한다. 앱 스택과는 무관하게 MCP 서버를 띄우는 데만 쓴다.

이 skill은 콘솔 인증을 요구하지 않는다. 로컬 설정 파일 하나만 만진다.

실행 순서

1. 프로젝트 루트 확인

ls package.json

있으면 루트다. 없으면 package.json이 없는 스택일 수 있으니 바로 중단하지 않는다. cwd가 프로젝트 루트인지 확인한다. Unity는 Assets/와 Packages/manifest.json이 있는 디렉터리가 루트다. 엔진 HTML5 빌드 등 그 밖의 스택은 프로젝트 설정 파일이 있는 디렉터리를 찾고, 확신이 없으면 사용자에게 어느 디렉터리에 .mcp.json을 둘지 묻는다. 루트가 아닌 곳이면 중단하고 안내한다:

프로젝트 루트를 찾지 못했습니다. 프로젝트 루트 디렉토리에서 다시 실행해주세요.
예: cd <project-root> && /ait:setup-debugger

2. 호스트 판별 (어느 파일에 쓸지)

1차 근거는 에이전트 자신의 자기 인식이다 — 지금 이 skill을 실행하는 에이전트가 Claude Code인지 Cursor인지는 그 에이전트 자신이 가장 정확히 안다.

보조 신호로 프로젝트 루트의 흔적을 확인한다:

ls -d .cursor .mcp.json .cursor/mcp.json 2>/dev/null

• Claude Code면 .mcp.json에 쓴다(4단계).
• Cursor면 .cursor/mcp.json에 쓴다 — .cursor/ 디렉터리가 아직 없으면 먼저 만든다(mkdir -p .cursor).
• 둘 다 아니면(Codex 등) 이 skill이 지원하는 대상이 아니다 — 아무 파일도 쓰지 않고 그렇게 안내한 뒤 중단한다.
• 보조 신호가 자기 인식과 어긋나면(흔적이 둘 다 있거나 둘 다 없는데 자신은 분명 Claude Code 또는 Cursor인 경우) 자기 인식을 따른다 — 파일 흔적은 참고일 뿐 판정 근거가 아니다.

3. 기존 MCP 설정 파일 확인 (idempotent)