n8n MCP 활용 가이드, Claude Desktop으로 n8n 워크플로 만드는 법

n8n으로 워크플로 만들 때마다 노드 검색하고 문서 보고 다시 캔버스 와서 연결하느라 시간 다 가는 적 있으시죠?

n8n-MCP는 이 과정을 Claude 같은 AI 도우미에게 맡기게 해 주는 오픈소스 MCP 서버예요. 오늘은 설치법, n8n API 키 발급, Claude Desktop 설정 파일, 실전 프롬프트 5가지, 보안 설정까지 2026년 10월 15일 공식 문서 기준으로 정리할게요.

1. n8n-MCP가 뭐고 어떻게 동작하나요

n8n-MCP는 Anthropic이 공개한 MCP(Model Context Protocol) 표준으로 만든 오픈소스 서버예요. GitHub 저장소 czlonkowski/n8n-mcp에 MIT 라이선스로 공개돼 있고, README는 n8n 노드 3,135개(코어 840개, 커뮤니티 2,295개)의 문서·속성·동작 정보를 AI 도우미에게 제공한다고 설명해요.

평소 n8n 워크플로 만드는 흐름:

1. 캔버스에서 + 버튼
2. 노드 검색 (예: "Google Sheets")
3. Action 선택 (Append row? Update? Read?)
4. credential 연결
5. 매핑 입력 (어떤 컬럼에 어떤 값)
6. 다음 노드 추가하고 1~5 반복

n8n-MCP 흐름:

1. Claude Desktop에 자연어 입력: "구글 시트에 새 행 들어오면 슬랙 #sales 채널에 알림"
2. Claude가 search_nodes·get_node 도구로 필요한 노드 정보를 찾아 워크플로를 구성
3. validate_workflow로 검증한 뒤 n8n_create_workflow로 n8n에 생성 (n8n API 설정 필요)
4. 사용자는 캔버스 열어서 확인·수정

핵심은 노드 검색·매핑·문서 확인을 Claude가 도구로 대신 한다는 거예요. README 기준으로 노드 속성은 99%, 노드 동작은 66.5%, 공식 문서는 86%를 다루고 있어서 Claude가 노드 옵션을 찾아볼 수 있어요.

2. 설치: Claude Desktop과 n8n 연결

사전 준비

• Claude Desktop (요금제는 claude.com 가격 페이지에서 확인)
• n8n 인스턴스: 셀프호스팅 Community Edition 또는 n8n API를 쓸 수 있는 유료 Cloud 요금제 (n8n 공식 문서 기준, n8n API는 Cloud 무료 체험 기간에 쓸 수 없어요)
• n8n API 키

n8n API 키 발급

1. n8n에 로그인
2. Settings > n8n API로 이동
3. Create an API key 선택
4. 이름(Label)과 만료 기간(Expiration)을 정해요. Enterprise 요금제라면 Scopes로 키가 할 수 있는 일을 좁힐 수 있어요
5. 만든 키를 복사해 안전한 곳에 보관

Claude Desktop 설정

설정 파일 경로:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 윈도: %APPDATA%\Claude\claude_desktop_config.json

추가할 JSON 블록(n8n-MCP 셀프호스팅 문서의 npx 예시):

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

n8n-MCP 문서는 Claude Desktop에서 MCP_MODE를 stdio로 두는 설정이 반드시 필요하다고 적어요. 빠지면 화면에 JSON 파싱 오류가 난다고 해요. 저장한 뒤 Claude Desktop을 다시 시작하세요.

첫 테스트

Claude한테 "현재 연결된 n8n 인스턴스의 워크플로 목록 보여줘"라고 물어보세요. 응답이 없으면 n8n_health_check 도구로 연결 상태를 확인하고, API 키나 URL 오타를 점검하세요.

3. 실전 케이스 1: RSS 피드 → 노션 자동 정리

Claude한테 던지는 프롬프트:

n8n에 워크플로 만들어줘.
- 트리거: RSS Feed 노드, 매일 09:00 KST
- 피드: https://blog.example.com/rss
- 처리: 새 항목만 필터, 본문 200자 요약 (OpenAI 노드, gpt-6-luna)
- 저장: Notion Database 'AI 뉴스'에 행 추가
  컬럼: 제목, URL, 요약, 게시일
이름은 "RSS to Notion Daily AI"

