Claude가 n8n 전문가가 되다: 공식 n8n-MCP 튜토리얼

Praktycznie o AI 구독자 2,580명

요약

이 영상에서는 n8n 워크플로우를 생성·검증할 수 있도록 돕는 Model Context Protocol(MCP)인 n8n-MCP를 소개합니다. 실제 Claude 모델을 사용해 MCP 전·후의 워크플로우 생성 과정을 비교 시연하고, 오류 발생 시 자동으로 진단·수정하는 과정을 살펴봅니다. 이후 몇 분 안에 Node.js와 NPX를 활용해 GitHub에서 MCP를 설치·설정하는 방법을 자세히 안내합니다. 마지막으로 시스템 인스트럭션을 적용한 클라우드 프로젝트 구성과 다양한 활용 사례를 제안합니다.

주요 키워드

n8n-MCP n8n 워크플로우 Model Context Protocol AI 에이전트 Google Sheets Node.js NPX API 키 클라우드 데스크톱 시스템 인스트럭션

하이라이트

🔑 n8n-MCP는 AI 모델에 n8n 워크플로우 생성부터 검증까지 가능한 전문 지식을 부여합니다.
⚡️ 일반 AI는 n8n 워크플로우를 실무에 맞게 구성할 깊은 컨텍스트가 부족했습니다.
🌟 MCP 활성화 시 Claude는 도구 문서를 참조해 적합한 노드를 선택·설정하고 단계별로 검증합니다.
📌 오류가 생기면 최신 실행 기록을 조회해 부분 업데이트만으로 문제를 해결합니다.
🚀 Node.js와 NPX 기반의 간단한 설치 과정을 통해 몇 분 만에 MCP 기능을 사용할 수 있습니다.
🔄 클라우드 데스크톱 설정에 인스턴스 URL과 API 키를 추가하면 자동으로 n8n-MCP 도구가 활성화됩니다.
💡 클라우드 프로젝트에 시스템 인스트럭션을 추가해 AI 에이전트가 필요한 도구를 정확히 학습하도록 유도합니다.
📈 n8n-MCP는 워크플로우 자동화뿐 아니라 아이디어 브레인스토밍과 시스템 아키텍처 설계에도 활용할 수 있습니다.

용어 설명

n8n-MCP

Model Context Protocol로, AI 모델이 n8n 워크플로우 생성·검증 도구를 활용하도록 돕는 확장 기능

n8n

시각적 인터페이스 기반의 워크플로우 자동화 플랫폼

AI 에이전트

명령을 수행하고 자체 학습·수정을 하는 지능형 자동화 주체

NPX

Node.js 패키지를 다운로드 없이 즉시 실행할 수 있는 도구

시스템 인스트럭션

클라우드 프로젝트에 AI에게 사용할 도구와 절차를 사전에 안내하는 설정

n8n-MCP 개발자 Ramul Trunkovski가 등장해 Model Context Protocol의 개념을 소개합니다. AI 모델이 n8n 워크플로우를 작성·편집·업데이트할 수 있는 기능을 갖추는 과정을 간략히 설명합니다. 지금까지 AI가 n8n 워크플로우 생성을 제대로 수행하지 못했던 한계를 지적합니다.

[00:00] 라물 트룬코프스키가 n8n MCP 개발자로 자신을 소개하며, 이 도구가 Claude Desktop, Code, Cursor, Windsurf 등을 AI 에이전트로 변환하여 워크플로우를 자동으로 생성, 편집, 변경할 수 있게 해준다고 설명합니다. 기존 AI가 n8n 워크플로우 생성에 부족했던 지식과 컨텍스트 문제를 해결하는 게임체인저라고 강조합니다.

간단한 명령으로 매시간 해커 뉴스 기사를 가져와 구글 시트에 저장하는 워크플로우를 생성해봅니다. Claude(Opus 4) 모델로 시도했으나 설정 없이 생성된 워크플로우가 실행 오류를 일으키는 과정을 보여줍니다. 복사·붙여넣기만으로는 실제 작동하지 않는 문제를 강조합니다.

