[[부록09_Smithery_MCP_마켓플레이스_가이드|부록 09]]. Smithery — MCP 마켓플레이스 가이드

📋 개요MCP 생태계의 주요 마켓플레이스와 Smithery.ai에서 MCP 서버를 찾아 n8n AI Agent에 연결하는 방법을 안내합니다. 이 가이드를 따라하면 직접 개발하지 않고도 수천 개의 공개 MCP 서버를 AI 에이전트의 도구로 활용할 수 있게 되죠.

💡 5.2.1 MCP 클라이언트 실습에서 오셨나요?5.2.1 섹션에서 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.2.1_MCP_클라이언트_노드_사내_업무_도우미_만들기|5.2.1]]으로 돌아가세요.

MCP 생태계 한눈에 보기

MCP(Model Context Protocol)는 Anthropic이 2024년에 공개한 오픈 표준 프로토콜로, AI 모델에게 외부 도구와 데이터를 연결하는 규격입니다. 공개 이후 빠르게 업계 표준으로 자리잡으면서, 수천 개의 MCP 서버가 개발·공개되고 있습니다.

💡 MCP 개념이 처음이라면? [[Day22_05.2.1_MCP_클라이언트_노드_사내_업무_도우미_만들기|5.2.1 MCP 클라이언트 노드로 도구 확장하기]]에서 MCP의 개념, 서버와 클라이언트의 역할, USB-C 비유 등을 상세히 설명하고 있습니다. 먼저 읽고 오시면 이 가이드가 훨씬 쉽게 느껴질 거예요.

MCP 서버를 찾고 활용할 수 있는 대표적인 마켓플레이스를 정리하면 다음과 같습니다.

이 중 Smithery.ai는 각 서버의 Connection URL과 성능 지표(Uptime, Latency, 호출 횟수)를 직접 제공하여, MCP 서버의 안정성을 판단하고 n8n에서 바로 연결할 수 있어 가장 실용적입니다.

stdio vs HTTP — 전송 방식의 차이

MCP 서버에 연결하는 방식은 크게 두 가지가 있습니다. n8n에서 외부 MCP 서버를 사용하려면 이 차이를 반드시 이해해야 합니다.

⚠️ 핵심 포인트: 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: 사이트 접속

1. 브라우저에서 https://smithery.ai 에 접속합니다.
2. 메인 페이지에서 MCP 서버를 바로 검색할 수 있습니다.

[그림부록09-1] Smithery.ai 메인 페이지

STEP 2: 가입 (선택)

• GitHub 계정으로 가입할 수 있습니다.
• 가입 없이도 서버 탐색과 Connection URL 확인이 가능합니다.
• 자신만의 MCP 서버를 등록하려면 가입이 필요합니다.

STEP 3: 서버 탐색

3. 상단 메뉴에서 MCPs를 클릭하거나, 검색창에 키워드를 입력합니다.
4. 카테고리별로 분류된 MCP 서버 목록을 확인할 수 있습니다. 상단 메뉴의 Skills, Docs 탭도 함께 활용해 보세요.

카테고리별 인기 MCP 서버

💡 팁검색창에 원하는 키워드(예: search, database, email)를 입력하면 관련 MCP 서버를 빠르게 찾을 수 있습니다. 좌측의 카테고리 필터도 활용해 보세요.

MCP 서버 상세 페이지 살펴보기

Smithery에서 MCP 서버를 클릭하면 상세 페이지로 이동합니다. 서버 상세 페이지는 Overview · Performance · Usage · API 4개 탭으로 구성되며, Google Calendar MCP 서버(smithery.ai/servers/googlecalendar)를 예시로 살펴보겠습니다.

STEP 4: 서버 상세 페이지 열기

5. 원하는 MCP 서버를 클릭하여 상세 페이지에 들어갑니다.
6. 상단 헤더에 서버의 핵심 지표가 배지 형태로 한눈에 표시됩니다.

💡 ==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 복사

7. Connect 섹션 상단의 Get connection URL 필드에 서버의 연결 URL이 표시됩니다.
8. 우측 복사 버튼을 클릭하여 URL을 복사합니다.

💡 URL 형식: https://{서버이름}.run.tools 형식입니다. 예: https://googlecalendar.run.tools

Agents 탭 vs Humans 탭

