Claude MCP 서버 4개, 용도별로 골랐어요

지금 붙일 만한 Claude MCP 서버는 4개예요 — GitHub, Context7, 파일시스템, SocialCrawl. Claude Code나 Claude Desktop으로 에이전트를 만드는 분이 용도별로 골라 쓰라고 모아 둔 리스트예요. 설치 how-to가 아니라 큐레이션이에요. 플래그 원전은 Claude Code MCP 공식 문서예요.

Claude Code MCP 설정은 Desktop이랑 뭐가 다른가요?

Claude Code MCP 설정은 CLI의 claude mcp add로 붙이거나, 필요하면 프로젝트 .mcp.json에 적어요. Claude Desktop은 claude_desktop_config.json의 mcpServers에 적어요. 플래그 이름은 공식 문서가 원전이라, 여기서 다시 풀어 쓰지 않을게요.

클라이언트	설정 위치	붙이는 방법
Claude Code	CLI, 필요하면 프로젝트 .mcp.json	claude mcp add
Claude Desktop macOS	~/Library/Application Support/Claude/claude_desktop_config.json	JSON mcpServers
Claude Desktop Windows	%APPDATA%\Claude\claude_desktop_config.json	JSON mcpServers

경로 두 줄은 브런치 위키북 발췌와 같은 위치예요. Cursor는 .cursor/mcp.json의 mcpServers예요. claude.ai 웹 커넥터는 Name과 URL만 받아요. 커스텀 헤더가 없어서, 헤더로 인증하는 서버는 막힐 수 있어요. 공식 정책 인용이 아니라, 붙이면서 본 동작이에요.

로컬은 stdio, 원격은 Streamable HTTP예요. HTTP+SSE는 레거시로 남아 있어요. 클라이언트는 시작할 때 서버 목록을 읽어요. 추가한 뒤에는 클라이언트를 재시작하세요.

Claude MCP 서버, 고를 때 뭘 보면 되나요?

리스트를 읽기 전에 이 다섯 가지만 필터로 두세요.

• 클라이언트 — Claude Code CLI인지, Desktop JSON인지, 원격 HTTP인지
• 트랜스포트 — 로컬 프로세스면 stdio, 호스티드면 Streamable HTTP
• 데이터 평면 — 리포·이슈인지, 라이브러리 문서인지, 로컬 파일인지, 소셜·커머스인지
• 컨텍스트 비용 — 도구 출력이 컨텍스트를 채워요. 서버를 많이 붙일수록 툴 스키마가 창을 먹어요
• 인증 — 로컬은 env, 원격은 헤더. JSON 본문에 키를 심지 말고 env로 빼세요

지금 붙일 서버 4개는 용도가 어떻게 나뉘나요?

데이터 평면이 달라요. 용도만 보고 고르게, 한 표로 먼저 볼게요.

#	서버	잘 맞는 경우	가격
1	GitHub MCP	이슈·PR·리포를 Claude에서 다룰 때	이 글에서 미확인
2	Context7 MCP	라이브러리 문서를 최신으로 가져올 때	이 글에서 미확인
3	파일시스템 MCP	Desktop에서 로컬 폴더를 열 때	이 글에서 미확인
4	SocialCrawl MCP	TikTok·Instagram·YouTube·Reddit 데이터를 Claude에서 조회할 때	가입 시 100 무료 크레딧, 카드 없음. 호출당 크레딧 (대부분 1, 무거운 호출 5/10, /v1/search/everywhere 20)

1위를 정하지 않았어요. 데이터 평면이 다르면 서버도 달라요.

1. GitHub MCP — 이슈·PR·리포를 Claude에서 다루는 서버

GitHub MCP는 이슈·PR·리포를 Claude 대화 안에서 다루는 워크플로 서버예요. 코드 에이전트를 붙일 때 기본값으로 두는 경우가 많아요.

무엇을 해요: GitHub MCP로 이슈와 PR, 리포를 대화 안에서 다뤄요.

대표 기능: Claude Code MCP 문서의 GitHub 예는 원격 HTTP예요. https://api.githubcopilot.com/mcp/에 PAT를 Authorization: Bearer로 붙이면 돼요. 예제 서버 모음의 GitHub 구현은 아카이브로 옮겨졌어요. 도구 목록은 공식 README에서 복사하세요. JSON은 여기서 지어내지 않을게요.