[00:54] 실제 데모를 시작하며 매시간 해커뉴스를 가져와서 새로운 것들만 Google 문서에 저장하는 워크플로우를 요청합니다. Claude Opus 4와 확장 사고 기능을 사용하여 작업을 수행하지만, 초기 시도에서는 워크플로우가 제대로 작동하지 않아 같은 지점에서 계속 실패합니다.

n8n-MCP를 활성화한 후 동일한 명령을 입력하며 도구 문서를 참조해 노드를 자동으로 선택·학습하는 과정을 시연합니다. 최신 n8n 버전의 노드 문서를 가져와 정확한 구성 방법을 파악합니다. 단일 노드 코드 생성 후 MCP 도구로 검증하는 단계도 선보입니다.

[01:59] n8n MCP를 활성화한 상태에서 동일한 지시사항을 다시 시도합니다. 이때 Claude는 먼저 MCP 도구들의 문서를 확인하고, 자동화에 필요한 노드들을 검색한 후 각 노드의 문서를 가져와 구성 방법을 학습합니다. 이 과정은 항상 최신 n8n 버전으로 업데이트되어 있어 구식 노드 문제를 방지합니다.

[02:51] 빌드 준비가 완료되면 제안된 구성을 검증하기 시작합니다. 단일 노드에 대한 코드를 생성하고 MCP 도구로 검증한 후, 전체 워크플로우와 노드 간 연결 및 구성을 검증합니다. 오류가 발견되면 MCP로부터 수정 사항에 대한 피드백을 받아 워크플로우를 수정하고 다시 검증하여 나중에 문제 해결이 필요하지 않도록 합니다.

[03:23] n8n 인스턴스가 연결되어 있고 정상인지 확인한 후, 인스턴스 내부에서 직접 워크플로우를 생성합니다. 이 과정에서는 복사 붙여넣기가 필요하지 않으며, 해커뉴스를 Google Sheets로 처리하는 워크플로우가 성공적으로 생성됩니다.

전체 워크플로우 연결과 설정을 전수 검증한 뒤 NA10 인스턴스에 직접 배포하는 과정을 설명합니다. 인스턴스 상태 확인 후 자동으로 워크플로우를 생성하고, 복사·붙여넣기 단계를 생략해 효율성을 높입니다. 완성된 워크플로우 ID와 기본 설정 안내를 제공합니다.

[03:43] 워크플로우 생성이 완료되고 해커뉴스에서 구글 시트로 데이터를 전송하는 워크플로우를 확인합니다. 구글 시트 설정을 위해 필요한 열들을 추가합니다.

[04:05] 워크플로우 실행 중 오류가 발생하지만, n8n MCP의 장점을 활용하여 Claude에게 문제 해결을 요청합니다. 최신 실행 결과를 분석하고 문제를 진단하도록 지시합니다.

실제 실행 중 오류가 발생한 후, MCP 대화창에 최신 실행 기록을 요청해 자동으로 문제를 분석합니다. 전체 워크플로우를 재생성하지 않고 부분만 업데이트해 실행 시간을 단축합니다. 자격 증명 정보 일부 수동 수정 후 오류 없이 17개 항목이 정상 추가되는 것을 확인합니다.

[04:39] Claude는 워크플로우를 처음부터 다시 만들지 않고 부분적으로 업데이트하여 토큰을 절약하고 속도를 높입니다. 페이지 새로고침과 자격 증명 업데이트 후 성공적으로 17개 항목이 추가됩니다.

[05:16] 자격 증명 변경 외에는 모든 작업을 Claude Desktop에서 처리했으며, Windsurf나 Cursor 같은 다른 도구도 MCP 연결에 사용할 수 있습니다.

몇 분 만에 n8n-MCP를 설치할 수 있는 GitHub Quick Start 절차를 안내합니다. 리포지토리 링크와 'quick start' 섹션 위치를 소개합니다. Node.js가 사전 요구사항임을 강조합니다.

[05:42] GitHub에서 설치 가이드를 확인하고 Quick Start 섹션의 npx 옵션을 사용합니다. 전제 조건으로 Node.js가 시스템에 설치되어 있어야 합니다.

