AI/LLM

n8n 실전 가이드 — AI 에이전트 워크플로우 자동화, Zapier·Make와 비교, 셀프호스팅까지

400개 이상 통합을 지원하는 오픈소스 워크플로우 자동화 도구 n8n 완전 분석. AI Agent 노드 구성, LLM·벡터 스토어·메모리 연동, JavaScript 커스텀 노드 작성, Docker 셀프호스팅 설정, Zapier·Make와의 실전 비교까지 코드 중심으로 정리.

2026-04-06

n8n은 400개 이상의 통합을 지원하는 오픈소스 워크플로우 자동화 도구로, 2025년 말부터 AI 에이전트 오케스트레이터로 급부상했다. n8n 2.0(2025.12)에서 AI Agent 노드가 강화됐고, 현재 개발자 커뮤니티에서 Zapier·Make의 코드 친화적 대안이자 LLM 기반 자동화 플랫폼으로 자리를 잡고 있다.

이 글이 필요한 사람: 반복 업무를 AI로 자동화하려는 개발자·팀, Zapier/Make를 쓰고 있지만 커스텀 로직이 필요한 엔지니어, LLM API를 워크플로우에 통합하고 싶은 팀.

n8n이란 — 코드도 되고 노코드도 되는 자동화 도구

n8n("nodemation")은 2019년에 시작된 오픈소스 워크플로우 자동화 도구다. 드래그&드롭으로 워크플로우를 만들 수 있지만, 노드 안에서 JavaScript·Python을 직접 작성할 수도 있다는 점이 Zapier·Make와 구별되는 핵심이다.

Zapier는 UI 중심 자동화 도구로 코드 없이 빠르게 만들 수 있지만 복잡한 조건 분기나 커스텀 데이터 변환에 한계가 있다. n8n은 시각적 인터페이스를 제공하면서도 개발자가 원하는 로직을 그대로 삽입할 수 있는 하이브리드 구조다. 또한 셀프호스팅이 가능해 데이터가 외부 SaaS에 저장되지 않는다.

2026년 현재 커뮤니티에는 6,000개 이상의 공유 워크플로우가 등록돼 있고, AI 에이전트 관련 워크플로우가 가장 빠르게 증가하고 있다.

n8n 워크플로우 에디터 — AI Agent 노드와 LLM 통합 화면 — n8n의 캔버스 에디터. AI Agent 노드를 중심으로 메모리, 툴, LLM 모델을 시각적으로 연결할 수 있다. 출처: n8n 공식 문서 (docs.n8n.io)

AI Agent 노드 — n8n이 에이전트 오케스트레이터가 된 이유

n8n 2.0의 가장 큰 변화는 AI Agent 노드다. 기존에는 LLM 노드를 하나씩 연결해 파이프라인을 구성했다면, AI Agent 노드는 LLM 모델, 메모리, 툴(Tool)을 하나의 에이전트 단위로 묶어 관리한다.

에이전트가 사용할 수 있는 툴은 n8n이 지원하는 400개 통합 전체다. Google Sheets, Slack, PostgreSQL, HTTP Request 노드를 에이전트 툴로 등록하면, LLM이 판단해 자율적으로 해당 시스템을 호출한다.

지원하는 LLM은 OpenAI, Anthropic Claude, Google Gemini, Mistral, Ollama(로컬) 등 주요 제공자 전체다. API 키만 설정하면 에이전트 내부 모델로 즉시 교체 가능하다.

n8n 설치 — Docker부터 npm, n8n Cloud까지

n8n은 세 가지 방식으로 실행할 수 있다. 팀 규모와 데이터 보안 요구에 따라 선택하면 된다.

1. Docker (권장 — 프로덕션)
데이터를 직접 통제해야 하거나 커스텀 노드를 추가해야 하는 경우. 아래는 PostgreSQL을 데이터베이스로 쓰는 프로덕션 설정이다.

docker-compose.yml — n8n + PostgreSQL
version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=your_secure_password
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=your_db_password
      - N8N_ENCRYPTION_KEY=your_32char_encryption_key
      - WEBHOOK_URL=https://your-domain.com/
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

  postgres:
    image: postgres:15
    restart: unless-stopped
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=your_db_password
      - POSTGRES_DB=n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  postgres_data:

2. npm (빠른 로컬 테스트)
npx n8n 또는 npm install -g n8n && n8n start — 로컬에서 바로 실행 가능. SQLite를 기본 DB로 사용한다. 프로덕션에는 권장하지 않는다.

3. n8n Cloud (관리형)
n8n.io에서 호스팅 플랜 신청. 월 $20~$50 수준(실행 횟수 기반 과금). 서버 관리 없이 바로 시작하고 싶은 팀에 적합하다.

실전 AI 워크플로우 예시 3가지

