Claude Code MCP 추천: 용도별 첫 서버 선택과 설치 확인

Claude Code MCP는 지금 막힌 작업에 따라 고르는 것이 좋습니다. 원격 PR과 이슈를 반복해서 읽어야 한다면 GitHub, 설치한 라이브러리 버전에 맞는 문서가 필요하면 Context7, 화면을 열어 동작을 확인해야 하면 Playwright, 운영 중 발생한 오류를 조사한다면 Sentry가 첫 후보입니다.

먼저 “이 서버로 무엇을 읽고 어떤 판단을 끝낼 것인가”를 한 문장으로 정하세요. 예를 들어 “PR 84의 미해결 검토 의견을 확인한다”는 목표라면, 서버를 추가했다는 안내만으로 끝나지 않습니다. 연결과 인증이 되어 있고, 필요한 조회 도구가 보이며, 그 PR의 실제 내용이 반환되어야 합니다.

이미 인증된 GitHub CLI나 브라우저 기능으로 같은 일을 충분히 하고 있다면 새 MCP를 설치할 필요가 없을 수도 있습니다. Claude Code는 로컬 파일과 셸 도구를 사용할 수 있고, Context7과 Playwright도 CLI와 Skills를 함께 쓰는 경로를 제공합니다. MCP는 외부 도구를 Claude의 호출 방식으로 연결하는 선택지입니다. 아래 설정은 2026년 10월 7일 확인한 공식 문서에 따른 예시이며, 실제 계정 연결이나 속도·비용 측정 결과가 아닙니다. Claude Code 빠른 시작, GitHub CLI의 PR 조회

어떤 MCP를 먼저 설치하면 좋을까요?

이 네 가지 중 오늘 필요한 자료가 있는 곳을 고르면 됩니다. 순위표가 아니라 작업별 선택 기준입니다.

각 제품의 연결·인증 조건은 GitHub 공식 서버, Context7의 Claude Code 안내, Playwright MCP, Sentry MCP를 기준으로 합니다. GitHub Enterprise Server에는 GitHub의 같은 호스팅 경로를 그대로 적용할 수 없습니다.

예를 들어 패키지를 업데이트한 뒤 예제가 계속 맞지 않는 상황이라면 GitHub보다 Context7이 먼저입니다. 반대로 문서는 이미 충분한데 PR의 검토 의견을 매번 브라우저에서 찾아야 한다면 GitHub가 더 직접적인 후보입니다. 운영 오류를 다루지 않는 프로젝트에 Sentry를 먼저 연결할 이유는 적습니다.

설치 전에 정할 두 가지: 통신 방식과 설정 범위

HTTP·stdio는 서버와 통신하는 방식이고, local·project·user는 설정이 적용되는 범위입니다. 호스팅 HTTP 서버도 local 범위에 둘 수 있습니다. 로컬 프로세스로 실행하는 stdio 서버도 user 범위로 여러 프로젝트에서 사용할 수 있습니다.

현재 Claude Code 문서는 호스팅 서버에 HTTP를 권장합니다. SSE는 더 이상 권장되지 않지만 SSE만 제공하는 기존 서버는 남아 있습니다. 여기서 다루는 일반적인 연결에는 HTTP와 stdio로 충분합니다. 전송 방식 안내

첫 연결을 한 프로젝트에서 시험한다면 local을 명시하는 것이 이해하기 쉽습니다. 팀이 같은 설정을 사용해야 한다면 project가 맞습니다. 공유할 예정이라는 이유로 개인 토큰까지 .mcp.json에 넣지는 마세요. 범위와 저장 위치는 Claude Code MCP 설정 문서에 설명되어 있습니다.

아래 claude mcp add 명령은 Claude 대화 안이 아니라 터미널에서 실행합니다. Claude Code가 설치되고 기존 로그인 또는 인증이 완료되어 있어야 합니다. 플러그인 명령과 /mcp는 Claude Code 세션에서 사용합니다. 이미 같은 서버가 설치되어 있다면 새 이름으로 중복 추가하기 전에 현재 항목을 확인하세요.

선택한 서버 하나를 연결하기

네 가지를 모두 설치할 필요는 없습니다. 필요한 항목의 절차만 따라간 뒤 다음 절의 조회 확인으로 넘어가세요.

GitHub: PR이나 이슈를 읽는 일부터 시작할 때

GitHub가 관리하는 현재 서버를 사용하세요. 예전 참고 구현인 @modelcontextprotocol/server-github는 보관된 항목이며, 현재 GitHub 제품 서버와 다릅니다. MCP 참고 서버 저장소, GitHub 서버 설치 안내

