n8n MCP 서버
모델 컨텍스트 프로토콜을 통해 n8n 워크플로, 실행, 자격 증명 등에 대한 액세스를 제공하는 MCP 서버입니다. 이를 통해 대규모 언어 모델(LLM)이 안전하고 표준화된 방식으로 n8n 인스턴스와 상호 작용할 수 있습니다.
설치
n8n API 키를 받으세요
n8n 인스턴스에 로그인하세요
왼쪽 하단의 사용자 아이콘을 클릭하세요
설정으로 이동
API 선택
"API 키 생성"을 클릭하세요
API 키를 복사하세요(다시는 볼 수 없습니다)
MCP 서버 설치
옵션 1: npm에서 설치(권장)
지엑스피1
옵션 2: 소스에서 설치
저장소를 복제합니다.
git clone https://github.com/illuminaresolutions/n8n-mcp-server.git cd n8n-mcp-server종속성을 설치하고 빌드합니다.
npm install npm run build백그라운드에서 서버를 시작합니다.
nohup npm start > n8n-mcp.log 2>&1 &서버를 중지하려면:
pkill -f "node build/index.js"
참고: npm에서 설치하는 경우 서버는 PATH에 n8n-mcp-server 로 표시됩니다.
Related MCP server: n8n Workflow Builder MCP Server
구성
클로드 데스크탑
Claude Desktop 구성을 엽니다.
~/Library/Application Support/Claude/claude_desktop_config.jsonn8n 구성을 추가합니다.
{ "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }
클라인(VS 코드)
서버를 설치하세요(위의 설치 단계를 따르세요)
VS 코드 열기
왼쪽 사이드바에서 Cline 확장 프로그램을 엽니다.
창 상단의 'MCP 서버' 아이콘을 클릭하세요.
아래로 스크롤하여 'MCP 서버 구성'을 클릭하세요.
열린 설정 파일에 다음을 추가합니다.
{ "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }파일을 저장하세요
MCP 토글이 활성화되어 있고(녹색) 상태 표시기가 녹색인지 확인하세요.
Cline에서 MCP 명령 사용 시작
세이지
곧 출시됩니다! n8n MCP 서버는 다음을 통해 이용 가능합니다.
Smithery.ai 마켓플레이스
Claude Desktop에서 가져오기
지금은 Claude Desktop이나 Cline을 사용하세요.
확인
구성 후:
LLM 신청을 다시 시작하세요
질문: "내 n8n 워크플로 나열"
워크플로가 나열되어 있어야 합니다.
오류가 발생하는 경우:
n8n 인스턴스가 실행 중인지 확인하세요.
API 키에 올바른 권한이 있는지 확인하세요.
N8N_HOST에 끝에 슬래시가 없는지 확인하세요.
특징
핵심 기능
워크플로 나열 및 관리
워크플로 세부 정보 보기
워크플로 실행
자격 증명 관리
태그 및 실행 처리
보안 감사 생성
워크플로 태그 관리
엔터프라이즈 기능
다음 기능을 사용하려면 n8n Enterprise 라이선스가 필요합니다.
프로젝트 관리
변수 관리
고급 사용자 관리
문제 해결
일반적인 문제
"클라이언트가 초기화되지 않았습니다"
N8N_HOST와 N8N_API_KEY가 올바르게 설정되었는지 확인하세요.
n8n 인스턴스에 액세스할 수 있는지 확인하세요.
API 키 권한 확인
"면허 필요"
Enterprise 기능을 사용하려고 합니다.
n8n Enterprise로 업그레이드하거나 핵심 기능만 사용하세요.
연결 문제
n8n 인스턴스가 실행 중인지 확인하세요
URL 프로토콜(http/https) 확인
N8N_HOST에서 마지막 슬래시를 제거합니다.
보안 모범 사례
API 키 관리
필요한 최소한의 권한만 사용하세요
키를 정기적으로 회전하세요
버전 제어에 키를 커밋하지 마십시오.
인스턴스 액세스
프로덕션에는 HTTPS를 사용하세요
n8n 인증 활성화
n8n을 최신 상태로 유지하세요