1. Slack 메시지 → LLM 요약 → Notion 자동 저장
Slack에서 특정 채널에 메시지가 올라오면 n8n의 Slack 트리거가 감지 → Claude API로 요약 생성 → Notion 페이지에 자동 기록. 팀 회의록, 고객 피드백 수집에 즉시 적용 가능하다.

2. 이메일 첨부 파일 → 데이터 추출 → Google Sheets 업데이트
이메일 트리거로 PDF 첨부 파일 수신 → LLM으로 핵심 데이터 추출 → Google Sheets에 행 추가. 인보이스 처리, 채용 이력서 파싱, 보고서 집계 자동화에 사용된다.

3. 웹훅 수신 → AI 에이전트가 API 조합 → 결과 반환
외부 앱에서 웹훅으로 요청 수신 → AI Agent 노드가 필요한 API(날씨, DB, 외부 서비스)를 자율 호출 → 결과를 JSON으로 반환. 간단한 AI API 서버를 n8n으로 빠르게 프로토타이핑할 수 있다.

n8n Slack 자동화 워크플로우 예시 — LLM 요약 + Notion 저장 — Slack 트리거 → LLM 요약 → Notion 저장 워크플로우. 각 노드를 연결하고 API 키를 입력하면 5분 안에 동작하는 자동화를 만들 수 있다. 출처: n8n 커뮤니티 워크플로우

n8n vs Zapier vs Make — 개발자 기준 선택 가이드

통합 수만 보면 Zapier(6,000+)가 n8n(400+)보다 많다. 그러나 실무에서 필요한 핵심 통합(Slack, Google Workspace, GitHub, PostgreSQL, HTTP Request, OpenAI 등)은 n8n이 모두 커버한다. 나머지 5,600개의 Zapier 통합 대부분은 HTTP Request 노드로 직접 구현 가능하다.

개발자에게 n8n이 유리한 경우는 명확하다: 셀프호스팅으로 데이터를 통제해야 하거나, 복잡한 조건 분기·커스텀 변환 로직이 필요하거나, AI 에이전트를 워크플로우 안에 직접 통합해야 하는 경우다.

n8n 2.0 주요 변경사항 — 업그레이드 전 확인사항

n8n 2.0은 2025년 12월에 출시됐다. 주요 변경사항과 마이그레이션 시 확인해야 할 내용은 다음과 같다.

주요 변경사항

AI Agent 노드 개선: 토큰 관리, 멀티스텝 추론, 툴 에러 핸들링 강화
엔터프라이즈 보안 기본화: 환경 변수 암호화, 감사 로그 기본 활성화
향상된 신뢰성: 워크플로우 실행 큐 재설계, 동시 실행 안정성 향상
Node.js 18 → 20 전환: 커스텀 노드가 있다면 호환성 확인 필요

마이그레이션 주의사항

Function 노드의 일부 내장 모듈이 제거됨 → Code 노드로 대체
Credentials 암호화 키 형식 변경 — 기존 자격증명 재입력이 필요할 수 있음
Docker 이미지 업그레이드 전 볼륨 백업 필수

n8n AI Agent 노드 구성 — LLM, 메모리, 툴 연결 구조 — n8n 2.0 AI Agent 노드. 왼쪽에서 LLM 모델을, 아래에서 메모리와 툴을 연결하는 구조. 출처: n8n 공식 문서 (docs.n8n.io/advanced-ai)

운영 시 자주 막히는 포인트와 해결법

웹훅이 로컬에서 안 잡힐 때
로컬 n8n 인스턴스는 외부에서 직접 도달할 수 없다. 개발 중에는 ngrok http 5678로 임시 공개 URL을 만들고, n8n 환경변수 WEBHOOK_URL에 해당 URL을 설정하면 된다. 프로덕션에서는 리버스 프록시(Nginx) 뒤에 배치하고 HTTPS를 적용해야 한다.

LLM 응답이 JSON 파싱 오류를 낼 때
LLM 노드 출력은 기본적으로 텍스트다. 다음 노드에서 JSON으로 파싱하려면 LLM 프롬프트에 "반드시 유효한 JSON만 반환하라"고 명시하고, Code 노드에서 JSON.parse()를 try-catch로 감싸야 한다. n8n의 Set 노드에서 JSON 모드를 사용하면 파싱 에러를 줄일 수 있다.

워크플로우가 타임아웃될 때
기본 실행 타임아웃은 60초다. LLM 호출이 길거나 외부 API가 느리면 타임아웃이 발생한다. EXECUTIONS_TIMEOUT 환경변수로 늘릴 수 있다. 장시간 작업은 Sub-workflow로 분리하고 비동기 처리를 검토할 것.

n8n워크플로우 자동화AI 에이전트ZapierMakeLLM셀프호스팅오픈소스자동화노코드