GitHub의 Claude Code CLI 안내에 따라 PAT를 준비합니다. 접근할 저장소와 필요한 조회 작업에 맞는 권한으로 제한하고, 조직의 토큰 정책도 확인하세요. <GITHUB_PAT>를 전용 토큰으로 바꾼 뒤 터미널에서 등록합니다.

claude mcp add --transport http --scope local github-read \
  https://api.githubcopilot.com/mcp/readonly \
  --header "Authorization: Bearer <GITHUB_PAT>"

이 예시는 읽기 도구를 제공하는 /readonly 경로를 선택합니다. 토큰이 들어간 명령을 채팅, 공유 문서나 저장소에 남기지 말고, 저장되는 개인 설정도 비밀정보로 취급하세요. 읽기 도구 필터는 넓게 발급한 토큰의 권한 자체를 줄여 주지는 않습니다. GitHub 원격 서버의 읽기 전용 설정

현재 Anthropic 문서는 위 HTTP 등록 형식을 지원합니다. GitHub의 설치 페이지에 있는 구버전 legacy 표기를 보고 현재 Claude Code가 HTTP 등록을 거부한다고 해석할 필요는 없습니다. JSON 등록을 택한다면 type: "http"를 명시해야 하며, add-json에는 mcpServers 전체가 아닌 서버 항목 하나를 전달합니다. Claude Code의 서버 등록, GitHub의 CLI 안내

연결 후에는 본인이 읽을 수 있는 저장소의 실제 PR 번호로 요청합니다. 다음은 검토 의견을 좁게 조회하는 요청 예시입니다.

GitHub MCP로 OWNER/REPO의 PR 84를 조회해 주세요.
제목과 현재 상태, 검토 의견 중 조치가 필요한 항목만 정리하고
각 항목의 원문 링크를 붙여 주세요. 댓글 작성이나 상태 변경은 하지 마세요.
사용한 도구와 조회에 실패한 부분도 알려 주세요.

OWNER/REPO와 84는 예시 값입니다. 실제 결과에서 다른 저장소나 다른 PR을 읽지 않았는지 확인하세요. GitHub의 원격 OAuth는 클라이언트 앱 지원에 따라 달라집니다. 다른 클라이언트의 OAuth 안내나 로컬 Docker 서버의 로그인 절차를 이 원격 CLI 설정에 그대로 옮기면 안 됩니다. GitHub의 인증 방식

Context7: 패키지 버전에 맞는 문서를 찾을 때

대화형 Claude Code에서 브라우저 로그인을 사용할 수 있다면 Context7 플러그인이 간단한 출발점입니다. 현재 플러그인은 호스팅 MCP를 사용하므로 로컬 Node.js·npm·npx가 필요 없고, API 키를 직접 입력하지 않습니다. 플러그인이 CONTEXT7_API_KEY를 읽는 방식도 아닙니다. Context7의 Claude Code 플러그인 안내

Claude Code 세션에서 다음 두 명령을 각각 실행합니다.

/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace

Claude Code를 다시 시작하고 /mcp에서 Context7의 로그인 안내를 따라 브라우저 인증을 마칩니다. 수동 MCP 항목을 이미 쓰고 있다면 같은 서비스의 플러그인을 중복으로 추가할 필요가 있는지 먼저 판단하세요.

SSH·CI처럼 브라우저 인증이 어려운 환경은 키 기반 수동 설정을 검토합니다. 현재 수동 HTTP 경로인 https://mcp.context7.com/mcp는 Authorization: Bearer <서비스 키>를 사용하고, 원격 OAuth 경로는 /mcp/oauth로 구분됩니다. stdio 연결에는 API 키를 사용합니다. 예전 글의 다른 헤더를 그대로 복사하지 말고 현재 클라이언트별 설정을 따르세요.

npx ctx7 setup --claude도 별도 선택지입니다. 이 설정 도구는 Node.js 18 이상을 요구하고, OAuth 기기 인증을 거쳐 API 키와 해당 모드의 Skill을 설정합니다. 단순한 문서 조회 명령으로 생각하고 실행하지 마세요. 플러그인, 수동 MCP, CLI와 Skills 중 필요한 경로를 선택하면 됩니다. Context7 공식 저장소

조회에서는 패키지명과 버전을 함께 지정하는 것이 중요합니다. 프로젝트에서 쓰는 실제 버전을 넣어 요청하세요.