모델은 OpenAI가 비용에 민감한 대량 작업용으로 소개하는 GPT-6 Luna(gpt-6-luna)를 예로 넣었어요. Claude가 워크플로를 만들면 캔버스에서 열어 마무리하세요.

• Notion·OpenAI credential 연결
• Notion Database ID 입력
• Manual Test 클릭 → 정상 작동 확인

4. 실전 케이스 2: Webhook 알림 라우팅

복잡한 분기 로직도 자연어로:

n8n 워크플로:
- Webhook 트리거 (POST /alert)
- 들어오는 JSON에 "severity" 필드 있음
- severity == "critical" → Slack #incidents + PagerDuty 호출
- severity == "warning" → Slack #ops-alerts만
- severity == "info" → Notion 'Logs' 데이터베이스 행 추가만
- 모든 케이스에 ms-since-trigger 측정해서 응답 헤더에 X-Process-Time 포함

값이 세 가지라 Switch 노드로 나누는 구성이 맞아요. IF 노드를 쓸 때는 TRUE·FALSE 두 출력 중 어디에 연결할지 branch 값을 꼭 지정하라고 n8n-MCP README가 경고해요. PagerDuty는 n8n에 기본 노드가 있어서 따로 설치하지 않아도 돼요.

5. 실전 케이스 3: 구글 시트 CRM → Slack 영업 알림

Make로 구글 시트 CRM 자동화에서 Make 버전을 다뤘는데, n8n 버전은 코드 노드 활용이 더 자유로워요.

Claude 프롬프트:

구글 시트 'Leads'에 새 행 들어오면 슬랙 #sales-new에 카드 메시지 보내기.
- 메시지 포맷: 이름·이메일·회사·예상 매출
- 예상 매출 1억원+ → 메시지 앞에 🔥 이모지
- 예상 매출 5천만원+ → 🟡
- 그 이하 → 일반
- 매출은 시트의 "expected_revenue" 컬럼 (숫자)

Code 노드(JavaScript)로 이모지 분기를 넣고 Slack Block Kit 메시지를 꾸미는 구성을 요청할 수 있어요. 다만 n8n-MCP README의 권장 지침은 Code 노드를 꼭 필요할 때만 쓰고 표준 노드를 먼저 쓰라고 해요. 이 예시라면 Switch나 IF 노드로 먼저 시도해 보세요.

6. 실전 케이스 4: n8n 워크플로 디버깅

이미 만들어둔 워크플로가 안 돌 때:

워크플로 ID 47번 실행 결과 보여주고, 마지막 실패 원인 분석해줘

Claude는 n8n_executions 도구로 실행 기록을 가져와서 이런 걸 정리해 줘요.

• 어느 노드에서 실패했는지
• 입력 데이터 어떻게 들어왔는지
• 에러 메시지 원문
• 원인 추론 (예: "Webhook 응답이 JSON 아니라 HTML이라 다음 노드의 JSON Parse 실패")
• 수정 제안 (예: "HTTP Response 노드 추가해서 status 200·content-type 확인")

흔한 오류는 n8n_autofix_workflow 도구로 자동 수정을 시도할 수도 있어요. 대시보드에서 execution을 하나씩 열어 보던 일을 대화로 옮기는 셈이에요.

7. 실전 케이스 5: 워크플로 일괄 백업·복제

여러 인스턴스 사이 워크플로 옮길 때:

프로덕션 인스턴스의 모든 활성 워크플로 export → 스테이징 인스턴스에 import
단 webhook URL과 credential 이름만 환경에 맞게 변환

인스턴스마다 n8n-MCP 서버를 따로 등록해 두면 한 대화에서 양쪽을 다룰 수 있어요. n8n-MCP는 워크플로를 바꾸기 전에 스냅샷을 남기고 n8n_workflow_versions 도구로 되돌릴 수 있게 해 줘서, 환경 분리나 복구 준비에도 쓸 만해요.

n8n + Claude API 자동화 5단계는 워크플로 안에서 Claude API를 호출하는 패턴이고, 이번 글은 워크플로 자체를 Claude로 만드는 메타 패턴이에요.

쓰기 전에 알아 둘 함정 5가지

