This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
This is a minimal Claude Code workspace directory with configuration files only. The directory appears to be set up for AI server information management but contains no application code.
.claude/settings.local.jsonclaude.mdThe Claude Code permissions are configured to allow:
dir /acatThis workspace can be used as a starting point for AI server information projects. Add your project files and update this CLAUDE.md accordingly with:
공통 주의사항
윈도우에서의 주의사항
기본 설치 mcp-installer를 사용해 설치할 것
설치 후 정상 설치 여부 확인하기 claude mcp list 으로 설치 목록에 포함되는지 내용 확인한 후, task를 통해 디버그 모드로 서브 에이전트 구동한 후 (claude --debug), 최대 2분 동안 관찰한 후, 그 동안의 디버그 메시지(에러 시 관련 내용이 출력됨)를 확인하고 /mcp 를 통해(Bash(echo "/mcp" | claude --debug)) 실제 작동여부를 반드시 확인할 것
문제 있을때 다음을 통해 직접 설치할 것
User 스코프로 claude mcp add 명령어를 통한 설정 파일 세팅 예시
예시1:
claude mcp add --scope user youtube-mcp
-e YOUTUBE_API_KEY=$YOUR_YT_API_KEY \
-e YOUTUBE_TRANSCRIPT_LANG=ko
-- npx -y youtube-data-mcp-server
정상 설치 여부 확인 하기 claude mcp list 으로 설치 목록에 포함되는지 내용 확인한 후, task를 통해 디버그 모드로 서브 에이전트 구동한 후 (claude --debug), 최대 2분 동안 관찰한 후, 그 동안의 디버그 메시지(에러 시 관련 내용이 출력됨)를 확인하고, /mcp 를 통해(Bash(echo "/mcp" | claude --debug)) 실제 작동여부를 반드시 확인할 것
문제 있을때 공식 사이트 다시 확인후 권장되는 방법으로 설치 및 설정할 것 (npm/npx 패키지를 찾을 수 없는 경우) pm 전역 설치 경로 확인 : npm config get prefix 권장되는 방법을 확인한 후, npm, pip, uvx, pip 등으로 직접 설치할 것
curl -LsSf https://astral.sh/uv/install.sh | sh
npm config get prefix
curl -LsSf https://astral.sh/uv/install.sh | sh
설정 예시 (설정 파일 위치) 리눅스, macOS 또는 윈도우 WSL 기반의 클로드 코드인 경우 - User 설정:
~/.claude/*윈도우 네이티브 클로드 코드인 경우* - **User 설정**: `C:\Users\{사용자명}\.claude` 디렉토리 - User 설정파일 C:\Users\{사용자명}\.claude.json - **Project 설정**: 프로젝트 루트\.claude 1. npx 사용 { "youtube-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "youtube-data-mcp-server"], "env": { "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE", "YOUTUBE_TRANSCRIPT_LANG": "ko" } } } 2. cmd.exe 래퍼 + 자동 동의) { "mcpServers": { "mcp-installer": { "command": "cmd.exe", "args": ["/c", "npx", "-y", "@anaisbetts/mcp-installer"], "type": "stdio" } } } 3. 파워셀예시 { "command": "powershell.exe", "args": [ "-NoLogo", "-NoProfile", "-Command", "npx -y @anaisbetts/mcp-installer" ] } 4. npx 대신 node 지정 { "command": "node", "args": [ "%APPDATA%\\npm\\node_modules\\@anaisbetts\\mcp-installer\\dist\\index.js" ] } 5. args 배열 설계 시 체크리스트 토큰 단위 분리: "args": ["/c","npx","-y","pkg"] 와 "args": ["/c","npx -y pkg"] 는 동일해보여도 cmd.exe 내부에서 따옴표 처리 방식이 달라질 수 있음. 분리가 안전. 경로 포함 시: JSON에서는 \\ 두 번. 예) "C:\\tools\\mcp\\server.js". 환경변수 전달: "env": { "UV_DEPS_CACHE": "%TEMP%\\uvcache" } 타임아웃 조정: 느린 PC라면 MCP_TIMEOUT 환경변수로 부팅 최대 시간을 늘릴 수 있음 (예: 10000 = 10 초)
중요사항 윈도우 네이티브 환경이고 MCP 설정에 어려움이 있는데 npx 환경이라면, cmd나 node 등으로 다음과 같이 대체해 볼것: { "mcpServers": { "context7": { "command": "cmd", "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"] } } }
claude mcp add-json context7 -s user '{"type":"stdio","command":"cmd","args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"]}'
(설치 및 설정한 후는 항상 아래 내용으로 검증할 것) claude mcp list 으로 설치 목록에 포함되는지 내용 확인한 후, task를 통해 디버그 모드로 서브 에이전트 구동한 후 (claude --debug), 최대 2분 동안 관찰한 후, 그 동안의 디버그 메시지(에러 시 관련 내용이 출력됨)를 확인하고 /mcp 를 통해 실제 작동여부를 반드시 확인할 것
** MCP 서버 제거가 필요할 때 예시: ** claude mcp remove youtube-mcp