이 프로젝트의 package.json과 lockfile로 실제 사용하는 Next.js 버전을 확인해 주세요.
Context7에서 그 버전에 맞는 라이브러리 ID를 찾고,
캐시 재검증 함수의 사용 조건과 예제를 조회해 주세요.
조회한 라이브러리 ID와 문서 버전, 근거를 알려 주고
해당 버전의 문서를 찾지 못하면 다른 버전으로 조용히 대체하지 마세요.
아직 코드는 수정하지 마세요.

Context7은 resolve-library-id로 라이브러리를 찾고 query-docs로 문서를 조회합니다. 두 도구가 실제로 사용되었는지, 반환된 자료가 현재 패키지와 질문에 맞는지 확인하세요. 문서를 가져왔다고 해서 생성된 코드의 정확성까지 보장되지는 않습니다. Context7의 도구와 버전별 문서 조회

Playwright: 브라우저에서 확인할 일이 남아 있을 때

Microsoft의 @playwright/mcp는 브라우저의 구조화된 접근성 스냅샷을 이용해 탐색과 상호작용을 제공합니다. 로컬 패키지를 쓰려면 Node.js 18 이상이 필요합니다. 일반적인 코딩 작업에는 CLI와 Skills 조합도 후보이며, 상태를 유지하면서 화면을 계속 탐색해야 하는 작업에는 MCP가 맞을 수 있습니다. 이 차이는 사용 방식에 대한 선택 기준이지, 이 글에서 측정한 성능 순위가 아닙니다. Playwright MCP 공식 안내

먼저 로그인 없이 확인할 수 있는 본인의 개발 페이지를 대상으로 시작할 수 있습니다. 다음은 세션 종료 시 브라우저 상태를 남기지 않는 --isolated 예시입니다.

claude mcp add --transport stdio --scope local browser-check -- \
  npx -y @playwright/mcp@latest --isolated

-- 앞은 Claude Code 옵션, 뒤는 실행할 프로세스와 그 인수입니다. npx 경로는 패키지를 내려받아 실행하며, 단순한 설정 텍스트 조회가 아닙니다. 서버가 시작할 수 있는 환경과 브라우저 준비 상태를 확인해야 합니다. Claude Code stdio 설정, Playwright 설정

본인이 이미 실행한 개발 서버의 URL을 넣고, 변경 작업 없이 화면 상태를 읽도록 요청합니다.

Playwright MCP로 내 개발 서버의 시작 페이지를 열어 주세요.
URL은 http://localhost:3000 입니다. 실제 서버 주소가 다르면 그 주소를 사용합니다.
현재 페이지 제목과 보이는 주요 탐색 링크를 스냅샷에서 확인한 뒤,
도움말 링크가 있으면 열고 이동한 URL과 페이지 제목을 알려 주세요.
링크가 없으면 없다고 보고하세요. 로그인이나 폼 제출은 하지 마세요.

성공 여부는 “브라우저를 열었다”는 문장이 아니라, 호출 기록과 스냅샷에 나온 링크, 이동 후 URL·제목으로 판단합니다. 예시 주소의 페이지나 도움말 링크가 실제로 존재한다고 가정하지 않습니다.

기본 지속 프로필과 격리 프로필의 동작은 다릅니다. 지속 프로필은 여러 클라이언트가 동시에 사용하면 충돌할 수 있고, 격리 모드의 저장 상태는 세션이나 브라우저가 끝나면 사라집니다. 기존 로그인 브라우저에 연결하는 확장 기능은 별도의 선택과 권한이 필요합니다. 격리 모드나 접근 제한 옵션을 완전한 보안 경계로 생각하지 마세요. 프로필과 보안 범위

Sentry: 운영 오류를 조사하는 일이 반복될 때

Sentry에 이미 오류 기록이 쌓여 있고 해당 프로젝트를 읽을 권한이 있다면, Sentry가 운영하는 호스팅 MCP를 연결할 수 있습니다.

claude mcp add --transport http --scope local sentry \
  https://mcp.sentry.dev/mcp

Claude Code에서 /mcp를 열고 Sentry의 OAuth 인증을 진행합니다. Sentry는 조직·프로젝트가 지정된 연결 경로도 제공합니다. 이런 경로는 기본 조회 대상을 좁히고 불필요한 탐색 도구를 숨기는 데 도움이 되지만, URL을 적었다는 사실만으로 계정 권한 전체가 제한되는 것은 아닙니다. Sentry MCP의 인증과 연결 범위

처음에는 프로젝트와 기간을 지정한 조회 하나로 확인하세요.

Sentry MCP로 ORGANIZATION의 PROJECT에서 최근 24시간 동안 발생한
오류 이슈 중 발생 횟수가 많은 항목 3개를 조회해 주세요.
이슈 ID와 제목, 발생 횟수, 원문 링크를 먼저 보여 주세요.
반환 자료에 근거가 없는 원인 추정은 별도로 구분하고,
이슈 상태나 담당자는 변경하지 마세요.

