czlonkowski/n8n-mcp

n8n‑MCP – n8n을 위한 "모델 컨텍스트 프로토콜" 서버

무엇인가요

• n8n 워크플로우 자동화 노드(약 2,400개 노드)의 전체 카탈로그를 AI 모델(Claude, ChatGPT 등)이 질의할 수 있는 구조화된 데이터로 공개하는 가벼운 HTTP 서비스입니다.
• 이를 n8n용 검색 가능한 지식 기반으로 이해할 수 있습니다: 노드 이름, 속성, 작업, 예시 구성, 문서 등이 명확하게 정의된 API 호출을 통해 이용 가능합니다.

왜 중요한가요

• 대규모 언어 모델은 n8n 워크플로우를 생성하거나 편집할 수 있지만, 각 노드에 대한 신뢰할 수 있고 최신 정보가 필요합니다. n8n‑MCP는 이러한 컨텍스트를 제공하여 환상(허구)과 손상된 워크플로우를 줄입니다.
• MCP 클라이언트 노드를 n8n 인스턴스에 통합하면, AI 어시스턴트가 템플릿을 탐색하고, 노드 사양을 가져오며, 구성 검증, 심지어 워크플로우 자동 배포까지 가능합니다.

주요 기능 (README에 설명됨)

기능	제공되는 내용
노드 카탈로그	2,412개 노드(코어 829개, 커뮤니티 1,583개)로, 속성의 99% 및 작업의 66%를 커버합니다.
문서	공식 n8n 문서의 86%에 더해 AI 전용 노드 문서도 포함됩니다.
AI 대응 도구	"AI 대응 가능"으로 표시된 267개 노드 변형.
현실 세계 예시	인기 있는 커뮤니티 템플릿에서 추출한 156개의 등급 매겨진 구성.
템플릿 라이브러리	2,352개의 즉시 사용 가능한 워크플로우 템플릿으로, 각각 AI 메타데이터로 주석 처리됨.
검색 및 검색	노드, 속성, 템플릿, 커뮤니티 통합을 검색할 수 있는 도구로, 복잡도, 대상 사용자, 필요 서비스 등으로 필터링 가능.
검증 파이프라인	배포 전 누락된 매개변수를 포착하기 위한 다단계 검증(minimal → full → 워크플로우 전체).
관리 API	N8N_API_URL/N8N_API_KEY로 자신의 n8n 인스턴스를 지정하면, 워크플로우를 프로그래밍 방식으로 생성, 업데이트, 테스트, 삭제할 수 있습니다.
안전 경고	프로덕션 워크플로우를 AI로 직접 편집하지 말 것을 강력 권고; 항상 복사, 테스트, 백업을 수행하세요.

사용 방법

1. 즉시 시도하기 – 호스팅된 대시보드(dashboard.n8n-mcp.com)에서 하루 100회 무료 도구 호출이 가능합니다. 간단히 가입하고 API 키를 받으세요.
2. 자체 호스팅 – Docker 이미지, npx 스타터, Railway 배포 스크립트를 제공하여 제어나 높은 제한이 필요한 사용자에게 적합합니다.
3. n8n에 연결하기 – 원하는 n8n 워크플로우에 MCP Client Tool 노드를 추가하고 API 키를 설정한 후, MCP 도구 호출을 시작하세요 (예: search_nodes, get_node, validate_workflow).
4. AI IDE와 통합하기 – Claude Code, VS Code(Copilot), Cursor, Windsurf, Codex, Antigravity용 준비된 설정 가이드를 제공하여, 이 어시스턴트들이 백엔드에서 MCP 도구를 호출할 수 있게 합니다.
5. 워크플로우 배포하기 – MCP 도구로 워크플로우를 구축한 후, n8n_create_workflow로 n8n 인스턴스에 푸시하고, n8n_test_workflow로 테스트를 실행하며, n8n_autofix_workflow로 일반적인 오류를 자동 수정할 수 있습니다.

일반적인 AI 어시스턴트 워크플로우

1. tools_documentation()          # MCP에 대한 배경 정보 얻기
2. search_templates({task:'slack notification'})
3. get_template(id, {mode:'full'})
4. validate_workflow(workflow)
5. n8n_create_workflow(workflow)   # 자신의 n8n 인스턴스에 배포

README에는 시스템 지침을 통해 조용하고 병렬 실행을 강제하며, 템플릿 출처 표기를 필수로 하는 상세한 "Claude 프로젝트 설정"도 설명되어 있습니다.

안전성 및 거버넌스

• 파괴적 도구를 비활성화하고 읽기 전용 n8n API 키를 사용하면 서버를 읽기 전용 모드로 실행할 수 있으며, 규제 환경에 유용합니다.
• Cloudflare Access 지원으로 n8n API를 제로 트러스트 기반으로 보호할 수 있습니다.
• 하드닝, 프라이버시, 텔레메트리에 대한 광범위한 문서가 제공됩니다.

누가 이득을 볼 수 있나요

• 개발자：노드 사양을 수동으로 검색하지 않고도 복잡한 자동화를 AI 도움을 받아 구축하고 싶은 사람.
• 팀：내부 LLM 어시스턴트에게 커스터마이징된 검색 가능한 n8n 지식 기반을 제공하고 싶은 사람.
• AI 도구 벤더：n8n 기능을 제품에 통합할 수 있는 즉시 사용 가능한 프로토콜을 찾는 사람.

---

결론：n8n‑MCP는 검색, 검증, 배포 기능을 갖춘 진정한 생산 환경 대응 브리지로, n8n 노드 생태계를 AI 모델용 기계가 읽을 수 있는 지식 소스로 전환합니다.