n8n MCP 서버·클라이언트 연동 완전정리: 워크플로우를 AI 에이전트 도구로 노출하는 법 (2026)

n8n으로 자동화를 짜다 보면 “이 워크플로우를 클로드 데스크톱한테 그냥 시키면 안 되나” 싶은 순간이 옵니다. 반대로 노션·리니어처럼 이미 MCP 서버를 제공하는 도구를, n8n 워크플로우 안에서 API 연동 코드 없이 그대로 불러 쓰고 싶을 때도 있고요. 결론부터 말하면 둘 다 됩니다—n8n은 2025년 4월 MCP 관련 노드를 처음 선보인 뒤, 2026년 들어 이 기능을 인스턴스 전체로 확장하며 정식 지원을 강화했습니다.

저희가 앞서 다룬 MCP 서버 연결 가이드(클로드 데스크톱·코드 설정법)는 “범용 MCP 클라이언트를 어떻게 설정하는가”를 다뤘습니다. 이번 글은 각도가 다릅니다—n8n은 그 클라이언트 역할뿐 아니라 MCP 서버 역할까지 동시에 겸하는 이중 구조이고, 이 글은 그 두 방향을 n8n의 실제 노드 이름·버전·파라미터 기준으로 다룹니다.

범위 다루는 대상
MCP 서버 연결 가이드(이전 글) 범용 MCP 클라이언트 클로드 데스크톱·코드 자체의 설정 화면
이 글 n8n 전용, 서버+클라이언트 양방향 n8n의 MCP Server Trigger·MCP Client Tool 노드 레벨 설정
n8n MCP 서버 vs 클라이언트, 두 방향

핵심 체크리스트(TL;DR)

  • n8n을 MCP 서버로 쓰려면 워크플로우 설정의 ‘Available in MCP’ 토글(간단) 또는 MCP Server Trigger 노드(세밀한 제어) 중 하나를 씁니다.
  • n8n을 MCP 클라이언트로 쓰려면 AI Agent 노드에는 MCP Client Tool 노드를 연결합니다—2026년 최신 버전 기준 전송 방식은 Streamable HTTP가 기본이고, SSE는 공식적으로 ‘Deprecated’ 표시가 붙었습니다.
  • 이 글 중간의 “직접 확인해 보니” 섹션에 n8n 오픈소스 저장소의 노드 정의 코드를 직접 읽고 필드명을 하나씩 대조해 만든 실제 임포트용 워크플로우 JSON 예시를 그대로 실었습니다.

시작 전에 준비할 것

MCP 관련 노드 자체는 n8n 1.88.0(2025-04-10 배포)부터 셀프호스트 커뮤니티 에디션을 포함한 모든 에디션에 기본 내장돼 있습니다—별도 유료 플랜이나 추가 설치가 필요 없습니다. 다만 이 글에서 다루는 인스턴스 전체 MCP 서버 기능(뒤에서 설명할 ‘Available in MCP’ 토글)과 2026-05-19 추가된 원클릭 연결 기능까지 쓰려면 최신 버전(이 글 작성 시점 최신 안정 버전은 2.34.1, 2026-08-05 배포)으로 업데이트해두는 걸 권장합니다.

n8n 공식 사이트 MCP Server Trigger 통합 페이지 실제 화면
  • n8n 인스턴스: 저희가 이전에 정리한 n8n 설치 방법 총정리(npx·Docker·클라우드) 중 어떤 방식이든 상관없습니다. 다만 MCP 서버로 쓰려면 외부(클로드 데스크톱 등)에서 접속 가능한 URL이 있어야 하므로, 로컬 PC에서만 돌리는 경우 ngrok·Cloudflare Tunnel 같은 터널링이 추가로 필요합니다. n8n 클라우드나 도메인이 연결된 서버라면 이 단계는 생략됩니다.
  • MCP를 지원하는 AI 클라이언트: 클로드 데스크톱, 클로드 코드, 커서(Cursor) 등. 이 글은 가장 보편적인 클로드 데스크톱 기준으로 설명합니다.
  • 외부 MCP 서버(선택): n8n을 클라이언트로 쓰려면 연결할 대상 MCP 서버의 접속 URL과 인증 정보(토큰 등)가 필요합니다.

STEP 1. n8n을 MCP 서버로 만들기 — 워크플로우를 AI 에이전트 도구로 노출