Connection URL 아래에 Or connect your agent라는 안내와 함께, Agents와 Humans 두 개의 탭이 있습니다.

• Agents 탭: AI 에이전트 클라이언트 목록이 표시됩니다. 클라이언트를 선택하면 해당 에이전트에 맞는 설치 명령이 나타납니다.
• Humans 탭: Search clients 검색 필드에서 클라이언트를 선택하면, 해당 환경에 맞는 JSON 설정 코드가 표시됩니다. 하단에는 Building a client or agent? 링크로 개발자 문서(View developer docs)로 연결됩니다.

💡 n8n에서는 Connection URL만 필요합니다n8n의 MCP Client Tool은 Agents/Humans 탭의 설치 방법과 무관합니다. Get connection URL 필드의 URL만 복사하면 됩니다.

Performance · Usage · API 탭

서버 상세 페이지의 나머지 탭은 서버의 상태와 활용 현황을 파악하는 데 유용합니다. 상단의 탭 네비게이션(Overview · Performance · Usage · API)에서 전환할 수 있습니다.

Performance 탭

서버가 제공하는 각 도구(Tool)의 성능 지표를 테이블과 차트로 확인할 수 있습니다.

좌측 — 도구별 성능 테이블:

우측 — 30일 추이 차트:

• Uptime (30d): 일별 가동 상태를 색상 바 차트로 표시 (초록=정상, 빨강=장애)
• Latency (30d): 응답 시간 추이를 꺾은선 그래프로 표시

💡 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 서버를 자체 애플리케이션에 프로그래밍 방식으로 통합하는 방법을 안내합니다.

좌측에는 Create API key 버튼과 Manage Connections 링크가 제공되며, 우측에 선택한 서브 탭에 따른 코드 스니펫이 표시됩니다.

📝 n8n 사용자에게 API 탭은 참고용입니다n8n에서는 MCP Client Tool의 Endpoint URL로 연결하므로 API 탭의 코드를 직접 사용하지는 않습니다. 다만, MCP 서버를 자체 앱에 통합하려는 개발자에게는 매우 유용한 정보입니다.

n8n에서 외부 MCP 서버 연결하기

Smithery에서 찾은 MCP 서버를 n8n AI Agent에 연결하는 방법은 [[Day22_05.2.1_MCP_클라이언트_노드_사내_업무_도우미_만들기|5.2.1]]에서 배운 MCP Client Tool 사용법과 동일합니다.

STEP 6: MCP Client Tool 추가

1. AI Agent 노드 하단의 ==Tool== 커넥터를 클릭하여 MCP Client Tool을 추가합니다.
2. MCP Client Tool 설정에서 Endpoint URL에 Smithery에서 복사한 Connection URL을 붙여넣습니다.
3. Authentication을 설정합니다.

4. Tools to Include를 설정합니다 (기본값 All 권장).

![[그림부록09-6.png]] [그림부록09-6] n8n MCP Client Tool에서 외부 MCP 서버 연결 설정

📝 여러 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으로 전달하세요.

정리하며

이 부록의 핵심을 정리하면 다음과 같습니다.

1. Smithery.ai는 MCP 마켓플레이스: 7,300개 이상의 MCP 서버를 탐색하고, Connection URL을 바로 복사해 n8n에 연결할 수 있습니다.
2. Remote 배지 확인 필수: n8n은 HTTP 기반 방식(Streamable HTTP / SSE)만 지원하므로, 서버 상세 페이지에서 Remote 배지가 있는 서버만 사용 가능합니다.
3. Performance 탭으로 안정성 판단: Uptime은 95% 이상, Latency는 2초 이내가 안정적입니다. 호출 횟수와 함께 확인하세요.
4. Connect 섹션의 URL만 복사: Agents/Humans 탭은 다른 클라이언트용 설치 가이드이며, n8n에서는 Get connection URL 필드의 URL만 사용합니다.
5. 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 설정

자주 하는 실수와 해결법

💡 다음 단계: 한국 서비스(네이버 쇼핑·검색·뉴스 등)와 연동하려면 네이버 개발자센터에서 별도 API 키를 발급해야 합니다. 다음으로 [[부록10_네이버_개발자센터_API_연동_가이드|부록 10. 네이버 개발자센터 API 연동 가이드]]를 참고하세요.