Node.js 설치 페이지에서 운영체제에 맞는 패키지를 다운로드·설치하는 방법을 설명합니다. 터미널을 열어 NPX 명령어로 n8n-MCP 설치 스크립트를 실행하는 과정을 시연합니다. 설치가 완료되면 바로 다음 단계로 넘어갈 준비가 완료됩니다.

[06:10] 터미널을 열고 제공된 명령어를 하나씩 실행하여 Node.js를 설치합니다. GitHub 저장소에서 제공하는 설치 명령어를 실행합니다.

클라우드 데스크톱 또는 Cloud Code 환경에서 개발자 도구를 활성화하고 구성 파일을 편집하는 방법을 안내합니다. 복사한 전체 설정을 config 파일에 붙여넣습니다. 이후 인스턴스와 연결하기 위한 추가 수정 사항을 준비합니다.

[06:58] 전체 설정을 복사하고 Claude Desktop의 설정에서 개발자 도구를 활성화합니다. 설정 파일을 편집기로 열어 복사한 설정을 붙여넣습니다.

n8n 인스턴스 URL을 config에 입력하고 뒤따르는 경로를 지웁니다. 프로필 설정에서 NA10 API 키를 생성해 config에 붙여넣습니다. 저장 후 Claude 인스턴스를 재시작하면 MCP 도구 목록이 로드됩니다.

[07:37] n8n 인스턴스와 연결하기 위해 두 가지를 수정해야 합니다. 첫 번째는 n8n 인스턴스의 주소를 복사하여 붙여넣고, 뒤에 오는 내용을 삭제하는 것입니다.

[07:56] n8n API 키의 경우, 프로필 설정에서 n8n API로 이동하여 API 키를 생성하고 이름을 지정한 후 저장합니다. 생성된 API 키를 복사하여 붙여넣고 Command+S로 저장한 후 Claude를 재시작합니다.

클라우드 데스크톱에서 MCP 도구(NCP tools)가 정상적으로 표시되는지 확인합니다. 성공 여부를 통해 설치가 완료되었음을 검증합니다. 최적 결과를 위해 별도 클라우드 프로젝트 생성 권장 사항도 덧붙입니다.

[08:22] 로드 후 버튼을 클릭하면 n8n MCP 도구들을 볼 수 있어 성공적으로 작동했음을 의미합니다. 최상의 결과를 위해 시스템 지침을 갖춘 새로운 Claude 프로젝트를 생성하여 AI 에이전트가 n8n 워크플로우 생성에 필요한 도구들을 사용하도록 안내합니다.

새 프로젝트를 생성하고, 리포지토리의 'cloud project setup' 섹션에 제시된 시스템 인스트럭션을 복사·붙여넣습니다. AI 에이전트가 올바른 도구를 사용해 워크플로우를 생성하도록 가이드라인을 제공합니다. 해당 단계를 통해 반복 사용성을 높입니다.

[08:45] 프로젝트로 이동하여 새 프로젝트를 생성하고 이름을 지정한 다음 저장소로 돌아가서 Claude 프로젝트 설정의 텍스트를 복사하여 붙여넣고 지침을 저장합니다.

[09:05] n8n MCP는 새로운 아이디어 브레인스토밍, 노드 발견, 이전에 생각해보지 못한 로직 발견에 사용할 수 있습니다. 또한 복사 붙여넣기 대신 n8n 인스턴스 내에서 워크플로우를 생성하고 강력한 에이전트를 만들 수 있습니다.

n8n-MCP를 브레인스토밍, 노트 생성, 아키텍처 설계 등 다양한 용도로 활용할 수 있음을 제안합니다. 워크플로우 자동화 외에도 강력한 AI 에이전트를 직접 만들어 사용할 것을 권장합니다. 좋아요, 댓글, 개발자 연락처 안내로 영상을 마무리합니다.

타임라인 정보가 없습니다.

[00:00] 안녕하세요, 저는 라물 트룬코프스키입니다. 저는

[00:02] n8n MCP 개발자입니다. 이것은

[00:06] 모델 컨텍스트 프로토콜로, 여러분의

[00:09] Claude Desktop, Claude Code, Cursor 또는

[00:12] Windsurf를 유능한 AI 에이전트로 바꿔

[00:16] 여러분을 위해 워크플로우를 생성, 편집, 변경,