n8n을 MCP 서버로 노출하는 방법은 두 가지입니다. 공식 문서 기준으로 정리하면 다음과 같습니다.

방법 A. ‘Available in MCP’ 토글 (가장 간단)

  1. 워크플로우 편집기 우측 상단의 ‘…’ 메뉴 → SettingsAvailable in MCP 토글을 켭니다(워크플로우 목록 카드의 ‘Enable MCP access’ 메뉴로도 동일하게 처리할 수 있습니다).
  2. 인스턴스 전체 설정은 Settings > Instance-level MCP 페이지에서 관리합니다. 이 화면은 n8n 2.33.0(2026-07-28 배포)에서 ‘Connect a client’ 가이드 대화상자와 노출된 워크플로우 요약, 연결된 클라이언트 목록으로 UI가 전면 개편됐습니다.
  3. n8n 2.34.0부터는 워크플로우뿐 아니라 Agents(에이전트)도 별도 항목으로 MCP에 노출할 수 있습니다.

이미 만들어둔 워크플로우(예: Gmail 트리거로 시작하는 자동응대 워크플로우)를 그대로 노출하고 싶을 때 가장 빠른 방법입니다. 저희가 이전에 정리한 n8n 이메일 자동응대 워크플로우 같은 기존 자동화도, 트리거를 바꾸지 않고 이 토글만 켜면 클로드가 직접 실행시킬 수 있는 도구가 됩니다.

방법 B. MCP Server Trigger 노드 (세밀한 제어)

워크플로우 하나를 통째로 노출하는 대신, 특정 도구 묶음만 별도 엔드포인트로 쪼개 노출하고 싶다면 MCP Server Trigger 노드(내부 노드명 mcpTrigger, 최신 버전 2.1)를 씁니다.

  • 연결 방식: 일반 트리거와 달리 Tool 노드(예: Call n8n Workflow Tool)하고만 연결됩니다. 이 노드에 연결된 도구만 클라이언트에 노출됩니다.
  • Path: 기본값은 빈 값이고 플레이스홀더로 ‘webhook’이 표시되며, 필요하면 직접 지정할 수 있습니다(필수 항목).
  • Authentication: None·Bearer Auth·Header Auth 세 가지에 더해, 버전 2 이상에서는 ‘n8n User Auth (OAuth2)’—호출하는 사람이 n8n 계정으로 로그인 동의를 하게 만드는 방식—까지 네 번째 옵션으로 추가됩니다. Bearer Auth는 httpBearerAuth, Header Auth는 httpHeaderAuth 자격 증명을 각각 요구합니다.
  • Instructions(선택): 클라이언트가 접속할 때 함께 전달되는 안내문 필드로, MCP를 지원하는 클라이언트는 이걸 시스템 프롬프트에 반영합니다. 도구가 여러 개일 때 “어떤 순서로 어떤 도구를 써야 하는지”를 여기에 적어두면 에이전트가 더 정확하게 호출합니다.
  • Test URL / Production URL: ‘Listen for Test Event’로 활성화하는 테스트용 URL과, 워크플로우를 Activate(발행)해야 열리는 운영용 URL이 따로 생깁니다.
  • 전송 방식: Server-Sent Events(SSE)와 Streamable HTTP 두 가지를 지원합니다(로컬 프로세스 실행 방식인 stdio는 지원하지 않습니다).

저희가 앞서 다룬 n8n 보안 설정법 글에서 강조했던 것과 같은 이유로, 외부에 열리는 엔드포인트는 Authentication을 ‘None’으로 두지 말 것을 권합니다—n8n 공식 코드 주석에도 “트리거 URL은 기본적으로 공개 노출되니, 사용자가 명시적으로 요청할 때만 인증을 건다”는 안내가 달려 있을 정도로 기본값이 ‘None’이라는 점을 그대로 두면 안 됩니다.

STEP 2. 클로드 데스크톱 등 MCP 클라이언트 연결하기

클로드 데스크톱 강점: n8n 워크플로우를 도구로 바로 실행

Settings > Instance-level MCP 화면의 Connect 버튼을 누르면 두 가지 연결 방식을 고를 수 있습니다.

  • OAuth(권장): 클라이언트 목록에서 클로드 데스크톱을 선택하고 ‘One-click setup’을 실행하거나, Server URL만 복사해 클라이언트 쪽 설정에 붙여넣습니다.
  • API 키: 자동 생성된 토큰과 연결용 Configuration JSON을 그대로 복사해 클라이언트 설정 파일에 붙여넣습니다.

