[[부록09_Smithery_MCP_마켓플레이스_가이드|부록 09]]. Smithery — MCP 마켓플레이스 가이드
[!abstract] MCP 생태계의 주요 마켓플레이스와 Smithery.ai에서 MCP 서버를 찾아 n8n AI Agent에 연결하는 방법을 안내합니다. 이 가이드를 따라하면 직접 개발하지 않고도 수천 개의 공개 MCP 서버를 AI 에이전트의 도구로 활용할 수 있게 되죠.
[!tip] 5.1.3 MCP 클라이언트 실습에서 오셨나요? 5.1.3 섹션에서 MCP의 개념과 n8n 내부 MCP 서버 구축을 배웠다면, 이 가이드는 그 다음 단계입니다. 이미 만들어진 외부 MCP 서버를 Smithery에서 찾아 n8n AI Agent에 연결하는 방법을 다룹니다.
순서 완료할 항목 비고 1 Smithery.ai 접속 가입 없이 탐색 가능 2 MCP 서버 검색 원하는 도구 찾기 3 Connection URL 복사 서버 상세 페이지 Connect 섹션에서 확인 4 n8n MCP Client Tool 연결 Endpoint URL에 입력 5 테스트 AI Agent에서 도구 호출 확인 5단계까지 완료하고 AI Agent가 외부 MCP 서버의 도구를 정상 호출하면 준비 끝입니다. [[Day22_05.1.3_MCP_클라이언트_노드_사내_업무_도우미_만들기|5.1.3]]으로 돌아가세요.
MCP 생태계 한눈에 보기
**MCP(Model Context Protocol)**는 Anthropic이 2024년에 공개한 오픈 표준 프로토콜로, AI 모델에게 외부 도구와 데이터를 연결하는 규격입니다. 공개 이후 빠르게 업계 표준으로 자리잡으면서, 수천 개의 MCP 서버가 개발·공개되고 있습니다.
💡 MCP 개념이 처음이라면? [[Day22_05.1.3_MCP_클라이언트_노드_사내_업무_도우미_만들기|5.1.3 MCP 클라이언트 노드로 도구 확장하기]]에서 MCP의 개념, 서버와 클라이언트의 역할, USB-C 비유 등을 상세히 설명하고 있습니다. 먼저 읽고 오시면 이 가이드가 훨씬 쉽게 느껴질 거예요.
MCP 서버를 찾고 활용할 수 있는 대표적인 마켓플레이스를 정리하면 다음과 같습니다.
| 마켓플레이스 | 서버 수 | 특징 |
|---|---|---|
| Smithery.ai | 7,300+ | 최대 규모, Connection URL·성능 지표 제공 |
| PulseMCP | 8,590+ | 일일 업데이트, 뉴스레터 제공 |
| Glama | 18,500+ | 최대 목록, 카테고리별 분류 |
| 공식 MCP Registry | — | Anthropic 공식 레지스트리 |
이 중 Smithery.ai는 각 서버의 Connection URL과 성능 지표(Uptime, Latency, 호출 횟수)를 직접 제공하여, MCP 서버의 안정성을 판단하고 n8n에서 바로 연결할 수 있어 가장 실용적입니다.
stdio vs HTTP — 전송 방식의 차이
MCP 서버에 연결하는 방식은 크게 두 가지가 있습니다. n8n에서 외부 MCP 서버를 사용하려면 이 차이를 반드시 이해해야 합니다.
| 구분 | stdio (Standard I/O) | HTTP (Streamable HTTP / SSE) |
|---|---|---|
| 작동 방식 | 로컬에서 프로세스를 직접 실행하여 입출력으로 통신 | HTTP를 통해 원격 서버에 네트워크로 연결 |
| 설치 필요 | MCP 서버 프로그램을 내 컴퓨터에 설치해야 함 | 설치 불필요, URL만 있으면 됨 |
| 적합한 환경 | 로컬 개발 (VS Code, Claude Desktop 등) | 서버 환경 (n8n, 웹 서비스 등) |
| n8n 지원 | ❌ 지원하지 않음 | ✅ MCP Client Tool에서 지원 |
⚠️ 핵심 포인트: n8n의 MCP Client Tool은 **HTTP 기반 방식(Streamable HTTP / SSE)**만 지원합니다. Smithery에서 MCP 서버를 고를 때, 상세 페이지에 Remote 배지가 있는 서버만 n8n에서 사용 가능합니다.
stdio전용 서버는 n8n에서 직접 연결할 수 없습니다.
💡 왜 n8n은 HTTP 방식만 지원할까요? n8n은 서버에서 실행되는 자동화 플랫폼입니다. 로컬 프로세스를 직접 실행하는
stdio방식은 보안 위험이 있고, Docker 환경에서도 제약이 많습니다. 반면 HTTP 방식은 네트워크 기반이므로, n8n 서버에서 외부 MCP 서버로 안전하게 연결할 수 있습니다.
Smithery.ai 접속 및 탐색
STEP 1: 사이트 접속
- 브라우저에서 https://smithery.ai 에 접속합니다.
- 메인 페이지에서 MCP 서버를 바로 검색할 수 있습니다.
![[그림부록09-1.png]] [그림부록09-1] Smithery.ai 메인 페이지
STEP 2: 가입 (선택)
- GitHub 계정으로 가입할 수 있습니다.
- 가입 없이도 서버 탐색과 Connection URL 확인이 가능합니다.
- 자신만의 MCP 서버를 등록하려면 가입이 필요합니다.
STEP 3: 서버 탐색
- 상단 메뉴에서 MCPs를 클릭하거나, 검색창에 키워드를 입력합니다.
- 카테고리별로 분류된 MCP 서버 목록을 확인할 수 있습니다. 상단 메뉴의 Skills, Docs 탭도 함께 활용해 보세요.
![[그림부록09-2.png]] [그림부록09-2] Smithery 서버 검색·탐색 화면
카테고리별 인기 MCP 서버
| 카테고리 | 대표 MCP 서버 | 용도 |
|---|---|---|
| 문서·지식 | Context7 | 라이브러리 공식 문서 검색 |
| 웹 자동화 | Playwright | 브라우저 조작·스크린샷 |
| 사고·추론 | Sequential Thinking | 구조적 문제 해결·분석 |
| 데이터베이스 | Supabase, PostgreSQL | DB 조회·관리 |
| 파일 시스템 | FileSystem | 로컬 파일 읽기·쓰기 |
| 검색 | Brave Search, Tavily | 웹 검색 결과 제공 |
[!tip] 검색창에 원하는 키워드(예:
search,database,
MCP 서버 상세 페이지 살펴보기
Smithery에서 MCP 서버를 클릭하면 상세 페이지로 이동합니다. 서버 상세 페이지는 Overview · Performance · Usage · API 4개 탭으로 구성되며, Google Calendar MCP 서버(smithery.ai/servers/googlecalendar)를 예시로 살펴보겠습니다.
STEP 4: 서버 상세 페이지 열기
- 원하는 MCP 서버를 클릭하여 상세 페이지에 들어갑니다.
- 상단 헤더에 서버의 핵심 지표가 배지 형태로 한눈에 표시됩니다.
| 항목 | 설명 | 예시 |
|---|---|---|
| Score | 서버 품질 점수 (100점 만점) | 54/100 |
| Remote | 원격 서버 여부 — n8n 연결 가능 여부의 핵심 | Remote 배지 |
| Calls | 누적 도구 호출 횟수 | 5.6k calls |
| Uptime | 최근 30일 가동률 | 97.1% uptime |
| last deployed | 서버 최종 배포 시점 | 4 months ago |
![[그림부록09-3.png]] [그림부록09-3] MCP 서버 상세 페이지 — 상단 헤더와 4개 탭 네비게이션
💡 ==Remote== 배지가 표시된 서버만 n8n에서 연결 가능합니다. Remote가 없는 서버는
stdio전용이므로, n8n MCP Client Tool에서 사용할 수 없습니다.
Overview 탭 — About · Capabilities · Connect
상세 페이지에 처음 들어오면 Overview 탭이 표시됩니다. 좌측에는 About(서버 설명)과 Capabilities(제공하는 도구 목록)가, 우측에는 Connect(연결 방법) 섹션이 배치됩니다.
About 섹션에는 서버의 용도와 기능이 간략히 설명되어 있고, Capabilities 섹션에는 이 서버가 제공하는 도구(Tool)의 이름과 설명이 나열됩니다. 예를 들어 Google Calendar MCP 서버는 events_list, create_event, find_event 등 29개 도구를 제공합니다.
하단에는 Published(등록 날짜)와 Weekly Tool Calls(주간 호출 수 추이 그래프)가 표시됩니다.
MCP 서버 연결 URL 확인하기 (Connect 섹션)
Overview 탭 우측의 Connect 섹션에서 연결 URL을 확인합니다.
STEP 5: Connection URL 복사
- Connect 섹션 상단의 Get connection URL 필드에 서버의 연결 URL이 표시됩니다.
- 우측 복사 버튼을 클릭하여 URL을 복사합니다.
![[그림부록09-4.png]] [그림부록09-4] Connect 섹션 — Connection URL 복사
💡 URL 형식:
https://{서버이름}.run.tools형식입니다. 예:https://googlecalendar.run.tools
Agents 탭 vs Humans 탭
Connection URL 아래에 Or connect your agent라는 안내와 함께, Agents와 Humans 두 개의 탭이 있습니다.
| 탭 | 대상 | 설명 |
|---|---|---|
| Agents | AI 에이전트 | Claude Code, Codex, OpenClaw, Cursor, Poke, Claude 등 — AI가 LLM 프롬프트로 자동 설치 |
| Humans | 사람 (수동 설치) | API, Claude Code, Codex, Cursor 등 클라이언트를 선택하면 수동 설정 코드 표시 |
- Agents 탭: AI 에이전트 클라이언트 목록이 표시됩니다. 클라이언트를 선택하면 해당 에이전트에 맞는 설치 명령이 나타납니다.
- Humans 탭: Search clients 검색 필드에서 클라이언트를 선택하면, 해당 환경에 맞는 JSON 설정 코드가 표시됩니다. 하단에는 Building a client or agent? 링크로 개발자 문서(View developer docs)로 연결됩니다.
[!tip] n8n에서는 Connection URL만 필요합니다 n8n의 MCP Client Tool은 Agents/Humans 탭의 설치 방법과 무관합니다. Get connection URL 필드의 URL만 복사하면 됩니다.
Performance · Usage · API 탭
서버 상세 페이지의 나머지 탭은 서버의 상태와 활용 현황을 파악하는 데 유용합니다. 상단의 탭 네비게이션(Overview · Performance · Usage · API)에서 전환할 수 있습니다.
Performance 탭
서버가 제공하는 각 도구(Tool)의 성능 지표를 테이블과 차트로 확인할 수 있습니다.
좌측 — 도구별 성능 테이블:
| 지표 | 설명 |
|---|---|
| Tool | 도구 이름 (예: events_list, create_event) |
| Calls | 각 도구의 호출 횟수 |
| Latency | 평균 응답 시간 (초 단위) |
| Uptime | 가동률 (%) |
우측 — 30일 추이 차트:
- Uptime (30d): 일별 가동 상태를 색상 바 차트로 표시 (초록=정상, 빨강=장애)
- Latency (30d): 응답 시간 추이를 꺾은선 그래프로 표시
![[그림부록09-5.png]] [그림부록09-5] Performance 탭 — 도구별 성능 테이블과 Uptime/Latency 차트
💡 MCP 서버 선택 기준: Uptime이 95% 이상이고 Latency가 2초 이내인 서버가 안정적입니다. Uptime이 낮거나 Latency가 높은 서버는 n8n 워크플로 실행 중 타임아웃이 발생할 수 있으니 주의하세요.
Usage 탭
MCP 서버를 어떤 클라이언트가 얼마나 사용하고 있는지 보여줍니다.
- Top Clients: 주요 사용 클라이언트와 호출 횟수 순위 (예: Claude Code 10,585 / Smithery 8,185 / Codex 6,954)
- Daily Sessions: 일일 세션 수 추이를 막대 그래프로 표시
이 정보는 해당 서버의 인기도와 활발한 사용 여부를 판단하는 데 도움됩니다. Top Clients에 Claude Code, Codex 같은 주요 AI 에이전트가 상위에 있다면 안정적으로 운영되는 서버라고 볼 수 있습니다.
API 탭
개발자가 Smithery Connect API를 통해 MCP 서버를 자체 애플리케이션에 프로그래밍 방식으로 통합하는 방법을 안내합니다.
| 서브 탭 | 설명 |
|---|---|
| CLI | Smithery CLI 설치(npm install -g @smithery/cli@latest) → 네임스페이스 생성 → smithery mcp add {서버} → smithery tool call |
| AI SDK | Anthropic AI SDK를 활용한 코드 통합 |
| TypeScript | TypeScript 프로젝트에서 MCP SDK로 직접 연결 |
좌측에는 Create API key 버튼과 Manage Connections 링크가 제공되며, 우측에 선택한 서브 탭에 따른 코드 스니펫이 표시됩니다.
[!note] n8n 사용자에게 API 탭은 참고용입니다 n8n에서는 MCP Client Tool의 Endpoint URL로 연결하므로 API 탭의 코드를 직접 사용하지는 않습니다. 다만, MCP 서버를 자체 앱에 통합하려는 개발자에게는 매우 유용한 정보입니다.
n8n에서 외부 MCP 서버 연결하기
Smithery에서 찾은 MCP 서버를 n8n AI Agent에 연결하는 방법은 [[Day22_05.1.3_MCP_클라이언트_노드_사내_업무_도우미_만들기|5.1.3]]에서 배운 MCP Client Tool 사용법과 동일합니다.
STEP 6: MCP Client Tool 추가
- AI Agent 노드 하단의 ==Tool== 커넥터를 클릭하여 MCP Client Tool을 추가합니다.
- MCP Client Tool 설정에서 Endpoint URL에 Smithery에서 복사한 Connection URL을 붙여넣습니다.
- Authentication을 설정합니다.
| 인증 방식 | 설명 | 사용 시점 |
|---|---|---|
| None | 인증 없이 연결 | 공개 MCP 서버 (대부분의 Smithery 서버) |
| Bearer Token | API 키를 Bearer 토큰으로 전송 | API 키가 필요한 유료 서버 |
| Header Auth | 커스텀 헤더로 인증 | 특수 인증 방식 서버 |
- Tools to Include를 설정합니다 (기본값 All 권장).
![[그림부록09-6.png]] [그림부록09-6] n8n MCP Client Tool에서 외부 MCP 서버 연결 설정
[!note] 여러 MCP 서버 동시 연결 AI Agent 하나에 MCP Client Tool을 여러 개 추가할 수 있습니다. 예를 들어, Smithery의 웹 검색 MCP 서버와 자체 제작한 사내 업무 MCP 서버를 동시에 연결하면, AI Agent가 두 서버의 도구를 모두 사용할 수 있습니다.
주의사항
- Production URL vs Test URL: MCP 서버가 n8n 워크플로인 경우, 반드시 Production URL을 사용하세요. Test URL은 워크플로 편집 중에만 동작합니다.
- 네트워크 접근: 외부 MCP 서버는 인터넷을 통해 연결되므로, n8n 서버가 외부 네트워크에 접근할 수 있어야 합니다.
- 응답 시간: 외부 서버 특성상 응답이 느릴 수 있습니다. MCP Client Tool의 Options → Timeout 값을 적절히 조정하세요 (기본 60초).
- API 키가 필요한 서버: 일부 Smithery 호스팅 MCP 서버는 외부 서비스의 API 키가 필요합니다(예: Brave Search는 brave.com/search/api에서 무료 발급). Smithery 상세 페이지의 Connect 섹션 안내를 확인해, URL 쿼리 파라미터(
?api_key=...) 또는 Authentication의 Bearer Token으로 전달하세요.
정리하며
이 부록의 핵심을 정리하면 다음과 같습니다.
- Smithery.ai는 MCP 마켓플레이스: 7,300개 이상의 MCP 서버를 탐색하고, Connection URL을 바로 복사해 n8n에 연결할 수 있습니다.
- Remote 배지 확인 필수: n8n은 HTTP 기반 방식(Streamable HTTP / SSE)만 지원하므로, 서버 상세 페이지에서 Remote 배지가 있는 서버만 사용 가능합니다.
- Performance 탭으로 안정성 판단: Uptime은 95% 이상, Latency는 2초 이내가 안정적입니다. 호출 횟수와 함께 확인하세요.
- Connect 섹션의 URL만 복사: Agents/Humans 탭은 다른 클라이언트용 설치 가이드이며, n8n에서는 Get connection URL 필드의 URL만 사용합니다.
- API 탭은 개발자용: MCP 서버를 자체 앱에 통합하려는 경우에 활용합니다. n8n 사용 시 직접 사용할 일은 없습니다.
설정 체크리스트
- Smithery.ai에서 원하는 MCP 서버를 검색·탐색
- 서버 상세 페이지에서 Remote 배지 확인
- Performance 탭에서 Uptime과 Latency 확인
- Connect 섹션에서 Connection URL 복사
- 필요한 경우 외부 API 키 발급
- n8n AI Agent에 MCP Client Tool 추가
- Endpoint URL에 Connection URL 입력 및 Authentication 설정
자주 하는 실수와 해결법
| 증상 | 원인 | 해결법 |
|---|---|---|
Connection refused 또는 타임아웃 | Connection URL이 잘못됨 | Connect 섹션에서 URL을 다시 복사. https://{서버}.run.tools 형식인지 확인 |
| Remote 배지가 없는 서버 | stdio 전용 서버 | n8n에서 사용 불가, Remote 배지가 있는 다른 서버를 선택 |
| AI Agent가 도구를 사용하지 않음 | Tools to Include 설정 오류 | MCP Client Tool에서 Tools to Include가 All인지 확인. 특정 도구만 선택한 경우 이름 정확성 확인 |
401 Unauthorized | 인증이 필요한 서버에 인증 미설정 | Authentication에서 Bearer Token 또는 Header Auth로 API 키 입력 |
Tool execution timed out | 외부 서버 응답 지연 | Options → Timeout을 120초 이상으로 늘리기. Performance 탭에서 Latency 확인 |
Invalid URL 또는 연결 오류 | URL에 공백이나 특수문자 포함 | URL을 텍스트 편집기에 붙여넣고 앞뒤 공백 제거 후 다시 입력 |
💡 다음 단계: 한국 서비스(네이버 쇼핑·검색·뉴스 등)와 연동하려면 네이버 개발자센터에서 별도 API 키를 발급해야 합니다. 다음으로 [[부록10_네이버_개발자센터_API_연동_가이드|부록 10. 네이버 개발자센터 API 연동 가이드]]를 참고하세요.