[00:20] 업데이트할 수 있도록 해줍니다. 이것은

[00:22] 게임체인저입니다. 지금까지 AI들은

[00:26] n8n 워크플로우 생성을 잘 못했습니다.

[00:29] 실제로 n8n에서

[00:32] 작동하는 방식으로 생성하는 데 필요한

[00:34] 지식과 컨텍스트가 부족했습니다.

[00:36] 이 비디오에서는 n8n MCP가 왜 그리고 어떻게

[00:40] 작동하는지 보여드리겠습니다. 또한

[00:44] 가장 일반적이고 쉬운

[00:46] 설치 방법을 통해 몇 분 안에

[00:48] 시작할 수 있도록 하겠습니다. 자, 먼저

[00:50] n8n MCP가 실제로 작동하는 모습을 보겠습니다.

[00:54] 여기 간단한 지시사항을 준비했습니다.

[00:56] 매시간 해커뉴스를 가져와서

[00:58] 새로운 것들만 우리의

[01:01] Google 문서에 저장하는 n8n 워크플로우를 원합니다.

[01:05] 확장 사고와 Claude Opus 4를 선택했습니다.

[01:08] 이는 사용 가능한 가장 강력한 모델입니다.

[01:11] 어떤 일이 일어나는지 보겠습니다. 완료되었다고 나오네요.

[01:14] 설정 지침을 보니

[01:17] Google Sheets 연결을 구성하고 시트를 생성해야 합니다.

[01:20] 좋습니다. 복사해서

[01:22] 여기에 붙여넣겠습니다.

[01:25] 실제로 나쁘지 않네요. 실행해보겠습니다.

[01:29] 여기서 실패했습니다. 작동하지 않지만

[01:33] 치명적이지는 않습니다. 한 번 더 기회를 주겠습니다.

[01:37] 생성된 워크플로우를 복사 붙여넣기까지 하겠습니다.

[01:40] 데이터가 있도록 말이죠.

[01:42] 새로운 것이 있네요. 복사해서

[01:46] 다시 붙여넣겠습니다.

[01:48] 같은 지점에서 실패합니다. 좋습니다.

[01:52] 이제 MCP를 켜고 해보겠습니다.

[01:56] 똑같은 지시사항을 복사해서

[01:59] n8n MCP가 활성화된 상태로 붙여넣겠습니다.

[02:02] 똑같은 설정으로 클릭하겠습니다.

[02:05] 확장 사고 Opus 4. 이제

[02:09] Claude가 먼저 사용 가능한

[02:12] MCP 도구들의 문서를 확인하고

[02:16] 이 자동화에 사용할 계획인 노드들을

[02:19] 검색하기 시작합니다.

[02:22] 노드들을 선택하면

[02:24] 각각의 특정 노드에 대한 문서를 가져와서

[02:27] 구성 방법을 학습할 것입니다.

[02:30] 맞죠? 이것은 항상 최신 n8n 버전으로

[02:33] 업데이트되어 있습니다. 따라서

[02:36] 구식 노드는 받지 않게 됩니다.

[02:39] 빌드 준비가 완료되면

[02:42] 제안된 구성을 검증하기 시작합니다.

[02:45] 단일 노드에 대한 코드를 생성하고

[02:47] MCP 도구로 검증합니다.

[02:51] 검증이 완료되면

[02:54] 워크플로우를 빌드하기 시작하고

[02:57] 다시 전체 워크플로우를 검증합니다.

[03:00] 노드들 간의 연결과

[03:02] 구성 등을 검증합니다.

[03:05] 검증을 시도했을 때

[03:08] 사고에 오류가 있다는 것을 깨달았습니다.

[03:11] MCP로부터 어떤 것을

[03:12] 수정해야 할지 피드백을 받았습니다.

[03:15] 워크플로우를 변경한 후

[03:18] 나중에 문제 해결을 하지 않아도 되도록

[03:21] 다시 검증합니다.

[03:23] 좋습니다. 이제 제 n8n 인스턴스가

[03:25] 연결되어 있고 정상인지 확인하고 있습니다.

[03:28] 그것이 확인되면

[03:30] 인스턴스 내부에서 이미

[03:33] 워크플로우를 생성하는 작업을 계속합니다.