둘 다 n8n 쪽 화면이 필요한 설정값을 그대로 만들어주기 때문에, 클로드 데스크톱의 커넥터 설정 화면에 URL과 토큰만 옮겨 붙이면 됩니다(세부 클라이언트 설정 화면 자체는 저희가 이전에 다룬 MCP 서버 연결 가이드를 참고하시면 됩니다). MCP Server Trigger 노드로 만든 개별 엔드포인트를 연결할 때도 같은 방식으로, 그 노드가 발급한 Production URL과 인증 정보를 클라이언트에 등록하면 됩니다.

STEP 3. n8n 워크플로우 안에서 외부 MCP 서버 호출하기 (클라이언트 역할)

MCP Client Tool 노드로 외부 도구 불러오기

반대 방향—외부 MCP 서버가 제공하는 도구를 n8n 워크플로우 안에서 쓰는 경우—에는 MCP Client Tool 노드(내부 노드명 mcpClientTool)를 AI Agent 노드에 연결합니다. 이 노드는 버전이 올라가며 필드가 눈에 띄게 바뀌었습니다.

  • 버전 1: SSE Endpoint 필드 하나로 연결 주소를 받고, 전송 방식은 SSE로 고정됩니다.
  • 버전 1.1 이상: 필드명이 Endpoint로 바뀌고, Server Transport 옵션이 새로 생겨 ‘HTTP Streamable’ 또는 ‘Server Sent Events (Deprecated)’ 중 고를 수 있습니다—n8n 소스 코드에 SSE 옵션 이름 자체에 ‘Deprecated’라는 표기가 이미 붙어 있어, 새로 워크플로우를 짠다면 HTTP Streamable을 기본으로 쓰는 게 맞습니다.
  • 버전 1.2 이상: Authentication 옵션이 None·Bearer Auth·Header Auth 세 가지에서 MCP OAuth2·Multiple Headers Auth 두 가지가 추가돼 다섯 가지로 늘었습니다. 각 옵션은 httpBearerAuth·httpHeaderAuth·mcpOAuth2Api·httpMultipleHeadersAuth 자격 증명과 1:1로 대응합니다.

공통 설정으로는 Tools to Include가 있습니다—All(전체 노출) / Selected(선택한 도구만, ‘Tools to Include’ 파라미터 활성화) / All Except(특정 도구만 제외, ‘Tools to Exclude’ 파라미터 활성화) 세 가지 중 선택합니다. 에이전트 없이 워크플로우의 정해진 한 단계로만 MCP 도구를 실행하고 싶다면 MCP Client 노드를 대신 씁니다.

여기서 2026년 들어 눈에 띄게 편해진 부분이 있습니다. n8n 2.22.0(2026-05-19 배포)부터는 ‘Connect to MCP servers with less setup’라는 이름으로, Apify·Linear·monday.com·Notion·PostHog 등 공식 MCP 레지스트리에 등록된 인기 서비스는 URL을 직접 입력하지 않고 노드 패널에서 서비스 이름을 고른 뒤 인증만 완료하면 바로 에이전트 도구로 쓸 수 있습니다. 이 기능은 내부적으로 @n8n/mcp-registry.<서비스 슬러그> 형태의 전용 노드로 동작하며, 인증도 별도 토큰 발급 없이 mcpOAuth2Api OAuth2 한 가지로 통일돼 있습니다—목록에 없는 서비스(자체 구축한 MCP 서버 등)는 기존처럼 Endpoint를 수동으로 입력하면 됩니다.

직접 확인해 보니

이 노트북에는 n8n 인스턴스와 클로드 데스크톱을 나란히 켜고 실제로 연결해볼 환경이 갖춰져 있지 않습니다. 그래서 화면 캡처 대신, 마케팅 문서나 다른 블로그 글을 옮겨 적는 수준에 머물지 않기 위해 n8n의 오픈소스 저장소(n8n-io/n8n)에서 MCP 관련 노드의 실제 TypeScript 소스 코드를 직접 열어 아래 세 파일의 properties·credentials 정의를 한 줄씩 읽고 이 글의 필드명·옵션값과 대조했습니다.

  • packages/@n8n/nodes-langchain/nodes/mcp/McpTrigger/McpTrigger.node.ts
  • packages/@n8n/nodes-langchain/nodes/mcp/McpClientTool/McpClientTool.node.ts
  • packages/@n8n/nodes-langchain/nodes/mcp/shared/descriptions.ts

