Claude Code에 MCP 서버 추가

Claude Code는 claude mcp add 명령 또는 저장소 루트의 .mcp.json 파일에서 서버를 가져옵니다.

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

프로젝트 파일

.mcp.json

최상위 키

mcpServers

형식

json

원격 서버용 OAuth

●예

설정 예시

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

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

참고 및 특이사항

• 기본값인 로컬 범위와 사용자 범위 설정은 ~/.claude.json에 저장되고, 프로젝트 범위 설정은 .mcp.json에 저장됩니다.
• url이 있는 모든 항목에는 http 같은 type도 필요합니다. url만 지정하면 오류가 발생합니다.
• 파일의 값에서는 ${VAR} 및 ${VAR:-default}가 확장됩니다.
• OAuth 서버에 로그인하려면 세션에서 /mcp를 실행하세요. 사전 등록된 OAuth 앱의 경우 --client-id, --client-secret, --callback-port를 전달하세요.

Claude Code 설정 만들기 →

다른 클라이언트