[03:35] 따라서 복사 붙여넣기할 필요가 없습니다.

[03:37] 좋습니다. 완료되었습니다.

[03:40] 워크플로우 ID 해커뉴스를 볼 수 있습니다.

[03:43] 복사 붙여넣기. 좋습니다. 완료되었습니다.

[03:46] 워크플로우 ID 해커뉴스를 구글 시트로 볼 수 있습니다.

[03:49] 어떤 기능을 하는지 확인해보세요. 설정 가이드입니다.

[03:52] 구글 시트 설정. 먼저 열들을 추가해봅시다.

[03:55] 좋습니다, 완료되었습니다.

[03:57] n8n 인스턴스에서 워크플로우를 확인해봅시다.

[03:59] 여기 있습니다. 해커뉴스에서 구글 시트로.

[04:02] 해커뉴스에서 구글 시트로.

[04:03] 이것을 정리하고 자격 증명을 선택해봅시다.

[04:05] 실행해봅시다.

[04:08] 좋습니다, 오류가 있습니다.

[04:11] n8n MCP의 장점은 그냥 물어볼 수 있다는 것입니다.

[04:14] 대화로 돌아가서

[04:17] 간단히 오류가 있다고 말하면서

[04:20] 최신 실행 결과를 가져와서

[04:22] 문제를 해결해달라고 합니다.

[04:23] 깊이 생각하고 생성된 워크플로우를 검증해달라고 합니다.

[04:25] Claude는 모든 실행 결과를 나열하고

[04:28] 최신 실행 결과를 가져옵니다.

[04:32] 다운로드된 데이터를 확인하고

[04:34] 어떻게 오류가 발생했는지 확인한 후

[04:36] 문제를 해결합니다.

[04:39] 처음부터 워크플로우를 생성하지 않습니다.

[04:42] 워크플로우를 부분적으로 업데이트하여

[04:45] 토큰을 절약하고 전체 프로세스를 가속화합니다.

[04:48] 검증하고 워크플로우를 수정했습니다.

[04:50] 확인해봅시다.

[04:53] 해야 할 일은 페이지를 새로고침하는 것뿐입니다.

[04:55] 자격 증명도 업데이트해야 합니다.

[04:58] 실행해서 확인해봅시다.

[05:04] 17개 항목이 추가되었습니다.

[05:07] 있는지 확인해봅시다.

[05:10] 좋습니다, 있습니다.

[05:12] 작동합니다. 몇 분 정도 걸렸습니다.

[05:16] 자격 증명을 조금 변경한 것 외에는

[05:18] 워크플로우를 건드리지 않았습니다.

[05:22] n8n MCP는 이를 지원하지 않습니다.

[05:24] 자격 증명을 읽지 않습니다.

[05:27] 하지만 그 외에는 모든 것을 Claude Desktop에서 했습니다.

[05:30] Claude Code, Windsurf 또는 Cursor도 사용할 수 있습니다.

[05:33] MCP에 연결하기 위해서 말입니다.

[05:36] 이제 직접 설치하는 방법을 설명하겠습니다.

[05:39] 몇 분 안에 무료로 설치할 수 있습니다.

[05:42] 먼저 GitHub로 가야 합니다.

[05:44] GitHub에서 보고 있다면 이미 거기 있습니다.

[05:46] 그렇지 않다면 링크가 이 비디오 설명에 있습니다.

[05:48] Quick Start로 스크롤하면

[05:50] npx로 가장 빠른 옵션이 있습니다.

[05:53] 전제 조건은 시스템에 Node.js가 설치되어 있어야 한다는 것입니다.

[05:55] 매우 간단한 설치입니다.

[05:58] 여기로 가서 NodeJS 설치를 클릭하고

[06:01] 운영 체제를 선택하면 됩니다.

[06:04] 그 다음 터미널을 열어야 합니다.

[06:07] 터미널을 입력하면 열립니다.

[06:10] 그 다음 이 줄들을 하나씩 터미널에 복사합니다.

[06:13] 그 다음 터미널을 열어야 합니다.

[06:16] 터미널을 입력하면 열립니다.

[06:21] 그 다음 이 줄들을 하나씩 터미널에 복사합니다.