조직·프로젝트 이름은 실제 접근 가능한 값으로 바꿉니다. 이슈가 없다는 결과와 권한 부족으로 조회에 실패했다는 결과를 구분해야 합니다. 읽은 이벤트나 오류의 범위를 넘어 원인을 단정하지 말고, 원문을 열어 대상과 기간을 확인하세요.

Added 다음에 확인할 것: 연결, 도구, 실제 자료

서버 등록 명령의 Added나 설정 파일 변경 안내는 설정이 저장되었다는 뜻입니다. 연결이나 인증, 필요한 도구의 실행 성공을 뜻하지 않습니다. 선택한 서버를 등록한 뒤 터미널에서 다음을 확인합니다.

claude mcp list
claude mcp get SERVER_NAME

SERVER_NAME은 앞에서 등록한 github-read, browser-check, sentry 등 실제 이름입니다. 플러그인으로 설치한 Context7은 세션의 /mcp에서 해당 항목을 확인하세요. 이 명령들은 서버 연결 상태를 확인할 수 있으므로, 사용하려는 환경에서 실행합니다. Claude Code의 상태 확인과 문제 해결

세션에서는 /mcp를 열어 인증 상태와 도구 목록을 봅니다. 이어 앞 절의 좁은 조회를 요청하고, 호출된 서버·도구와 반환 자료가 목적에 맞는지 확인합니다. 연결 표시만 보고 설치를 끝내지 않는 것이 핵심입니다.

401이 나왔다고 무조건 OAuth를 다시 진행하지는 마세요. PAT를 쓰는 연결인지, OAuth를 쓰는 연결인지부터 구분하고 그 방식의 자격 증명과 대상 권한을 확인합니다. 연결 성공 뒤 도구 목록을 가져오지 못한 경우도 있으므로, Connected와 도구 사용 가능 상태를 따로 확인해야 합니다. 캐시된 도구 정보만으로 현재 서버에서 조회가 성공했다고 판단할 수도 없습니다. Claude Code MCP 참조

첫 연결을 마쳤다고 볼 수 있는 기준은 단순합니다. 원하는 서버의 도구가 실제로 호출되었고, 필요한 대상의 자료를 받아 오늘의 판단에 사용할 수 있어야 합니다. 대상이 없거나 권한이 부족하다면 그 사실이 명확하게 반환되어야 합니다. 모델이 “확인했습니다”라고 말한 것만으로는 부족합니다.

팀과 공유할 때는 설정과 인증을 분리하세요

팀원들이 같은 GitHub 읽기 설정을 써야 한다면 저장소 루트의 .mcp.json으로 공유할 수 있습니다. 다음은 앞서 연결한 서버의 공유 설정 예시입니다. 같은 이름의 개인 local 항목이 남아 있으면 공유 설정보다 우선할 수 있으므로, 전환할 때 중복 항목을 정리하세요.

{
  "mcpServers": {
    "github-read": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/readonly",
      "headers": {
        "Authorization": "Bearer ${GITHUB_MCP_TOKEN}"
      }
    }
  }
}

각 팀원은 Claude Code를 시작하는 환경에 자신의 전용 GITHUB_MCP_TOKEN을 제공해야 합니다. 파일에는 변수 참조를 남기고 실제 토큰을 커밋하지 않습니다. ${VAR} 확장을 지원하지만, 기본값 없는 변수가 빠지면 경고와 함께 문자열이 남는 필드가 있습니다. JSON이 정상이라고 인증 값도 준비되었다고 생각하지 마세요. 환경변수와 프로젝트 설정

대화형 Claude Code CLI에서는 프로젝트 MCP를 처음 사용할 때 일반적으로 승인이 필요합니다. 비대화형 -p, Agent SDK, 클라우드 실행에는 같은 승인 프롬프트가 없을 수 있으므로 모든 환경에서 동일한 창이 뜬다고 기대하면 안 됩니다. 승인을 건너뛰는 방식으로 연결 문제를 해결하려 하지 말고, 적용되는 정책과 인증을 확인하세요. 공유 설정은 팀원의 OAuth 로그인이나 저장소 접근 권한까지 공유하지 않습니다. 실행 환경별 승인 조건

CLI에 같은 이름의 항목이 겹치면 일반적으로 local → project → user 순서로 적용되며, 한 항목의 필드를 다른 항목과 합치지 않습니다. 관리자가 제공하는 설정이나 Desktop의 규칙은 다를 수 있습니다. 설정을 공유한 뒤 예상과 다른 도구가 보인다면 서버를 다시 설치하기보다 이름과 범위를 먼저 확인하세요.