한계: 소셜 데이터, 로컬 파일, 라이브러리 문서는 GitHub MCP 일이 아니에요.

가격: 이 글에서 확인 못 함.

이런 분께 잘 맞아요: Claude Code로 리포를 만지는 분.

2. Context7 MCP — 라이브러리 문서를 최신으로 가져오는 서버

Context7은 라이브러리 문서를 모델이 추측하지 않게 조회하는 서버예요. 한국어 Claude Code MCP 입문 글이 설치 대상으로 넣는 경우가 많아요.

무엇을 해요: 자주 바뀌는 라이브러리 API를 최신 문서로 가져와요.

대표 기능: 도구 수와 가격은 이 글에서 확인 못 했어요. 위키독스 클로드 코드 입문 Step 1이 Context7 설정이고, 이어서 /init과 Plan Mode로 갑니다. GPTers 사례는 설치 뒤 /agents로 코드 리뷰 에이전트를 만들어요.

한계: 리포 조작이나 소셜 데이터는 안 해요.

가격: 이 글에서 확인 못 함.

이런 분께 잘 맞아요: API가 자주 바뀌는 스택을 Claude Code로 붙이는 분.

3. 파일시스템 MCP — 로컬 폴더를 Claude Desktop에 붙이는 서버

파일시스템 MCP는 로컬 폴더와 파일을 Desktop 대화에 붙이는 서버예요. 초보 Desktop 가이드와 브런치 파일 가이드가 이 경로를 많이 다뤄요.

무엇을 해요: Claude Desktop에서 개인 폴더를 열어요.

대표 기능: 공식 레퍼런스 패키지는 @modelcontextprotocol/server-filesystem이에요. 허용 폴더를 args에 넣어요. Windows·macOS 설정 파일 경로는 위 표를 보세요.

한계: 원격 리포, 웹, 소셜은 안 돼요. 경로 권한과 비밀 파일이 이 서버의 리스크예요.

가격: 이 글에서 확인 못 함.

이런 분께 잘 맞아요: Claude Desktop에서 개인 폴더를 여는 분. Claude Code 원격 워크플로의 기본값은 아니에요.

4. SocialCrawl MCP — 소셜 데이터를 Claude에 붙이는 서버

Claude에 소셜·커머스·리서치 데이터를 붙이는 선택지예요.

무엇을 해요: 도구 몇 개로 디스커버리 다음에 호출해요. 엔드포인트마다 도구를 만들지 않아요. 잘못된 요청은 과금 전에 로컬에서 실패해요.

대표 기능: MCP 패키지 v1.9.0 기준 48개 플랫폼, 381개 엔드포인트, 도구 9개예요. 라이브 REST API는 그 이후 50개 플랫폼, 400개 엔드포인트로 늘었고, 패키지가 릴리스 한 박자 뒤예요. 도구 9개는 디스커버리와 호출로 나뉘고, 호출·잔액·모니터·웹 네 개가 키를 받아요. 출력 상한은 25,000자예요.

원격은 https://mcp.socialcrawl.dev/mcp (Streamable HTTP)이고, 키는 쿼리스트링이 아니라 Authorization: Bearer 또는 x-api-key예요. 로컬은 npx -y socialcrawl-mcp에 SOCIALCRAWL_API_KEY를 붙여요.

한계: GitHub 이슈·PR, 로컬 파일, 라이브러리 문서는 다른 서버 일이에요. 키 없으면 번들 디스커버리만 돼요. 웹 커넥터는 커스텀 헤더가 없어 키 도구가 막힐 수 있어요.

가격: 가입 시 100 무료 크레딧, 카드 없음. 설정 문서 기준이에요. 디스커버리는 0 크레딧이고, REST API랑 과금이 같아요. 대부분 1, 무거운 호출 5 또는 10, /v1/search/everywhere는 플랫 20, 캐시 히트 0.

이런 분께 잘 맞아요: Claude가 TikTok, Instagram, YouTube, Reddit을 조회해야 하는 에이전트 빌더. 리스닝 파이프라인으로 이어가려면 소셜 리스닝을 API 하나로 붙이는 법을 보세요. 댓글만 따로 받으려면 유튜브 댓글, API로 5분 만에 받는 방법이에요.

Claude Code에 원격으로 붙일 때:

claude mcp add --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \
  --header "Authorization: Bearer sc_your_key_here"