[06:23] 터미널에.

[06:26] 시스템에 NodeJS를 설치할 것입니다.

[06:30] GitHub 저장소로 돌아가서

[06:46] 이 명령어를 실행합니다.

[06:48] 붙여넣기. 네, 실행됩니다.

[06:51] 다음에 할 일은

[06:55] 전체 설정을 복사하는 것입니다.

[06:58] Claude Desktop으로 가서

[07:02] Claude 설정과 개발자를 선택합니다.

[07:05] 이미 설치되어 있습니다.

[07:09] 지우겠습니다.

[07:11] 여기에 개발자 도구 활성화가 있을 것입니다.

[07:15] 그것을 클릭하고 설정 편집을 클릭합니다.

[07:18] 편집기로 열어야 하는 파일로 이동합니다.

[07:22] 코드 편집기나 다른 것을 사용할 수 있습니다.

[07:24] 앞서 복사한 것을 여기에 붙여넣으면 됩니다.

[07:27] n8n 인스턴스에 직접 연결을 원한다면

[07:29] 다음과 같이 해야 합니다.

[07:31] n8n 인스턴스에 직접 연결을 원한다면

[07:34] 다음과 같이 해야 합니다.

[07:37] 이 두 가지를 수정해야 합니다. 첫 번째는

[07:40] n8n 인스턴스의 주소입니다. 따라서

[07:42] URL을 복사하여

[07:49] 여기에 붙여넣으세요. 뒤에 오는

[07:52] 내용은 삭제하는 것을 잊지 마세요. 그리고

[07:56] n8n API 키의 경우,

[08:00] 프로필 설정으로 이동하여 n8n API에서

[08:06] API 키를 생성하세요. 이름을 지정하고

[08:09] 저장을 클릭하세요. 그러면

[08:12] API 키가 생성됩니다. 이것을 여기에 붙여넣으세요.

[08:16] Command+S를 눌러 저장하고 Claude를

[08:19] 재시작하세요.

[08:22] 로드되면 이

[08:24] 버튼을 클릭하면 n8n MCP

[08:28] 도구들을 볼 수 있습니다.

[08:30] 이것은 성공적으로 작동했다는 의미입니다. 최상의 결과를 위해

[08:32] 시스템 지침을 갖춘 새로운 Claude 프로젝트를 생성해야 합니다.

[08:34] 이는 AI 에이전트가 실제로

[08:36] n8n 워크플로우를 생성하는데 필요한

[08:40] 도구들을 사용하도록 안내할 것입니다. 이를 위해서는

[08:42] 프로젝트로 이동하여

[08:45] 새 프로젝트를 생성하고

[08:48] 프로젝트 이름을 지정한 다음

[08:51] 저장소로 돌아가세요.

[08:54] Claude 프로젝트 설정에서 해당

[08:58] 텍스트를 복사하여

[09:00] 여기에 붙여넣으세요. 지침을 저장하세요.

[09:05] 완료되었습니다. 이제 이

[09:07] n8n MCP를 무엇에 사용할 수 있을까요?

[09:10] 새로운 아이디어 브레인스토밍,

[09:13] 노드 발견, 그리고 이전에

[09:15] 생각해보지 못한 로직을 발견하는 데 사용할 수 있습니다.

[09:18] 뿐만 아니라 n8n 인스턴스 내에서

[09:21] 워크플로우를 생성할 수 있습니다. 복사

[09:24] 붙여넣기 대신 강력한 에이전트를 만들 수 있습니다.

[09:27] GitHub에서 더 많은 n8n MCP 도구들을

[09:29] 발견할 수 있습니다

[09:32] 문서를 통해. 이를 사용하여

[09:34] 새로운 워크플로우를 생성할 수 있을 뿐만 아니라

[09:36] 아이디어를 브레인스토밍하고 새로운

[09:38] 아키텍처를 만들 수 있습니다. 이

[09:40] 비디오에 좋아요를 눌러주시고, 댓글로

[09:44] n8n MCP 경험을 공유해주세요. 그리고

[09:47] 저와 함께 일하고 싶다면 연락처

[09:49] 정보가 비디오 설명에 있습니다.

[09:52] 감사합니다.