dotsagent.io
언어:한국어
Anthropic

Claude Desktop에 MCP 서버 추가

Claude Desktop은 claude_desktop_config.json에서 로컬 서버를 읽습니다. 원격 서버는 앱에서 사용자 지정 커넥터로 추가합니다.

macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\claude_desktop_config.json
최상위 키
mcpServers
형식
json
원격 서버용 OAuth
예

설정 예시

이 예시는 이 클라이언트가 요구하는 형식으로 GitHub 호스팅 서버와 로컬 서버인 Playwright를 추가합니다.

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

원격 서버는 설정 파일에 추가할 수 없습니다. Settings > Connectors > Add custom connector에서 URL을 붙여넣고 로그인하세요.

참고 및 특이사항

  • 파일을 수정한 뒤 앱을 종료하고 다시 여세요.
  • 로그는 macOS의 ~/Library/Logs/Claude와 Windows의 %APPDATA%\Claude\logs에 있습니다.
  • Windows에서는 cmd를 통해 npx를 실행하세요. command는 cmd로, 인수는 /c, npx, 패키지 순서로 지정합니다. 생성기가 이 설정을 자동으로 처리합니다.
  • 공식 Linux 빌드는 없습니다.

Claude Desktop 설정 만들기 →

다른 클라이언트

출처

  1. modelcontextprotocol.io/docs/develop/connect-local-servers
  2. modelcontextprotocol.io/docs/develop/connect-remote-servers
  3. github.com/modelcontextprotocol/servers