MCP

n8n: 시각적 캔버스와 커스텀 코드로 워크플로와 AI 에이전트 구축하기

셀프호스팅 환경에서 시각적 캔버스와 커스텀 코드로 워크플로와 AI 에이전트를 구축하기에 적합하지만, 처음 사용하기 전에 반드시 Docker를 설치해야 하며 fair-code 라이선스가 상업적 사용에 미치는 제약도 파악해야 합니다.

Official source · n8n-io/n8n

Install

curl -fsSL https://get.n8n.io | sh

적합한 사용자

  • 셀프호스팅 환경에서 워크플로 자동화와 AI 에이전트를 구축하려는 팀에 적합합니다. 시각적 캔버스로 프로세스를 오케스트레이션하고, 필요할 때 노드 안에서 JavaScript나 Python을 작성하거나 npm 패키지를 가져올 수 있으며, OpenAI, Anthropic, Google 또는 오픈소스 모델을 연동할 수 있습니다.
  • 그래픽 기반 구축과 코드의 유연성을 동시에 유지하고 싶은 사용자에게 적합하며, 공식 설명에 따르면 400개 이상의 통합을 제공합니다.
  • 적합하지 않은 경우: n8n은 Sustainable Use License와 n8n Enterprise License를 사용하는 fair-code 배포 방식으로, 전통적인 의미의 완전한 오픈소스 라이선스가 아닙니다. 사용 시나리오에 라이선스 관련 엄격한 요구 사항이 있다면 먼저 약관이 이를 허용하는지 직접 확인해야 합니다.
  • 공식적으로는 Docker를 통한 실행을 명확히 권장하며, Docker 환경이 없으면 첫 시도가 막힙니다. 그 외 다른 실행 방식의 공식 전제 조건은 이번 근거 자료에서 설명되지 않았습니다.

3분 만에 첫 시도 완료하기

권장되는 기본 경로는 공식 README가 제공하는 설치 스크립트입니다(로컬에 Docker가 설치되어 있어야 함):

curl -fsSL https://get.n8n.io | sh
  1. 전제 조건: Docker가 설치되어 있고 실행 가능한지 확인합니다.
  2. 위의 공식 설치 스크립트를 실행합니다.
  3. 데이터 위치를 직접 제어하고 싶다면, 공식에서 Docker 수동 방식도 안내합니다. 먼저 docker volume create n8n_data로 볼륨을 생성한 뒤, 공식 안내에 따라 docker.n8n.io/n8nio/n8n 이미지를 실행하고 포트 5678을 매핑한 후, 브라우저에서 http://localhost:5678 을 열어 에디터에 접속합니다. 이는 로컬 배포 구성으로, 로컬에서 볼륨을 생성하고 컨테이너를 실행하는 작업이 포함되며 읽기 전용 작업이 아닙니다. 정확한 전체 docker run 파라미터는 공식 README 원문을 기준으로 하세요.
  4. 에디터 화면이 보이면 첫 시도가 성공한 신호입니다.

첫 사용 시에는 에디터에서 저위험 작업부터 하는 것이 좋습니다: 인터페이스를 둘러보고 사용 가능한 통합과 노드 타입을 확인하는 정도입니다. 외부 서비스에 연결되거나 데이터를 쓰는 동작을 실제로 실행하기 전에 노드의 동작을 먼저 확인하세요. 이번 근거 자료에는 각 노드의 읽기/쓰기 성격에 대한 설명이 포함되어 있지 않기 때문입니다.

사용 사례

사례 1: AI 워크플로 구축. http://localhost:5678 의 시각적 캔버스에서 워크플로를 만들고, JavaScript 또는 Python을 사용하는 코드 노드를 삽입한 뒤 OpenAI, Anthropic, Google 또는 오픈소스 모델을 연동합니다. 기대할 수 있는 결과: 공식 설명에 따르면 "시각적 구축 + 커스텀 코드" 조합을 지원합니다. 특정 모델 노드의 파라미터 설정에 대해서는 이번 근거 자료에 상세 설명이 없으며, 확인 가능한 범위는 플랫폼이 AI 기능과 이들 모델의 연동 능력을 기본적으로 갖추고 있다는 점입니다.

사례 2: 셀프호스팅 배포 검증. docker volume create n8n_data로 데이터 볼륨을 생성하고, 공식 README의 수동 Docker 배포 단계에 따라 이미지를 실행한 후 http://localhost:5678 에 접속해 에디터가 동작하는지 확인합니다. 기대할 수 있는 결과: n8n이 로컬 Docker에서 실행되고 데이터 볼륨 n8n_data가 생성됩니다. 워크플로 실행 시 로컬 상태가 기록되며, 볼륨이나 컨테이너를 삭제했을 때의 영향은 이번 근거 자료에서 설명되지 않았으므로 작업 전에 직접 확인하세요.

사용 경계

  • 읽기/쓰기 성격: n8n 에디터와 워크플로 실행은 외부 서비스 호출과 로컬 데이터 쓰기(예: 데이터 볼륨)를 유발합니다. 첫 시도는 둘러보기와 확인 수준에 머물러야 하며, 실제 실행 전에 각 노드가 무엇을 하는지 명확히 파악하세요.
  • 자격 증명 요구 사항: 공식 근거 자료에는 첫 실행 시 계정 등록이나 이메일이 강제되는지에 대한 설명이 없으므로, 알 수 없는 정보를 임의로 가정하지 마세요.
  • 라이선스 제한: fair-code 방식으로, Sustainable Use License + n8n Enterprise License가 적용됩니다. 상업적 사용이나 배포 전에 라이선스 조항을 확인해야 합니다.
  • 아직 확인되지 않은 사항: 각 개별 노드의 읽기 전용/쓰기 동작, 되돌리기 경로, 데이터 프라이버시 경계, 그리고 Docker 외 다른 설치 방식의 공식 전제 조건. 이번 근거 자료에서 모두 설명되지 않았으며, 이것이 위험이 없다는 뜻은 아닙니다.