n8n 설치부터 AI 워크플로우 만들기 — 노코드 자동화 실전 가이드

n8n이 뭔지 한 줄로 — "코드 없이 만드는 자동화 파이프라인"

n8n(에이트엔)은 오픈소스 워크플로우 자동화 도구입니다. "Gmail에 메일이 오면 → Claude에게 요약 시키고 → Slack에 전달해" 같은 자동화를 코드 없이 드래그 앤 드롭으로 만들 수 있습니다. Zapier나 Make와 비슷하지만, 무료 셀프 호스팅이 가능하고 실행 횟수 제한이 없다는 것이 결정적 차이입니다.

2026년 3월 기준 GitHub Star 68,000+, 400개 이상의 내장 연동(노드)을 제공합니다. 최근 MCP Tools 지원, 멀티 에이전트 채팅 등 AI 기능이 대폭 강화되었습니다. 이 글에서는 Docker로 설치하고, 실제로 "RSS → AI 요약 → Slack 전송" 워크플로우를 만들어봅니다.

Docker로 n8n 설치 — 5분이면 끝

n8n을 가장 간단하게 설치하는 방법은 Docker입니다.

Docker가 없다면 먼저 설치:

# macOS
brew install --cask docker

# Ubuntu/Debian
sudo apt update && sudo apt install -y docker.io docker-compose
sudo systemctl start docker

n8n 실행 (Docker 한 줄):

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  --restart always \
  n8nio/n8n

각 옵션의 의미:

-p 5678:5678       → 내 PC의 5678번 포트로 접속
-v n8n_data:...    → 워크플로우 데이터를 영구 저장
--restart always   → PC 재시작 시 자동 실행

접속 확인:

# 브라우저에서 접속
http://localhost:5678

첫 접속 시 관리자 계정을 만들라는 화면이 나옵니다. 로컬 전용이므로 이메일·비밀번호는 편한 것으로 설정하세요.

npm으로 설치하는 방법 (Docker 없이):

# Node.js 18+ 필요
npm install -g n8n

# 실행
n8n start

# 백그라운드 실행
n8n start &

n8n 기본 개념 — 노드와 워크플로우

n8n의 핵심 개념은 두 가지입니다.

노드(Node): 하나의 작업 단위입니다. "Gmail에서 메일 읽기", "Claude에게 텍스트 보내기", "Slack에 메시지 보내기"가 각각 하나의 노드입니다. 400개 이상의 내장 노드가 있고, HTTP Request 노드로 API가 있는 서비스는 뭐든 연결할 수 있습니다.

워크플로우(Workflow): 노드들을 순서대로 연결한 자동화 파이프라인입니다. 트리거 노드(시작점) → 작업 노드 → 작업 노드 → ... 순서로 연결합니다.

화면 왼쪽의 노드 패널에서 원하는 노드를 캔버스로 드래그하고, 노드 간 점을 연결하면 워크플로우가 완성됩니다.

실전 1 — RSS → Claude AI 요약 → Slack 전송

기술 블로그의 새 글이 올라오면 AI가 요약해서 Slack에 전달하는 워크플로우를 만듭니다.

노드 1: RSS Feed Trigger

캔버스에서 "+" 버튼 → "RSS Feed Trigger" 검색 → 추가. Feed URL에 원하는 RSS 주소를 입력합니다. Poll Times를 "Every Hour"로 설정하면 1시간마다 새 글을 확인합니다.

Feed URL: https://techcrunch.com/feed/
Poll Times: Every Hour

노드 2: Anthropic (Claude)

"+" → "Anthropic" 검색 → 추가. API Key를 입력하고 (console.anthropic.com에서 발급), 프롬프트를 설정합니다.

Model: claude-sonnet-4-6
Prompt:
다음 기술 블로그 글을 한국어로 3줄로 요약해줘.
제목과 핵심 내용, 실무 관점의 시사점을 포함해.

제목: {{ $json.title }}
내용: {{ $json.contentSnippet }}

{{ $json.title }}은 이전 노드(RSS)에서 받은 데이터를 참조하는 표현식입니다. n8n에서 데이터를 노드 간 전달할 때 이 문법을 사용합니다.

노드 3: Slack

"+" → "Slack" 검색 → 추가. Slack OAuth 토큰을 연결하고, 메시지를 설정합니다.

Channel: #tech-news
Message:
📰 *{{ $('RSS Feed Trigger').item.json.title }}*
{{ $json.text }}
🔗 {{ $('RSS Feed Trigger').item.json.link }}

