n8n MCP 서버

모델 컨텍스트 프로토콜을 통해 n8n 워크플로, 실행, 자격 증명 등에 대한 액세스를 제공하는 MCP 서버입니다. 이를 통해 대규모 언어 모델(LLM)이 안전하고 표준화된 방식으로 n8n 인스턴스와 상호 작용할 수 있습니다.

설치

n8n API 키를 받으세요

1. n8n 인스턴스에 로그인하세요
2. 왼쪽 하단의 사용자 아이콘을 클릭하세요
3. 설정으로 이동
4. API 선택
5. "API 키 생성"을 클릭하세요
6. API 키를 복사하세요(다시는 볼 수 없습니다)

MCP 서버 설치

옵션 1: npm에서 설치(권장)

지엑스피1

옵션 2: 소스에서 설치

1. 저장소를 복제합니다.
   git clone https://github.com/illuminaresolutions/n8n-mcp-server.git cd n8n-mcp-server
2. 종속성을 설치하고 빌드합니다.
   npm install npm run build
3. 백그라운드에서 서버를 시작합니다.
   nohup npm start > n8n-mcp.log 2>&1 &
   서버를 중지하려면:
   pkill -f "node build/index.js"

참고: npm에서 설치하는 경우 서버는 PATH에 n8n-mcp-server 로 표시됩니다.

구성

클로드 데스크탑

1. Claude Desktop 구성을 엽니다.
   ~/Library/Application Support/Claude/claude_desktop_config.json
2. n8n 구성을 추가합니다.
   { "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }

클라인(VS 코드)

1. 서버를 설치하세요(위의 설치 단계를 따르세요)
2. VS 코드 열기
3. 왼쪽 사이드바에서 Cline 확장 프로그램을 엽니다.
4. 창 상단의 'MCP 서버' 아이콘을 클릭하세요.
5. 아래로 스크롤하여 'MCP 서버 구성'을 클릭하세요.
6. 열린 설정 파일에 다음을 추가합니다.
   { "mcpServers": { "n8n": { "command": "n8n-mcp-server", "env": { "N8N_HOST": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key-here" } } } }
7. 파일을 저장하세요
8. MCP 토글이 활성화되어 있고(녹색) 상태 표시기가 녹색인지 확인하세요.
9. Cline에서 MCP 명령 사용 시작

세이지

곧 출시됩니다! n8n MCP 서버는 다음을 통해 이용 가능합니다.

• Smithery.ai 마켓플레이스
• Claude Desktop에서 가져오기

지금은 Claude Desktop이나 Cline을 사용하세요.

확인

구성 후:

1. LLM 신청을 다시 시작하세요
2. 질문: "내 n8n 워크플로 나열"
3. 워크플로가 나열되어 있어야 합니다.

오류가 발생하는 경우:

• n8n 인스턴스가 실행 중인지 확인하세요.
• API 키에 올바른 권한이 있는지 확인하세요.
• N8N_HOST에 끝에 슬래시가 없는지 확인하세요.

특징

핵심 기능

• 워크플로 나열 및 관리
• 워크플로 세부 정보 보기
• 워크플로 실행
• 자격 증명 관리
• 태그 및 실행 처리
• 보안 감사 생성
• 워크플로 태그 관리

엔터프라이즈 기능

다음 기능을 사용하려면 n8n Enterprise 라이선스가 필요합니다.

• 프로젝트 관리
• 변수 관리
• 고급 사용자 관리

문제 해결

일반적인 문제

1. "클라이언트가 초기화되지 않았습니다"
   • N8N_HOST와 N8N_API_KEY가 올바르게 설정되었는지 확인하세요.
   • n8n 인스턴스에 액세스할 수 있는지 확인하세요.
   • API 키 권한 확인
2. "면허 필요"
   • Enterprise 기능을 사용하려고 합니다.
   • n8n Enterprise로 업그레이드하거나 핵심 기능만 사용하세요.
3. 연결 문제
   • n8n 인스턴스가 실행 중인지 확인하세요
   • URL 프로토콜(http/https) 확인
   • N8N_HOST에서 마지막 슬래시를 제거합니다.

보안 모범 사례

1. API 키 관리
   • 필요한 최소한의 권한만 사용하세요
   • 키를 정기적으로 회전하세요
   • 버전 제어에 키를 커밋하지 마십시오.
2. 인스턴스 액세스
   • 프로덕션에는 HTTPS를 사용하세요
   • n8n 인증 활성화
   • n8n을 최신 상태로 유지하세요

지원하다

• GitHub 문제
• n8n 문서

특허

MIT 라이센스