Smithery MCP로 외부 서비스 연결하는 방법

Smithery MCP로 외부 서비스 연결하는 방법

📌 이 글의 핵심 요약

• Smithery는 MCP 서버를 검색·설치할 수 있는 세계 최대 MCP 마켓플레이스다
• Claude Desktop, Cursor, VS Code 등 주요 AI 클라이언트에 외부 서비스를 연결할 수 있다
• 설치는 Smithery에서 설정값 복사 → 클라이언트 config 파일에 붙여넣기로 완료된다
• GitHub, 날씨, 파일 시스템, 데이터베이스 등 6,000개 이상의 MCP 서버가 등록돼 있다

📋 목차

1. Smithery와 MCP란 무엇인가
2. Smithery 가입과 MCP 서버 탐색
3. Claude Desktop에 MCP 서버 연결하기
4. Cursor에 MCP 서버 연결하기
5. 자주 쓰는 MCP 서버 추천과 활용 팁
6. 정리 및 결론

Smithery와 MCP란 무엇인가

AI 에이전트가 GitHub를 직접 조회하거나, 로컬 파일을 읽거나, 외부 API를 호출하려면 AI와 외부 시스템 사이를 연결하는 표준 규약이 필요하다. MCP(Model Context Protocol)는 Anthropic이 만든 이 연결 규약이다. AI 클라이언트가 MCP 서버를 통해 외부 도구를 일관된 방식으로 호출할 수 있도록 구조를 정의한다.

Smithery는 MCP 서버들을 한곳에 모아놓은 마켓플레이스다. 전 세계 개발자들이 만든 MCP 서버를 검색하고 설치 설정값을 바로 복사할 수 있다. Claude Desktop, Cursor, VS Code 등 주요 클라이언트를 지원하는 클라이언트 무관 설계가 특징이다.

---

Smithery 가입과 MCP 서버 탐색

smithery.ai에 접속하면 GitHub 계정으로 바로 로그인할 수 있다. 별도 회원가입 절차는 없다.

🔍 Smithery에서 MCP 서버 찾는 방법

• 상단 검색창에 원하는 서비스를 영문으로 검색 (예: github, weather, database)
• 카테고리 필터로 파일 시스템, 검색, 개발 도구 등 분류별 탐색 가능
• 각 서버 페이지의 Overview, Tools 탭으로 기능 상세 확인
• 설치 수, 평점, 배포 날짜로 안정성 검증 후 선택 권장

서버 상세 페이지에서 클라이언트를 선택하면 해당 환경에 맞는 설정 코드가 자동으로 생성된다. 이 코드를 클라이언트 설정 파일에 붙여넣기만 하면 설치가 끝난다.

---

Claude Desktop에 MCP 서버 연결하기

Claude Desktop에 MCP 서버를 연결하려면 claude_desktop_config.json 파일을 수정해야 한다. 파일 위치는 운영체제마다 다르다.

📂 config 파일 위치

• macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows — %APPDATA%\Claude\claude_desktop_config.json

Smithery에서 연결할 MCP 서버를 찾고 Claude Desktop을 선택하면 아래와 같은 형태의 설정 코드가 나온다.

// claude_desktop_config.json { "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@smithery-ai/github", "--config", "{\"githubPersonalAccessToken\":\"YOUR_TOKEN\"}" ] } } }

토큰이나 API 키가 필요한 서버는 Smithery 페이지 입력 필드에 값을 넣으면 설정 코드에 자동 포함된다. 설정 파일 저장 후 Claude Desktop을 재시작하면 설정 → 개발자 탭에서 연결 상태를 확인할 수 있다.

---

Cursor에 MCP 서버 연결하기

Cursor는 Settings → Features → MCP 메뉴에서 추가하거나 .cursor/mcp.json 파일을 직접 편집하는 방식 모두 지원한다.

// .cursor/mcp.json { "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@smithery-ai/github", "--config", "{\"githubPersonalAccessToken\":\"YOUR_TOKEN\"}" ] } } }

⚠️ Cursor 버전 확인 필수
Cursor 0.47.x 이상부터 MCP 설정 방식이 변경됐다. 버전에 따라 설정 파일 경로와 형식이 다를 수 있으므로 설치 전 Cursor 버전을 먼저 확인하는 게 좋다. MCP는 현재 Anthropic 모델(Claude)에서만 정상 동작하므로 Cursor 내 모델 선택도 확인이 필요하다.

---

자주 쓰는 MCP 서버 추천과 활용 팁

⭐ Smithery 인기 MCP 서버

• @smithery-ai/github — 저장소 조회, 이슈·PR 관리, 코드 검색
• filesystem — 로컬 파일 읽기·쓰기, 디렉터리 탐색
• context7 — 라이브러리 공식 문서와 최신 예제를 실시간 조회
• brave-search — Brave 검색 엔진으로 실시간 웹 검색
• desktop-commander — 터미널 명령 실행, 프로세스 관리

💡 여러 MCP 서버를 동시에 사용하는 팁

mcpServers 블록 안에 여러 서버를 나란히 등록하면 동시에 사용할 수 있다. AI가 대화 맥락에 따라 어떤 서버의 도구를 호출할지 스스로 판단하므로 사용자가 매번 서버를 선택할 필요가 없다.

---

정리 및 결론

Smithery MCP 연결 핵심 정리

• Smithery에서 원하는 MCP 서버를 검색 → 클라이언트 선택 → 설정 코드 복사
• Claude Desktop은 claude_desktop_config.json, Cursor는 mcp.json에 붙여넣기
• 토큰·API 키 필요 서버는 Smithery 페이지 입력 필드에서 자동 포함
• 설정 후 클라이언트 재시작으로 적용 확인
• 여러 서버를 mcpServers 블록에 나란히 등록하면 동시 활용 가능

Smithery MCP 연결은 설정 파일 한 번 수정으로 AI 에이전트의 능력을 외부 서비스까지 확장하는 가장 빠른 방법이다. GitHub, 파일 시스템, 검색 엔진을 연결하면 업무 자동화 범위가 눈에 띄게 달라진다.