이 대조 과정에서 공식 문서 요약만 봤다면 놓쳤을 세 가지를 확인했습니다. ①MCP Server Trigger의 인증 옵션에 ‘n8n User Auth (OAuth2)’가 버전 2부터 추가돼 있다는 것, ②MCP Client Tool의 전송 방식 옵션에서 SSE가 코드 레벨에서 이미 ‘Deprecated’로 표기돼 있다는 것, ③2.22.0의 원클릭 연결 기능이 내부적으로 mcpRegistryClientTool이라는 별도 노드로 구현돼 있고 인증은 mcpOAuth2Api 하나로 고정돼 있다는 것입니다. 이 세 가지는 이 글을 쓰기 전 검토한 어떤 블로그 글에서도 언급되지 않았습니다.

이렇게 확인한 필드명을 그대로 채워, 실제로 n8n 편집기에 임포트할 수 있는 형태의 워크플로우 JSON을 직접 작성했습니다—블로그 운영 리포트를 만드는 서브워크플로우 하나를 MCP 도구로 노출하는 예시입니다. 이 노트북에 n8n이 설치돼 있지 않아 실제 임포트 버튼을 눌러 화면으로 확인하지는 못했다는 점은 밝혀둡니다. 다만 아래 값들은 추측이 아니라 위 소스 코드에 적힌 필드명·기본값·버전 조건을 그대로 옮긴 것입니다.

{
  "name": "블로그 리포트 MCP 서버",
  "nodes": [
    {
      "id": "b1f2a3c4-1111-4a4a-8b8b-mcptrigger001",
      "name": "MCP Server Trigger",
      "type": "@n8n/n8n-nodes-langchain.mcpTrigger",
      "typeVersion": 2.1,
      "position": [460, 300],
      "webhookId": "d4e5f6a7-2222-4b4b-9c9c-webhook00001",
      "parameters": {
        "path": "blog-report-tools",
        "authentication": "headerAuth",
        "instructions": "이 서버는 블로그 운영 리포트 도구를 제공합니다. generate_weekly_report 도구를 호출하면 최신 GA4·GSC 데이터를 정리한 리포트를 반환합니다."
      },
      "credentials": {
        "httpHeaderAuth": { "id": "1", "name": "n8n MCP Header Auth" }
      }
    },
    {
      "id": "c2e3b4d5-3333-4c4c-8d8d-toolworkflow01",
      "name": "generate_weekly_report",
      "type": "@n8n/n8n-nodes-langchain.toolWorkflow",
      "typeVersion": 2.2,
      "position": [460, 520],
      "parameters": {
        "name": "generate_weekly_report",
        "description": "이번 주 블로그 트래픽·색인 현황을 정리한 리포트를 생성한다",
        "source": "database",
        "workflowId": {
          "__rl": true,
          "value": "여기에 실제 리포트 서브워크플로우 ID",
          "mode": "list"
        }
      }
    }
  ],
  "connections": {
    "generate_weekly_report": {
      "ai_tool": [[{ "node": "MCP Server Trigger", "type": "ai_tool", "index": 0 }]]
    }
  }
}

실제로 쓸 때는 workflowId.value에 리포트를 만드는 서브워크플로우 ID를 넣고, httpHeaderAuth 자격 증명을 n8n Credentials 화면에서 미리 만들어 연결해야 합니다. Header 이름은 보통 Authorization, 값은 Bearer <직접 정한 토큰> 형태로 채우면 됩니다.

실전 활용 아이디어

자동화 워크플로우를 AI 팀 도구로 승격하기

