Claude Desktop 연결

~22 min · claude-desktop, config, integration, debugging

Level 0호기심 많은 독자

0 XP0/48 lessons0/14 achievements

0/100 XP to next level100 XP to go0% complete

Claude Desktop 이 개인용 canonical MCP host. JSON config 파일 (macOS 는 ~/Library/Application Support/Claude/claude_desktop_config.json; 다른 플랫폼은 유사) 읽어 — 시작 시 띄울 모든 server list. Server entry 가 launch command, args, optional 환경 변수 명명.

End-to-end flow: server 작성 → config 에 entry 추가 → Claude Desktop restart → server tool 이 모델 tool 메뉴에 등장. 첫 connection 이 — 초기 단계 bug 대부분 surface 하는 자리. 보통 stdout 오염 (Track 6) 또는 launch 환경에 dependency 빠짐.

다른 함정은 환경 변수. Claude Desktop 이 server 를 거의 빈 환경에서 launch; $HOME 은 set, 대부분 다른 거 아님. Server 가 API key 필요하면 — config 의 env 필드로 명시적 pass 하거나 server 안에서 OS keychain 에서 read. Shell-set 변수 의존 X — 거기 없음.

Code

claude_desktop_config.json entry·json

{
  "mcpServers": {
    "my-tools": {
      "command": "uvx",
      "args": ["my-mcp-server"],
      "env": {
        "STRIPE_API_KEY": "sk_live_..."
      }
    },
    "github": {
      "command": "uvx",
      "args": ["github-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Debug log 위치·bash

# macOS
tail -f ~/Library/Logs/Claude/mcp.log
tail -f ~/Library/Logs/Claude/mcp-server-my-tools.log

# 'mcp-server-my-tools.log' 이 server stderr 캡처 — diagnostic 보내야 할 곳.

External links

Exercise

작은 server 를 claude_desktop_config.json 에 추가. Claude restart. 모델한테 tool 쓰라고. 모델이 tool 호출하는 동안 per-server log 가 흐르는 거 봐. 처음 — 진짜 모델 결정 따라 자기 diagnostic line — 보는 순간이 protocol 이 추상 멈추는 순간.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousCapability Manifest Next →Logging 과 Observability

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.