사내 API 자체를 여러 도구에서 공동으로 사용해야 하는 경우에는 별도의 서버 설계가 필요합니다. 그 작업은 Claude MCP로 사내 API를 연동하는 방법에서 다룹니다.

두 번째 서버는 다음에 필요한 자료가 생겼을 때 추가하세요

PR 의견을 조회해 필요한 판단을 끝냈다면 일단 그 구성으로 사용해도 됩니다. 이후 실제로 버전별 문서가 필요해졌을 때 Context7을 더하는 식으로 확장하세요. 서버 개수만으로 속도나 컨텍스트 사용량을 예측할 수는 없습니다.

현재 도구 검색은 기본적으로 도구 정의 로딩을 미루며, 처음에는 도구 이름과 서버 안내 등을 유지합니다. 다만 모델, 제공자와 설정에 따라 적용 조건이 다르고, 실제 도구 결과는 여전히 대화에 영향을 줍니다. 모든 도구 정의가 언제나 한꺼번에 올라간다거나 MCP가 컨텍스트를 전혀 쓰지 않는다는 설명은 모두 지나칩니다. 도구 검색 안내

처음부터 “저장소 전체”, “모든 오류”, “모든 문서”를 요청하지 말고, PR 하나·특정 버전의 함수 하나·짧은 기간의 오류부터 읽으세요. 연결 후 큰 결과나 긴 대화 때문에 조사가 어려워진다면 Claude Code MCP 컨텍스트 과부하를 진단하는 방법으로 이어가면 됩니다.

FAQ

Claude Code에서 MCP를 꼭 설치해야 하나요?

아닙니다. 로컬 파일과 셸 도구, 이미 승인된 CLI나 기존 브라우저 기능으로 필요한 일을 끝낼 수 있다면 추가 설치 없이 사용해도 됩니다. Context7과 Playwright도 CLI와 Skills 경로를 제공합니다. Skill은 외부 CLI 사용 절차를 담을 수 있지만, 필요한 계정이나 권한까지 자동으로 만들어 주지는 않습니다. Context7, Playwright MCP

local 범위와 로컬 stdio 서버는 같은 뜻인가요?

다릅니다. local은 현재 프로젝트의 개인 설정 범위이고, stdio는 자식 프로세스로 서버와 통신하는 방식입니다. 호스팅 GitHub HTTP 서버도 local로 등록할 수 있고, stdio 서버를 user 범위로 등록할 수도 있습니다. Claude Code MCP 설정

Context7 플러그인에도 Node.js나 API 키가 필요한가요?

현재 호스팅 플러그인은 로컬 Node.js나 직접 입력하는 API 키 없이 브라우저 로그인으로 연결합니다. 반면 ctx7 setup CLI는 Node.js 18 이상과 기기 인증을 사용하고, 수동 키 기반 MCP는 서비스 키가 필요합니다. 플러그인과 수동 연결의 인증 방법을 섞지 마세요. Context7의 Claude Code 안내

GitHub MCP는 OAuth로 로그인하면 되나요?

이 글의 원격 Claude Code CLI 예시는 GitHub의 안내에 따라 PAT를 사용합니다. 원격 OAuth 지원은 클라이언트 앱에 따라 달라지고, 로컬 서버의 OAuth 절차도 별도입니다. 다른 클라이언트의 로그인 방식을 그대로 적용하지 마세요. GitHub의 Claude Code 설치 안내

MCP 서버가 공식이면 무료이고 안전한가요?

그렇게 단정할 수 없습니다. 누가 운영·유지보수하는지와 어떤 권한·자료를 다루는지 확인해야 합니다. 오픈소스 패키지라는 사실은 서비스 이용료, 호스팅 비용이나 모델 사용 비용까지 무료라는 뜻이 아닙니다. 참고 서버 목록의 등재도 모든 데이터에 적합하다는 보증은 아닙니다. MCP 참고 구현의 목적, Claude Code의 서버 신뢰 안내

서버가 Connected인데도 왜 일을 못 하나요?

연결된 상태에서도 필요한 도구의 목록을 가져오지 못하거나, 요청 대상에 접근하지 못할 수 있습니다. /mcp의 도구 목록과 실제 호출 기록을 확인하고, 대상 자료나 구체적인 오류가 반환되었는지 보세요. 설정 저장, 연결, 도구 사용, 유용한 조회 결과는 각각 확인해야 합니다. Claude Code 문제 해결