MCP 클라이언트·서버 기능을 니치(자동화·부업) 관점에서 어떻게 써먹을 수 있을지 세 가지로 좁혀봤습니다.

  • 기존 자동화를 대화형 도구로 승격: 저희가 앞서 다룬 n8n으로 SNS 자동 포스팅하기, n8n 이메일 자동응대 만들기 같은 워크플로우에 ‘Available in MCP’ 토글만 켜면, 슬랙 봇이나 별도 UI 없이도 “오늘 자 SNS 초안 세 개 만들어줘”처럼 클로드에게 자연어로 시킬 수 있는 도구가 됩니다.
  • 여러 SaaS를 한 곳에서 조율하는 허브: 노션·리니어처럼 이미 MCP 서버를 제공하는 도구를 MCP Client Tool 노드로 n8n의 AI Agent에 붙이고, 그 에이전트를 다시 MCP Server Trigger로 노출하면, 클로드 하나에서 “리니어 티켓 만들고 노션에도 기록해줘”처럼 여러 서비스를 오가는 지시를 한 번에 처리하는 중계 허브를 만들 수 있습니다.
  • 반복 리포트를 ‘도구 상품’으로 판매: 위 JSON 예시처럼 클라이언트의 반복 리포트 작성·데이터 정리 워크플로우를 MCP로 노출해두면, 클라이언트는 별도 대시보드 없이 자신의 클로드 데스크톱에서 “이번 주 리포트 만들어줘”라고 시키기만 하면 됩니다. n8n 워크플로우 예제 글에서 소개했던 시나리오들도 이런 방식으로 도구화할 수 있는 후보입니다.

자주 묻는 질문

‘Available in MCP’ 토글과 MCP Server Trigger 노드 중 뭘 써야 하나요?

이미 있는 워크플로우를 손대지 않고 그대로 노출하고 싶다면 토글이 더 빠릅니다. 특정 도구 묶음만 별도 엔드포인트·별도 인증으로 쪼개서 노출하거나, Instructions 필드로 클라이언트에게 사용법을 안내하는 등 세밀하게 제어하고 싶다면 MCP Server Trigger 노드를 별도로 구성하는 쪽이 맞습니다.

SSE 전송 방식은 이제 못 쓰나요?

당장 막힌 건 아닙니다. MCP Client Tool 노드 1.1 버전 이상의 소스 코드를 보면 ‘Server Sent Events (Deprecated)’라는 이름 그대로 여전히 선택은 가능하지만, 공식적으로 지원 종료 예정이라는 표시가 붙어 있습니다. 새로 워크플로우를 만든다면 기본값인 HTTP Streamable을 쓰는 걸 권합니다.

무료 셀프호스트 버전에서도 MCP 기능을 쓸 수 있나요?

네. MCP Server Trigger·MCP Client Tool·MCP Client 노드는 n8n 1.88.0(2025-04-10)부터 클라우드·엔터프라이즈뿐 아니라 무료 셀프호스트 커뮤니티 에디션에도 기본 내장돼 있습니다. 다만 외부에서 접속 가능한 URL을 확보하는 일(터널링 등)은 별도로 준비해야 합니다.

MCP로 노출한 워크플로우, 보안은 어떻게 챙기나요?

MCP Server Trigger 노드는 기본값이 ‘인증 없음(None)’이므로 Bearer Auth·Header Auth·n8n User Auth(OAuth2) 중 하나를 직접 켜야 합니다. 인스턴스 레벨 MCP도 API 키·OAuth 인증을 거쳐야 클라이언트가 연결됩니다. 인증 없이 URL만 알면 누구나 워크플로우를 실행할 수 있는 상태로 두지 않는 것이 핵심입니다.

핵심 요약

1. n8n을 MCP 서버로 쓰려면 기존 워크플로우는 ‘Available in MCP’ 토글로, 세밀한 제어가 필요하면 MCP Server Trigger 노드(버전 2.1, 인증 4종·Instructions 필드 포함)로 노출하고, 클로드 데스크톱은 Instance-level MCP의 Connect 화면(OAuth 또는 API 키)으로 붙입니다.
2. n8n을 MCP 클라이언트로 쓰려면 MCP Client Tool 노드를 쓰되, 버전 1.1부터 전송 방식이 HTTP Streamable 기본·SSE는 Deprecated로 바뀌었고, 버전 1.2부터 MCP OAuth2·Multiple Headers Auth가 추가된 점을 확인하고 써야 합니다.
3. n8n 오픈소스 코드까지 직접 대조해 만든 위 JSON 예시처럼, 기존에 만들어둔 리포트·자동응대 워크플로우를 그대로 MCP로 노출하면 별도 UI 없이도 대화형 도구로 승격시킬 수 있습니다.


이 글은 n8n의 MCP 서버·클라이언트 관련 공식 문서뿐 아니라 오픈소스 저장소의 실제 노드 코드까지 직접 대조하며 정리한 운영진이 작성했습니다. 실제로 검증한 범위와 그렇지 못한 부분을 구분해서 전달하려 합니다.
오류나 개선할 점을 발견하시면 연락처로 알려주세요.

Leave a Comment