1. 검증 경고 무시: README는 AI 결과를 예측할 수 없다고 경고해요. validate_workflow에서 나온 오류는 고치고 나서 import 하세요.
2. OAuth credential: OAuth를 쓰는 credential은 브라우저에서 계정 연결 동의를 거쳐야 하니 n8n 화면에서 직접 연결하세요.
3. API 키 노출 위험: n8n API 키가 평문으로 Claude Desktop 설정 파일에 저장돼요. 윈도는 사용자 폴더 권한을 확인하고, 공용 PC에서는 쓰지 마세요.
4. 큰 워크플로: 노드가 많은 워크플로는 sub-workflow로 나누고 단계별로 요청하세요. 고칠 때는 n8n_update_partial_workflow처럼 바뀐 부분만 반영하는 도구가 있어요.
5. 버전 호환: n8n-MCP 일부 도구는 n8n 2.19 이상, 2.30 이상처럼 필요한 n8n 버전이 따로 있어요. 셀프호스팅 사용자는 README에서 요구 버전을 확인한 뒤 업그레이드하세요.

n8n-MCP 시작 전 알아두면 좋은 5가지 사실

1. MCP 표준은 Anthropic이 만들었지만 오픈

MCP(Model Context Protocol)는 Anthropic이 2024년 11월 25일 오픈소스로 공개한 표준이에요. AI 도우미를 데이터가 있는 시스템(콘텐츠 저장소, 업무 도구, 개발 환경)에 잇는 방식을 하나로 맞추려는 것이라, 한 번 익히면 다른 MCP 서버에도 바로 응용할 수 있어요. 호스트, 클라이언트, 서버 같은 기본 용어가 낯설다면 MCP란 무엇인지 쉽게 풀어 쓴 글을 먼저 읽어 보세요.

2. n8n에도 MCP 기능이 따로 있어요

n8n은 MCP Server Trigger 노드로 n8n의 도구와 워크플로를 MCP 클라이언트에 내보낼 수 있어요. 또 설정의 Instance-level MCP를 켜면 n8n 인스턴스 자체에 MCP로 접속할 수 있고, n8n-MCP의 일부 도구는 이 기능의 토큰(N8N_MCP_ACCESS_TOKEN)을 추가로 요구해요. n8n-MCP는 n8n 공식 기능과 별개인 커뮤니티 오픈소스 서버라는 점을 구분해 두세요.

3. 여러 MCP 클라이언트 지원

n8n-MCP 문서는 Claude Desktop, Claude Code, VS Code, Cursor, Windsurf, Codex, Antigravity 설정 방법을 안내해요. Claude 요금은 2026년 10월 15일 claude.com 가격 페이지 기준 Pro가 월 20달러(연간 결제 시 월 17달러), Max가 월 100달러부터예요.

4. 노드 커버리지가 넓음

README 기준으로 코어 노드 840개와 커뮤니티 노드 2,295개 정보가 들어 있고, 워크플로 템플릿 2,352개도 검색할 수 있어요. search_nodes 도구에 source 옵션을 주면 커뮤니티 노드만 따로 찾을 수 있어요.

5. 워크플로 검증을 단계별로

README는 validate_node의 빠른 점검(minimal)과 전체 점검(full), 그다음 validate_workflow로 연결·표현식까지 보는 순서를 권해요. 오류가 나오면 import 전에 수정하세요.

n8n-MCP 보안 베스트 프랙티스 7가지

API 키 + 워크플로 노출 위험 회피.

1. n8n 별도 인스턴스 분리

프로덕션과 분리된 별도 n8n 인스턴스에서 MCP를 쓰세요. README도 운영 워크플로를 AI로 직접 고치지 말고 개발 환경에서 먼저 시험하라고 해요.

2. 쓰기 도구 끄기

n8n-MCP는 DISABLED_TOOLS 환경 변수로 쓰기·삭제 도구를 통째로 끄는 읽기 전용 배포 방법을 안내해요. Enterprise 요금제라면 n8n API 키의 Scopes도 읽기 위주로 좁히세요.

3. 운영 credential 분리

결제·OAuth 같은 운영 credential은 MCP를 연결한 인스턴스에 두지 마세요.

4. Claude 학습 설정 확인

Free·Pro·Max 같은 개인 요금제는 개인정보(Privacy) 설정에서 모델 개선(Model Improvement)을 허용한 경우 대화를 학습에 쓸 수 있어요. Anthropic 안내에 따르면 원격·로컬 MCP 서버에서 가져온 원본 내용은 학습 데이터에 들어가지 않지만, 대화에 직접 붙여 넣은 내용은 들어갈 수 있어요. 원하지 않으면 그 설정을 꺼 두세요.

5. 민감 워크플로 분리

