A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you

n8n‑MCP – n8n 워크플로 플랫폼을 위한 AI 친화적 지식 베이스

정의

전체 n8n 워크플로 노드 카탈로그(약 3,000개 노드)를 Model Context Protocol (MCP) API로 노출하는 서버.
AI 어시스턴트(Claude, OpenAI 등)는 이 API를 호출하여 노드 속성, 작업, 문서, 예제 구성 및 즉시 사용 가능한 워크플로 템플릿에 대한 구조화된 정보를 얻을 수 있습니다.

중요성

LLM으로 n8n 자동화를 구축하는 것은 모델이 모든 노드에 대한 최신 세부 정보를 필요로 하기 때문에 어렵습니다. n8n‑MCP는 모델에게 신뢰할 수 있고 검색 가능한 지식 소스를 제공하여 모호한 프롬프트를 구체적이고 실행 가능한 워크플로로 변환합니다.
이 서비스는 검증 도구도 함께 제공하므로 AI는 생성된 노드 구성이 완전하고 런타임에 실패하지 않는지 확인할 수 있습니다.

주요 기능(README에 설명됨)

기능	제공 내용
노드 카탈로그	2,951개 노드(코어 838개 + 커뮤니티 2,113개), 속성 스키마의 99% 커버.
작업 커버리지	모든 노드 작업의 약 3분의 2가 설명됨(66.5%).
문서	공식 n8n 문서의 86%가 인덱싱됨(AI 특정 노드 포함).
AI 지원 도구	AI 에이전트가 사용 가능한 것으로 표시된 267개 노드 변형(전체 문서 포함).
실제 예제	인기 커뮤니티 템플릿에서 추출한 156개의 순위 구성.
템플릿 라이브러리	2,352개의 즉시 사용 가능한 워크플로 템플릿, 각각 AI 친화적 메타데이터로 주석 처리됨(99.96% 커버리지).
검색	노드 및 템플릿 전체 텍스트 검색, 커뮤니티 vs 검증된 노드 필터, 예제 구성 가져오기 기능.
검증	`validate_node`(빠른 최소 또는 전체 런타임 검사) 및 `validate_workflow`로 배포 전에 누락된 매개변수를 감지합니다.
관리 도구	자신의 n8n 인스턴스 자격 증명을 제공하면 API가 워크플로를 직접 생성, 업데이트, 삭제, 테스트하고, 동적 드롭다운 값을 탐색하고, 폴더, 데이터 테이블 등을 관리할 수 있습니다.
안전 지침	AI로 프로덕션 워크플로를 직접 편집하지 말고 항상 백업 및 테스트를 강력히 경고합니다.

사용 방법

API 키 받기 – 호스팅 대시보드(dashboard.n8n-mcp.com)에서 가입하거나 Docker, Railway 등을 통해 자체 호스팅합니다.
AI에게 요청 – LLM(예: Claude)이 search_nodes, get_node, validate_node, search_templates와 같은 MCP 도구를 호출한 다음 워크플로 JSON을 조합합니다.
배포 – n8n_create_workflow / n8n_update_partial_workflow를 사용하여 생성된 워크플로를 자신의 n8n 서버로 푸시합니다.
반복 – n8n_test_workflow를 실행하고, 검증 오류를 수정한 후 다시 배포합니다.

대상

시작하기

호스팅 데모: 대시보드 링크를 방문하여 가입하고 무료 티어 API 키(하루 100회 도구 호출)를 받으세요.
자체 호스팅: SELF_HOSTING.md 가이드에 따라 Docker, npm(npx n8n-mcp) 또는 Railway 배포를 수행하세요.
n8n에 연결: N8N_API_URL 및 N8N_API_KEY(또는 Cloudflare Access 토큰)를 설정하여 MCP가 n8n 인스턴스와 통신할 수 있도록 하세요.
IDE 통합: 저장소는 Claude Code, VS Code, Cursor 등에 대한 빠른 시작 문서를 제공하여 편집기에서 직접 MCP 도구를 호출할 수 있습니다.

결론 n8n‑MCP는 방대한 n8n 노드 생태계를 깔끔하고 검색 가능하며 AI 지원 지식 베이스로 전환하여 대규모 언어 모델이 실제 n8n 워크플로를 훨씬 적은 오류로 구축, 검증 및 배포할 수 있게 합니다.

czlonkowski/n8n-mcp