본문으로 건너뛰기

© 2026 Molayo

Qiita헤드라인2026. 06. 15. 13:55

Claude Code에서 사용할 수 있는 MCP 서버를 사용해 보았다——실용적인 것들을 정리하기

요약

Anthropic의 MCP(Model Context Protocol)를 Claude Code에 연결하여 사용하는 실용적인 방법들을 정리했습니다. GitHub, Filesystem, Brave Search, Playwright 등 다양한 MCP 서버를 통해 Claude의 기능을 확장하는 사례를 다룹니다.

핵심 포인트

  • MCP는 AI 모델과 외부 도구를 연결하는 표준 프로토콜임
  • GitHub MCP 서버를 통해 PR 확인 및 이슈 관리가 가능함
  • Filesystem MCP로 로컬 파일의 일괄 수정 및 패턴 탐색 가능
  • Brave Search MCP를 통해 Claude의 지식 컷오프 한계 극복
  • Playwright MCP로 브라우저 조작 및 스크린샷 촬영 가능

MCP (Model Context Protocol)라는 단어를 최근 자주 접하게 되었습니다. Anthropic이 2024년 말에 오픈 소스로 공개한 규격으로, "AI 모델과 외부 도구를 연결하는 USB 같은 것"이라는 설명이 자주 보입니다.

궁금해서 Claude Code에 실제로 넣어 테스트해 본 결과, 생각보다 쓸 만한 것이 많아서 정리해 두려고 합니다.

MCP (Model Context Protocol)는 AI 모델과 데이터 소스·도구를 연결하기 위한 표준 프로토콜입니다.

Claude Code (클라이언트)
↕ MCP
외부 도구 (GitHub / 파일 시스템 / 브라우저 / DB 등)

공개 후 약 1년 반 만에 월간 SDK 다운로드 수는 9,700만 회를 넘었고, GitHub 스타는 86,000개 이상에 달했습니다. 2026년 4월에는 Linux Foundation 산하의 Agentic AI Foundation (AAIF)에 기증되었으며, AWS가 54개, Google Cloud도 공식 서버를 출시하는 등 특정 벤더의 사양에 머물지 않는 확산세를 보여주고 있습니다.

설치

# GitHub 공식 서버 (Go 제작 바이너리, Docker 경유)
docker pull ghcr.io/github/github-mcp-server
claude mcp add github -- docker run -i --rm \
...

info

이전에는 @modelcontextprotocol/server-github (npm)가 널리 사용되었지만, 현재는 archived 취급이 되어 GitHub이 Go로 다시 작성한 github/github-mcp-server가 공식 권장 사항입니다. 환경 변수명도 GITHUB_TOKEN이 아니라 GITHUB_PERSONAL_ACCESS_TOKEN입니다. 로컬 설치가 필요 없는 리모트 버전도 제공되고 있습니다.

무엇을 할 수 있는가

조작
PR 확인"open 상태인 PR을 목록으로 만들어줘"
...

브라우저를 열지 않고도 Issue 확인이나 PR 리뷰 코멘트 게시를 할 수 있어서, 글을 쓰면서 다른 탭을 왔다 갔다 하는 번거로움이 줄었습니다.

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/your_name

디렉터리 단위로 액세스를 허용하는 설계이므로, 필요한 범위만 전달할 수 있습니다.

효과적이었던 상황

  • 프로젝트를 가로질러 동일한 패턴을 찾아 일괄 수정
  • "이 폴더 내의 모든 markdown 파일의 제목을 목록으로 만들어줘"
  • 로컬에 있는 여러 파일을 비교하며 정리

Claude Code 단독으로도 Read/Edit 도구는 있지만, MCP를 경유하면 "어떤 파일을 볼 것인가"를 스스로 지정하지 않아도 되는 상황이 있습니다.

claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search
# BRAVE_API_KEY 환경 변수가 필요함 (무료 플랜 있음)

Claude의 지식은 학습 컷오프(Cutoff) 이전의 정보로 제한됩니다. Brave Search MCP를 추가하면 Claude로부터 직접 웹 검색을 할 수 있게 됩니다.

"Context7의 최신 릴리스 노트를 조사해서 요약해줘"
→ Claude가 Brave Search를 호출 → 결과를 요약

글을 쓸 때 최신 정보를 조사하면서 문장을 만드는 흐름이 매끄러워졌습니다.

claude mcp add playwright -- npx -y @playwright/mcp@latest

Claude가 브라우저를 조작할 수 있게 됩니다.

할 수 있는 일

  • "이 페이지의 스크린샷을 찍어줘"
  • "로그인해서 이 폼에 입력하고 전송해줘"
  • "스테이징 환경의 dashboard에 접속해서 표시를 확인해줘"

API를 가지지 않은 웹 서비스의 조작을 자동화할 수 있다는 것이 강점입니다. 브라우저 테스트 자동화에도 사용할 수 있습니다. 다만, 페이지 구조에 따라 실패할 수도 있으므로 중요한 조작은 결과를 확인하면서 진행하는 것이 무난합니다.