의료·금융 데이터 처리 워크플로는 별도 n8n 인스턴스에 두고 MCP를 연결하지 마세요.

6. IP 제한

n8n을 셀프호스팅한다면 n8n API에 접속할 수 있는 IP를 제한하세요.

7. 정기 점검

n8n executions 로그를 주기적으로 확인하세요. n8n-MCP의 n8n_audit_instance 도구는 n8n 내장 감사 API와 워크플로 점검을 묶어 보안 점검을 해 줘요.

한국 사용자 자주 묻는 추가 질문 6가지

Q1. 한국어로 워크플로 만들 수 있어요?

네. Anthropic은 현재 Claude 모델이 다국어를 지원한다고 안내해요. 노드 종류와 옵션 이름은 n8n 원래 영문 그대로 쓰이고, 노드 이름이나 메모를 한국어로 달아 달라고 요청할 수 있어요.

Q2. 한국 SaaS(카카오·네이버·토스) 통합도 돼요?

전용 노드가 없는 서비스는 n8n의 HTTP Request 노드로 해당 서비스의 API를 직접 호출하면 돼요. search_nodes 도구로 커뮤니티 노드를 찾을 수도 있지만, 커뮤니티 노드는 직접 검증한 뒤 쓰세요.

Q3. n8n Cloud vs 셀프호스팅 어디가 좋나요?

n8n-MCP로 워크플로를 만들려면 n8n API가 필요한데, Cloud는 무료 체험에서 n8n API를 쓸 수 없어서 유료 요금제가 필요해요. 셀프호스팅 Community Edition은 무료예요. n8n 공식 문서는 Docker Compose 같은 설치 방법을 안내하고, Hetzner를 비용 효율적인 유럽 호스팅으로 소개해요.

Q4. 회사 보안 정책상 OpenAI·Anthropic 차단인데?

n8n-MCP 사용 자체가 막혀요. ① 회사 밖에서 개인 용도로 학습하고 회사에서는 수동으로 워크플로를 만들거나 ② 사내에서 허용된 MCP 클라이언트와 모델이 있는지 보안 담당자에게 먼저 확인하세요.

Q5. 셀프호스팅 n8n 보안은 어떻게 강화해요?

기본 5가지: ① SSL을 설정해 HTTPS로만 접속 (Caddy·nginx 리버스 프록시) ② 사용자 계정에 2단계 인증(2FA)을 켜고, 쓸 수 있다면 SAML·OIDC SSO 적용 ③ IP 화이트리스트 (사무실 IP만) ④ 정기 백업 (매일 cron) ⑤ n8n 버전 정기 업데이트. n8n 1.0부터는 사용자 관리가 필수가 되면서 BasicAuth 같은 다른 인증 방식은 지원이 끝났어요. n8n-MCP를 쓰지 않는 인스턴스라면 공개 API를 꺼 두는 것도 n8n 보안 문서가 권하는 방법이에요.

Q6. n8n-MCP 외에 비슷한 도구 있나요?

Make와 Zapier도 공식 MCP 서버(Make MCP server, Zapier MCP)를 제공해요. Pipedream도 Connect 제품에서 원격 MCP 서버를 제공(워크플로 자동화 제품인 Workflows는 신규 가입과 구독을 받지 않고 2027년 3월 31일에 종료한다고 공식 문서에 공지). n8n은 셀프호스팅 Community Edition을 무료로 쓸 수 있는 점이 달라요.

마무리: 오늘 바로 시작하기

오늘 당장 할 수 있는 5가지:

1. n8n 인스턴스 준비: 셀프호스팅 Community Edition 무료 (Cloud 무료 체험에서는 n8n API 불가)
2. n8n API 키 발급: Settings > n8n API > Create an API key
3. Claude Desktop 설정 파일에 MCP 서버 추가: 위 JSON 블록 복사
4. 첫 테스트: "내 워크플로 목록 보여줘"로 연결 확인
5. 보안 7가지 적용: 별도 인스턴스와 쓰기 도구 끄기부터 시작

n8n-MCP는 워크플로 자동화의 작성 단계를 AI에게 맡기는 메타 도구예요. 이미 n8n을 쓰고 있고 워크플로를 자주 만든다면 개발용 인스턴스에서 먼저 시험해 볼 만해요. Zapier vs Make vs n8n 2026 비교도 같이 보면 본인 환경에 n8n이 맞는지 결정에 도움 됩니다.