🔌 IN THIS CIRCUIT
시리즈 1~10에서 만든 모든 결과물들 — 카페 추천 앱, 랜딩 페이지, 콘텐츠 자동화. 이걸 "한 번 만들고 매일 자동 실행"으로 바꾸는 마법이 MCP + n8n입니다. 이 글은 둘이 무엇이고, 어떻게 연결하고, 본인 워크플로우를 어떻게 자동화하는지 단계별로 안내합니다.
안녕하세요, 봄내AI해적단 선장 이장환입니다. 시리즈 열한 번째 글이에요.
이 글은 사실 시리즈 전체에서 가장 기다려진 글입니다. 매번 "다음 글 예고"에 등장하면서 미뤄왔던 MCP 입문. 그것도 제 진짜 전문 분야인 n8n 자동화와 합쳐서요.
됩니다. 그게 바로 MCP + n8n의 영역입니다. 시리즈 №10까지의 모든 글이 "본인이 클로드와 함께 만드는 법"이었다면, 이번 글은 "클로드가 알아서 일하게 만드는 법"이에요.
각오해주세요. 이번 글은 시리즈 중 가장 진입 장벽이 높습니다. 하지만 한 번 익히면 본인의 일하는 방식이 완전히 바뀝니다. 매일 30분 걸리던 작업이 0분이 되는 마법.
⊙ 회로도 구성
9개 챕터. 1~3장은 개념, 4~6장은 셋업, 7~9장은 실전과 함정입니다.
MCP란? — USB-C 같은 표준 어댑터.
MCP (Model Context Protocol)는 Anthropic이 2024년에 공개한 표준 프로토콜입니다. 한 줄로 정의하면:
🔌 한 줄 정의
"Claude (AI 모델)와 외부 도구·데이터를 연결하는 표준 어댑터. USB-C가 모든 기기를 연결하듯, MCP가 모든 도구를 Claude에 연결한다."
MCP 전후 비교
😩 MCP 이전
- 각 AI 모델마다 다른 통합 방식
- 도구마다 직접 API 코드 작성
- 한 도구 = 한 통합 = 100시간
- 다른 모델로 바꾸면 다시 작성
🎉 MCP 이후
- 모든 AI 모델이 같은 프로토콜
- 표준 MCP 서버 한 번이면 끝
- 설치 명령어 한 줄
- 커뮤니티 MCP 수백 개 사용 가능
MCP가 연결하는 3가지
파일 읽기, GitHub 이슈 만들기, n8n 워크플로우 실행 등의 "행동"
DB 데이터, 문서 내용, Notion 페이지 등의 "정보"
자주 쓰는 작업 템플릿. 재사용 가능한 "스크립트"
💡 핵심 통찰
MCP는 본인 도구가 아닙니다. "클로드가 본인 도구를 쓰게 만드는 통로"입니다. 본인이 Slack에 메시지를 보내려고 Slack API를 배우는 게 아니라, "Slack에 메시지 보내줘"라고 클로드한테 말하면 끝.
n8n — 자동화 워크플로우의 본질.
n8n(엔에이트엔)은 노드 기반 워크플로우 자동화 도구입니다. "Zapier의 오픈소스 형제" 정도로 생각하시면 됩니다. 600개 이상의 통합 + 셀프 호스팅 + 무료.
노드 기반 워크플로우란?
각 작업을 "노드"로 만들고, 노드들을 화살표로 연결해서 자동화를 만듭니다. 코딩 없이 시각적으로.
EXAMPLE WORKFLOW
매일 아침 9시에 뉴스를 받아 AI로 요약하고 단톡방에 자동 전송
n8n의 4가지 매력
본인 컴퓨터/서버에 설치하면 평생 무료. 클라우드 버전도 저렴.
Slack, Notion, Google, OpenAI, Telegram, Supabase 등 모든 도구.
드래그 앤 드롭으로 워크플로우 만들기. 코딩 0%도 가능.
필요하면 직접 코딩도 가능. 클로드가 짜주면 더 좋고.
왜 둘을 합치는가 — 시너지의 핵심.
"MCP만 써도 되고, n8n만 써도 되잖아요?" 맞습니다. 그런데 합치면 차원이 다른 일이 가능해져요.
각각의 한계와 합쳤을 때의 시너지
대화형 자동화. 본인이 매번 클로드에게 요청해야 함.
정해진 자동화. 변경 시 본인이 노드 수정해야 함.
자연어로 복잡한 자동화를 트리거 / 수정 / 실행. "매일 아침 9시에 뉴스 모아서 단톡방에 보내는 자동화 만들어줘" 한 마디면 끝.
실제 가능해지는 3가지 시나리오
📰 1. 매일 뉴스 큐레이션
매일 아침 9시 → AI 관련 뉴스 자동 수집 → Claude가 한국어 요약 → 단톡방 자동 전송. 본인은 커피만 마시면 됨.
📝 2. 콘텐츠 파이프라인
트렌드 검색 → Claude 분석 → 블로그 초안 작성 → Notion 자동 저장 → 단톡방 알림. 장환님의 실제 워크플로우입니다.
🛒 3. 비즈니스 자동화
새 주문 → Stripe 알림 → Claude가 고객 이메일 작성 → Gmail로 전송 → Supabase에 기록. 1인 사업자의 비서.
n8n 설치 — 3가지 방법.
n8n을 시작하는 3가지 방법. 본인 상황에 따라 하나만 고르세요.
🌐 방법 A — n8n Cloud
가장 쉬운 방법. 설치 없이 바로 사용. 14일 무료 체험 후 월 $20~.
- n8n.io 접속 → "Get started for free" 클릭
- 이메일 가입 → 워크스페이스 이름 정하기
- 본인의 n8n 인스턴스 URL 발급 (예:
jangwhan.app.n8n.cloud) - 바로 시작 가능
🐳 방법 B — Docker 셀프호스팅
본인 컴퓨터에 Docker로 설치. 완전 무료, 데이터도 본인 소유. 봄내AI해적단 멘티들에게 가장 추천.
전제 조건: Docker Desktop 설치 (docker.com)
$ mkdir ~/n8n-data && cd ~/n8n-data
# Docker로 n8n 실행 (한 줄)
$ docker run -d --name n8n \
-p 5678:5678 \
-v ~/n8n-data:/home/node/.n8n \
n8nio/n8n
브라우저에서 http://localhost:5678 접속 → 첫 계정 만들기 → 시작!
📦 방법 C — npm 글로벌
Node.js가 이미 있다면 가장 간단:
$ n8n start
단점: Node 버전 호환 문제 가능. Docker가 더 안정적.
첫 화면 — 무엇을 보게 되나
n8n에 접속하면 Workflows 페이지가 나옵니다. 다음을 확인:
- 좌측 사이드바: Workflows / Credentials / Templates
- "+ Add workflow" 버튼 — 새 워크플로우 만들기
- Templates — 시작용 예시 200+ 개 무료 제공
Claude Code에 MCP 서버 추가하기.
이제 본격적으로 MCP를 Claude Code에 연결합니다. 가장 쉬운 명령어는 claude mcp add입니다.
MCP 서버 추가 — 한 줄 명령어
가장 인기 있는 MCP 서버 몇 개를 추가해봅시다. 터미널에서:
$ claude mcp add filesystem \
-- npx -y @modelcontextprotocol/server-filesystem ~/projects
# GitHub 통합 (이슈, PR, 레포 관리)
$ claude mcp add github \
-- npx -y @modelcontextprotocol/server-github
# Supabase (시리즈 №6에서 셋업했다면)
$ claude mcp add supabase \
-- npx -y @supabase/mcp-server-supabase
설치 확인
Claude Code 안에서:
# 결과 예시
MCP Servers (3):
✅ filesystem (connected)
✅ github (connected)
✅ supabase (connected)
초록 체크가 보이면 연결 성공. 빨간 X가 보이면 다음 박스를 확인하세요.
⚠️ 연결 실패 트러블슈팅
- "Authentication required" · 환경 변수로 API 토큰 설정 필요 (예: GITHUB_TOKEN)
- "npx not found" · Node.js 미설치. nodejs.org에서 설치
- "Connection refused" · MCP 서버 자체에 문제.
claude mcp remove [이름]후 다시 add
환경 변수가 필요한 경우
GitHub 같은 도구는 API 토큰이 필요해요. --env 옵션으로 전달:
--env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx \
-- npx -y @modelcontextprotocol/server-github
사용 예시 — 자연어로
설치 후 Claude Code 안에서 자연어로 시키면 됩니다:
└ 클로드가 GitHub MCP를 통해 직접 이슈를 만듭니다. 본인이 GitHub 웹을 열 필요 없음.
n8n MCP 서버 연결 — 핵심 단계.
이 장이 이번 글의 핵심입니다. Claude Code ↔ n8n을 연결하는 단계.
n8n에서 API 키 만들기
Claude Code에 n8n MCP 서버 등록
커뮤니티가 만든 n8n-mcp 서버가 있습니다. 가장 잘 되는 옵션 중 하나:
$ claude mcp add n8n \
--env N8N_API_URL=http://localhost:5678 \
--env N8N_API_KEY=your_n8n_api_key_here \
-- npx -y n8n-mcp
N8N_API_URL은 본인 n8n 인스턴스 주소예요:
- 로컬 Docker:
http://localhost:5678 - n8n Cloud:
https://본인이름.app.n8n.cloud - 자체 서버: 본인 도메인
연결 테스트
Claude Code 안에서:
클로드가 n8n MCP를 통해 본인 워크플로우 목록을 가져옵니다. 이 응답이 오면 연결 성공:
1. (활성) Daily News Summary
2. (비활성) Test Workflow
...
⚡ 이 순간이 매우 중요
연결이 성공하면 이제 자연어로 n8n을 조종할 수 있습니다. 워크플로우 생성, 수정, 실행, 결과 분석 — 모든 게 클로드와의 대화로 가능. 이게 본인이 시리즈를 통해 도달한 최종 단계입니다.
첫 자동화 — RSS → Telegram.
이론은 됐고, 실전입니다. "AI 관련 뉴스를 매일 단톡방으로 받는 자동화"를 처음부터 만들어봅시다.
사전 준비
- ✓ n8n이 실행 중 (방법 A or B로 설치 완료)
- ✓ Claude Code에 n8n MCP 등록 완료
- ✓ Telegram 봇 생성 + 봇 토큰 + chat_id 확보 (BotFather에서 5분 안에 만들 수 있음)
- ✓ Anthropic API 키 (n8n에서 Claude 호출용)
한 줄로 클로드에게 시키기
Claude Code에서 다음 프롬프트:
클로드가 자동으로 n8n에 워크플로우를 만듭니다. 본인은 노드 하나하나 드래그 안 해도 됩니다.
완성된 워크플로우 검증
클로드가 만든 워크플로우를 n8n 웹에서 열어보세요:
생성된 워크플로우
테스트 실행
워크플로우 우측 상단의 "Test workflow" 버튼 클릭. 노드들이 차례로 초록색이 되면서 실행됩니다. Telegram에서 메시지가 도착하면 성공!
봄내AI해적단 콘텐츠 파이프라인.
장환님이 매일 실제로 굴리는 "콘텐츠 파이프라인"의 단순화 버전입니다. 트렌드 검색 → 분석 → 초안 → 알림의 전체 흐름.
콘텐츠 자동화 회로
매일 아침 7시 — 잠자는 동안 본인의 블로그 초안이 자동으로 준비
클로드에게 한 번에 요청하기
실행 결과 — 다음 날 아침
07:00 · 자동화 실행 시작 (본인은 자고 있음)
07:00:15 · RSS 3개 피드에서 47개 글 수집
07:00:18 · 24시간 이내 12개로 필터링
07:00:35 · Claude가 3개 글감 선정
07:01:20 · Claude가 1번 글감으로 초안 작성 (1,000자)
07:01:25 · Notion "Blog Drafts" DB에 새 카드 추가
07:01:27 · Telegram 단톡방에 알림: "오늘의 초안 준비 완료 ☕"
⏱️ 총 소요 시간: 87초. 본인이 일어나서 커피 마실 때, 이미 초안이 기다리고 있습니다.
💡 핵심 · 이 워크플로우가 매일 자동 실행되면, 1년이면 365개 초안이 쌓입니다. 그중 좋은 50개만 다듬어 발행해도 한 달에 4개 글이 자동으로 만들어지는 셈. 이게 자동화의 진짜 힘이에요. 본인의 시간을 본질적인 작업(편집, 개인 경험 추가, 발행)에만 쓰게 됩니다.
자주 만나는 함정 6가지.
MCP + n8n 조합을 굴리다 보면 만나는 6가지 함정. 미리 알면 대처가 빨라요.
🔐 API 키 노출 — 가장 위험
증상: n8n API 키, Anthropic 키, Telegram 봇 토큰이 워크플로우 JSON에 평문으로 저장됨.
해법: n8n의 Credentials 기능 사용. 키를 코드에 직접 안 적고, Credentials에 저장 후 노드가 참조. 백업 시에도 안전.
💸 토큰 비용 폭증 — Claude API
증상: 매시간 워크플로우 실행하다 보니 한 달에 수십만원 청구.
해법: ① 실행 주기를 적정선으로 (매시간 → 매일) ② 비싼 작업은 Haiku 모델 ③ n8n에서 토큰 한도 설정 ④ 매주 사용량 모니터링.
🔌 MCP 연결 끊김
증상: /mcp 했더니 빨간 X. 어제까지 됐는데.
해법: ① n8n이 실행 중인지 확인 (Docker라면 docker ps) ② API 키 만료 확인 ③ 안 되면 claude mcp remove n8n 후 다시 add.
🐛 워크플로우 조용한 실패
증상: 자동화가 멈췄는데 본인이 모름. 알림이 며칠째 안 와도 깨달음이 늦음.
해법: n8n의 Error Trigger 워크플로우 만들기. 메인 워크플로우 실패 시 본인에게 Telegram 알림. "데드맨 스위치" 패턴.
🌐 RSS 피드가 변경됨
증상: 외부 RSS/API의 형식이 바뀜. 클로드가 짠 파싱 코드가 깨짐.
해법: Error Trigger로 실패 알림 받고 → 클로드에게 "이 RSS 응답 형식이 바뀐 것 같아. 파싱 코드 수정해줘". 외부 의존은 깨질 수 있음을 받아들여요.
🔄 무한 루프 — 자동화가 자동화를 부름
증상: Telegram 알림 받기 → 그게 다시 트리거 → 무한 반복.
해법: 트리거에 필터 조건 추가. "본인이 보낸 메시지는 무시" 같은. 또는 n8n의 실행 횟수 제한 설정.
🏴☠️ 봄내AI해적단 멘티들에게
이번 주 미션 — 3단계:
- n8n 셋업 (Docker 또는 Cloud) + 첫 화면 진입
- Claude Code에 MCP 한 개 추가 (filesystem 추천)
- n8n 템플릿 한 개 찾아서 그대로 따라 실행해보기 — "Hello World" 수준
7장의 RSS→Telegram이 어렵다면, n8n Templates에서 더 간단한 것부터 시작해도 OK. 중요한 건 "한 번 동작하는 자동화를 본인 손으로 만드는 경험"입니다.
막히면 단톡방에 스크린샷 + 에러 메시지. 같이 풀어요. 봄내AI해적단의 다음 모임 주제는 "각자 만든 자동화 자랑하기"로 정해두겠습니다.
— 바이브 코딩 시리즈 전체 인덱스 (11편 완성)
→ 다음 회차 예고 (시리즈 마지막)
실전 다중 MCP 통합 — "1인 비서 시스템" 만들기 · 여러 MCP 서버(GitHub + Notion + Slack + n8n)를 동시에 굴려 본인만의 AI 비서를 구축하는 법. 시리즈 №12로 마무리 예정.
Issue №11 · Automation Circuit · MCP + n8n
이장환 · 봄내AI해적단 선장 · 춘천 · 2026
참고: MCP 공식 · n8n · Claude Code MCP 문서