로컬 stdio로 붙일 때는 아래처럼 해요. -- 앞이 플래그, 뒤가 실행 커맨드예요. 추가한 뒤 재시작하세요.

claude mcp add --scope user socialcrawl -e SOCIALCRAWL_API_KEY=sc_your_key_here -- npx -y socialcrawl-mcp

서버 여러 개를 한 mcp.json에 어떻게 쌓나요?

Desktop이든 프로젝트 .mcp.json이든, 키 이름은 mcpServers예요. 상위권 글은 서버 1개 JSON만 보여주는 경우가 많아요. GitHub는 원격 HTTP, 파일시스템은 공식 레퍼런스 패키지, Context7은 공식 README의 command/args를 붙여 넣으세요. SocialCrawl stdio와 GitHub HTTP, 파일시스템만 이 글에서 채웠어요. 키는 JSON 본문이 아니라 env나 headers로 두세요.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <YOUR_GITHUB_PAT>"
      }
    },
    "context7": {
      "command": "<공식 README에서 붙여 넣으세요>",
      "args": []
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Cursor도 mcpServers예요. VS Code는 .vscode/mcp.json에서 키가 servers이고 type을 명시해요.

MCP 서버 만들기, 가져다 쓰는 것보다 나을 때는?

MCP 서버 만들기는 사내 도구이거나 리스트에 없는 데이터 평면일 때, 또는 권한 경계를 직접 정해야 할 때 나아요. GitHub 이슈, 최신 라이브러리 문서, 로컬 폴더, 소셜 조회는 위 4개가 그 일이에요. 그 평면에서 MCP 서버 만들기를 먼저 고를 이유는 적어요.

최소 TypeScript 경로는 공식 SDK예요. Zod는 peer dependency고, Node는 18 이상이에요.

1. npm install @modelcontextprotocol/sdk zod
2. McpServer에 name, version
3. registerTool / registerResource — 레거시 server.tool()은 deprecated
4. connect — 로컬이면 stdio, 원격이면 Streamable HTTP

Claude Code로 서버를 만드는 한국어 how-to는 위키독스 챕터를 보세요. Step 0–3을 여기서 다시 쓰지 않을게요.

npm install @modelcontextprotocol/sdk zod

나한테 맞는 Claude MCP는 어떻게 고를까요?

리스트에 있는 것만 고르면 돼요. 다 붙이지 마세요. 툴 스키마가 컨텍스트를 먹어요.

• 리포·PR·이슈 → GitHub MCP
• 라이브러리 API가 자주 바뀜 → Context7
• Desktop + 로컬 폴더 → 파일시스템
• TikTok / Instagram / YouTube / Reddit 조회 → 리스트 마지막 항목
• 사내 전용 도구 → 직접 만들기 (위 섹션)

Claude MCP, 검색에서 자주 나오는 질문

Claude MCP가 뭔가요? Claude Code랑은 어떻게 달라요? Claude MCP(클로드 MCP)는 Claude에 도구와 데이터를 붙이는 표준이에요. 공식 문서는 MCP를 "AI 도구 통합을 위한 오픈 소스 표준"이라고 해요. Claude Code는 그 표준을 쓰는 클라이언트예요. (Claude Code 문서, Reddit 스레드)

Claude Code MCP 설정, Desktop이랑 뭐가 다른가요? Code는 CLI나 .mcp.json, Desktop은 claude_desktop_config.json이에요. 경로는 위 표를 보세요.

GitHub MCP는 Claude에서 어디에 쓰나요? 이슈·PR·리포를 대화 안에서 다룰 때예요. 소셜이나 로컬 파일은 다른 서버 일이에요.

MCP 서버 만들기, 초보가 바로 해도 되나요? 사내 도구처럼 리스트에 없는 데이터면 그때 만들면 돼요. 이슈·문서·폴더·소셜은 위 4개가 그 일이에요.

소셜 데이터용 Claude MCP도 있나요? 리스트 마지막 항목이 그 데이터 평면이에요. 서버를 많이 붙일수록 툴 스키마가 창을 먹으니, 필요한 것만 붙이세요.

설치 플래그는 Claude Code MCP 공식 문서를 보세요. 호스티드·로컬 설정은 skills-and-mcp 문서에 모아 두었어요. 소셜 쪽 원본을 API로 받는 다음 글은 유튜브 분석 사이트 대신 원본 데이터 받기예요.