워크플로우 활성화: 오른쪽 상단의 토글을 켜면 워크플로우가 활성화됩니다. 이제 매시간 RSS를 확인하고, 새 글이 있으면 AI 요약 → Slack 전송이 자동으로 실행됩니다.

실전 2 — Webhook으로 외부 서비스 연결

Webhook 노드를 트리거로 사용하면 외부에서 HTTP 요청을 보내 워크플로우를 실행할 수 있습니다.

# Webhook 노드 추가 후 생성되는 URL 예시
https://your-n8n-domain/webhook/abc123def456

# curl로 테스트
curl -X POST https://localhost:5678/webhook/abc123def456 \
  -H "Content-Type: application/json" \
  -d '{"text": "이 내용을 요약해줘", "channel": "#general"}'

이 URL을 GitHub Webhook, Stripe Webhook, 또는 다른 n8n 워크플로우에서 호출하면 자동화 체인을 만들 수 있습니다. 예를 들어 "GitHub에 PR이 올라오면 → Claude가 코드 리뷰 → Slack에 결과 전달"을 Webhook으로 구현할 수 있습니다.

AI 노드 활용 팁

n8n의 AI 노드는 단순 텍스트 생성 외에도 다양한 활용이 가능합니다.

AI Agent 노드: 2026년 기준 n8n에는 "AI Agent" 노드가 있어 도구(Tool)를 연결한 에이전트를 만들 수 있습니다. 예를 들어 Claude에게 "구글 캘린더 조회" 도구와 "Slack 메시지 전송" 도구를 연결하면, "오늘 일정을 확인하고 팀에게 알려줘"라는 프롬프트 하나로 두 가지 작업을 수행합니다.

Text Classifier 노드: 입력 텍스트를 AI로 분류합니다. 고객 문의를 "결제", "배송", "환불"로 자동 분류하여 각 담당자에게 라우팅하는 등의 활용이 가능합니다.

Summarization Chain: 긴 문서를 자동으로 청크(chunk)로 나누고, 각 청크를 요약한 후, 최종 요약을 생성합니다. PDF → 텍스트 추출 → 요약 체인 → 결과 저장 워크플로우를 만들 수 있습니다.

실천 팁: AI 노드에서 온도(Temperature)를 0.1~0.3으로 낮게 설정하면 매번 일관된 결과를 얻을 수 있습니다. 자동화에서는 창의적인 답변보다 예측 가능한 답변이 중요합니다.

트러블슈팅

오류 1: "Cannot connect to n8n" — 접속 안 됨

# Docker 컨테이너 상태 확인
docker ps | grep n8n

# 컨테이너가 꺼져 있으면 재시작
docker start n8n

# 로그 확인
docker logs n8n --tail 50

오류 2: 워크플로우가 실행 안 됨

워크플로우 오른쪽 상단의 토글이 "Active"(켜짐) 상태인지 확인하세요. 비활성 상태에서는 트리거가 동작하지 않습니다. "Test Workflow" 버튼으로 수동 실행하여 각 노드의 출력을 확인할 수 있습니다.

오류 3: API 키 오류 (Anthropic, Slack 등)

n8n 왼쪽 메뉴 → Credentials에서 해당 서비스의 API 키가 올바르게 입력되었는지 확인합니다. API 키에 앞뒤 공백이 포함되지 않았는지, 키가 만료되지 않았는지 체크하세요.

오류 4: 데이터가 다음 노드로 전달 안 됨

노드 실행 후 "Output" 탭에서 출력 데이터를 확인합니다. 다음 노드의 표현식({{ $json.필드명 }})에서 참조하는 필드명이 실제 출력의 필드명과 일치하는지 확인하세요. 필드명은 대소문자를 구분합니다.

n8n vs Zapier vs Make — 뭘 써야 하나

n8n: 무료 셀프 호스팅, 실행 횟수 무제한, 커스텀 코드 가능, AI 에이전트 지원. 단점은 서버를 직접 관리해야 한다는 점.

Zapier: 가장 쉬운 UI, 7,000+ 앱 연동. 하지만 무료 플랜은 월 100회 실행 제한, 유료는 월 $30+.

Make: Zapier보다 복잡한 로직 지원, 무료 플랜 월 1,000회. 유료 월 $10+.

결론: 자동화를 많이 돌리거나 AI 에이전트를 활용하려면 n8n 셀프 호스팅이 가성비 최강입니다. 간단한 자동화 1~2개만 필요하면 Zapier 무료 플랜으로 충분합니다.

이 글에 소개된 서비스와 도구는 작성 시점 기준이며, 업데이트에 따라 변경될 수 있습니다.