claude mcp add context7 -- npx -y @upstash/context7-mcp

라이브러리의 최신 문서를 가져와서 Claude에게 전달해 주는 서버입니다.

"use context7"이라고 쓰고 질문하면
→ 해당 라이브러리의 최신 문서를 가져와서 답변에 반영

학습 데이터가 오래된 Claude에게 최신 API 사용법을 가르친 뒤 답변하게 하는 메커니즘입니다. "이 함수는 존재하지 않습니다"라는 말을 들었을 때, Context7을 통해 최신 사양을 참조하게 하면 올바르게 답변할 수 있는 경우가 있었습니다.

claude mcp add mem0 -- npx -y @mem0/mcp-server
# MEM0_API_KEY 가 필요함

대화를 넘나들며 정보를 기억해 둘 수 있는 서버입니다.

활용 가능한 상황

  • "이 프로젝트의 방침", "자주 사용하는 명령어"를 등록해 둔다
  • 세션이 바뀌어도 이전의 문맥을 이어간다
  • 여러 프로젝트에 걸친 공통 정보를 관리한다

Claude Code 자체에도 /memory 기능이 있지만, Mem0는 플랫폼을 가로질러(Claude.ai 데스크톱, API 등) 공유할 수 있다는 점이 다릅니다.

claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking

단계를 순차적으로 기록하며 추론하게 하는 서버입니다. 복잡한 설계 태스크나 판단 기준이 많은 문제에 사용하면 정리하기 쉬워집니다.

"어떤 아키텍처를 선택해야 하는가"와 같은 질문을 던지면, 생각의 과정을 기록하면서 결론을 내줍니다. 결과보다 과정이 보이게 된다는 점이 검증에 편리했습니다.

# Claude.ai의 설정 화면에서 OAuth를 통해 접속

Claude Code의 마켓플레이스에서 추가할 수 있습니다.

서버할 수 있는 일
Gmail메일 검색·요약·초안 작성
...

"이번 주 미팅 목록을 보여줘", "이 제목의 메일을 요약해줘"와 같은 방식으로 사용할 수 있습니다. 다만, 전송·삭제 등의 조작은 확인 단계를 거치도록 설정해 두는 것이 안심됩니다.

단독으로 사용할 때보다 조합했을 때 효과가 나타나기 쉬운 패턴입니다.

【기사 집필 플로우】
Brave Search (최신 정보를 조사)
+ Filesystem (로컬 초안을 읽기·쓰기)
...
【코드 리뷰 플로우】
GitHub (PR의 차이점(diff)을 가져오기)
+ Context7 (사용 중인 라이브러리의 문서 참조)
...

Cursor의 문서에 따르면, MCP 서버가 제공하는 도구(tool) 수의 합계가 약 40개를 넘으면 동작이 불안정해진다고 합니다. Claude Code에서도 대량의 서버를 추가하면 어떤 도구를 사용할지 선택하는 속도가 느려질 수 있습니다. 우선 3~5개 정도로 압축하는 것이 현실적입니다.

API 키나 OAuth 토큰을 다루는 서버가 많습니다. .env 파일이나 시크릿 관리 도구를 사용하여, 키를 코드 내에 그대로 작성하지 않도록 주의해야 합니다.

브라우저 조작·메일 전송 등 부작용(side effect)이 있는 조작은 처음에는 읽기 전용으로 테스트한 뒤 범위를 넓히는 것이 안전합니다.

MCP 서버는 2026년 6월 시점에서 Glama 단독으로 2만 개 이상, 여러 레지스트리(Smithery, mcp.so 등)를 합산하면 5만 개 규모에 달합니다. 전부 확인하는 것은 현실적으로 불가능하므로, 자신의 워크플로우에서 무엇이 병목(bottleneck)이 되고 있는지를 먼저 정리한 뒤 선택하는 것이 효율적이라고 느꼈습니다.

이번에 테스트한 것 중에서는 GitHub + Brave Search + Context7의 조합이 코드를 작성하면서 조사하는 작업에 가장 잘 맞았습니다.

MCP 서버특히 효과적이었던 상황
GitHub브라우저 없이 PR / Issue 관리
...

MCP는 "AI에게 무언가를 시키는 것"이라기보다 "AI가 참조·조작할 수 있는 범위를 넓히는 것"이라고 이해하니, 무엇을 추가해야 할지가 더 명확해졌습니다. 우선 자신의 작업에서 자주 반복하는 일을 떠올려 보고, 그에 맞는 서버를 1~2개 시도해 보는 것이 좋을 것 같습니다.

  • Model Context Protocol — 공식 사이트
  • Anthropic — MCP 발표
  • modelcontextprotocol/servers — GitHub
  • github/github-mcp-server — GitHub 공식 MCP 서버
  • Best MCP Servers May 2026 — andrew.ooo
  • The 15 MCP Servers Worth Wiring Into Claude Code and Cursor (2026) — Codersera

이 기사는 Zenn에서도 공개하고 있습니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0