클로드 코드로 n8n 설치부터 뉴스레터 자동화까지
2026.10.15
클로드 코드(Claude Code)로 n8n을 설치하고, 구글 뉴스를 제미나이로 요약해 매일 지메일로 보내는 워크플로를 만들었어요. 2026년 10월 8일, 처음 써 보는 n8n을 94분 만에 설치부터 워크플로까지 끝냈습니다.
뉴스 수집, AI 요약, 메일 발송을 n8n 하나로 묶은 업무 자동화 사례입니다. 설치에서 걸린 Node 버전 문제, n8n 스킬 연동, MCP 연결 승인에서 막힌 장면까지 순서대로 적었습니다.
자동화 도구를 배우려고 시작
스타트업 창업자이자 지피터스 24기 업무자동화 멤버 미라클스톤이에요. 자동화 도구를 직접 배우고 일에 써 보려고, 이번에 n8n을 처음 설치했습니다. 작업은 클로드 코드 데스크톱 앱에서 클로드 오푸스 5.5(Claude Opus 5.5)로 했습니다.
첫 요청은 공식 문서 주소 하나를 주고 설치를 맡기는 것이었습니다.
https://docs.n8n.io/deploy/host-n8n 문서를 참고해서 npm으로 내 컴퓨터에 n8n을 설치해줘
npm은 노드(Node.js)용 프로그램을 내려받아 설치하는 도구입니다. n8n 문서는 도커(Docker) 설치를 먼저 권하지만, 저는 컴퓨터에 바로 까는 npm 방식으로 갔습니다.
n8n을 npm으로 설치한 순서
n8n은 npm 설치 전에 Node 버전부터 맞춰야 했습니다. 문서는 npm 설치에 Node.js 20.19부터 24.x까지를 요구하는데, 제 맥의 기본 Node는 26이었습니다(n8n npm 설치 문서, 2026년 10월 8일 기준).
그래서 Node 24를 따로 깔고, n8n 명령만 늘 Node 24로 돌게 실행 파일을 하나 두었습니다. 평소 쓰는 node 명령은 26 그대로입니다. 근데 Node 24를 까는 동안 Homebrew가 공용 라이브러리를 업데이트하면서 기존 Node 26이 잠깐 실행되지 않았습니다. Node를 같은 26 버전 안에서 26.11.0으로 올려 바로 복구했습니다.
설치 자체는 금방 끝났습니다. 패키지 2,311개가 2분 만에 들어왔고, 설치 폴더는 2.5GB였습니다. 버전은 n8n 2.42.5입니다. 첫 실행 때 데이터베이스 준비 작업이 한참 지나간 뒤 이렇게 떴습니다.
Version: 2.42.5
Editor is now accessible via:
Press "o" to open in Browser.(가운데 몇 줄과 주소 줄은 줄였습니다.)
안내된 주소는 내 컴퓨터의 5678번 포트이고, 브라우저로 열면 관리자 계정을 만드는 화면이 나옵니다. 제가 터미널에서 직접 다시 띄웠을 때는 끝에 'ㅐ'가 하나 찍혀 있었습니다(한글 자판에서 'o' 자리를 누르면 'ㅐ'가 나옵니다).
같은 문서에는 npm 설치가 n8n 3.0부터 지원 중단(deprecated)된다고 적혀 있습니다. 실행 로그에도 앞으로는 도커 실행이 필요해진다는 안내가 나왔습니다. 그래서 이 설치는 배우고 시험하는 용도로만 쓰는 중이에요.
n8n 스킬은 따로 넣어야 했다
n8n을 설치해도 클로드 코드의 스킬 목록에 n8n 스킬은 생기지 않았습니다.
n8n 스킬이 안 보이는 이유는 뭐야?
클로드 코드는 스킬을 세 곳에서만 읽습니다. 개인 스킬 폴더(~/.claude/skills/), 프로젝트 폴더 안의 .claude/skills/, 설치한 플러그인입니다. n8n은 내 컴퓨터에서 도는 자동화 서버라서 스킬과는 따로였습니다. 플러그인 디렉터리에서 n8n 관련 커뮤니티 플러그인 두 개를 추천받았는데, 설치 카드가 화면에 뜨지 않아 그냥 넘어갔습니다.
다음으로 쓰고 싶던 스킬 이름을 그대로 물었습니다.
n8n-workflow-builder 스킬 좀 찾아줘봐
이 이름의 클로드 스킬은 내 컴퓨터, claude.ai 스킬 목록, 플러그인 디렉터리 어디에도 없었습니다. 깃허브에 같은 이름의 저장소가 있었지만 스킬이 아니라 MCP 서버였습니다.
결국 갖고 있던 스킬 압축 파일(n8nwb.zip)을 넘겨 ~/.claude/skills/n8n-workflow-builder/에 넣었습니다. 압축 안에는 설명서(SKILL.md)와 설정 예시(.env.example) 두 파일뿐이었고, 실행되는 스크립트는 없었습니다.
이 스킬은 n8n-mcp라는 MCP 서버로 n8n을 조작합니다. MCP는 AI에 도구를 꽂는 규격이에요. 스킬 문서대로 ~/AI/projects/n8n 폴더를 만들어 MCP 설정 파일(.mcp.json)을 두고, n8n에서 만든 API 키는 스킬 폴더의 .env에 넣었습니다.
처음 써 보는 n8n으로 94분 만에 워크플로
워크플로는 노드 7개로 만들었습니다. 스킬을 불러 이렇게 시켰습니다.
매일 아침 10시에 '마케팅' 키워드로 구글 뉴스를 검색해서, 최근 24시간 뉴스를 제미나이 3.8로 요약하고, 뉴스레터 형태로 내 지메일에 보내주는 n8n 워크플로우를 만들어줘
스킬은 템플릿을 고르기 전에 비용과 보안부터 따지게 되어 있습니다. n8n 템플릿 라이브러리에서 비슷한 것을 찾아보니, 유료 크롤링 서비스를 쓰는 템플릿은 비용 점검에서 빠지고 두 개가 남았습니다. 둘 다 고칠 곳이 많아서 처음부터 조립하는 쪽을 골랐습니다. 제미나이 요약은 쓴 만큼 요금이 나가는 단계라 넣을지 따로 확인받았고, 넣기로 했습니다. '제미나이 3.8'은 gemini-3.8-flash 모델로 잡았습니다.
권한도 하나 바꿨습니다. 설치된 n8n 2.42.5의 지메일 노드는 연결할 때 https://mail.google.com/ 권한을 요청하는데, 메일 읽기와 삭제까지 되는 전체 권한입니다. 뉴스레터는 보내기만 하면 되니 HTTP Request 노드에 gmail.send 권한만 준 OAuth2 연결로 바꿨어요.
구글 클라우드에서 OAuth 클라이언트를 만들 때는 '승인된 리디렉션 URI'를 물어봅니다. 내 컴퓨터의 n8n 주소 뒤에 /rest/oauth2-credential/callback을 붙인 값이고, n8n 자격증명 화면의 OAuth Redirect URL 칸에 나오는 주소를 그대로 복사하면 됩니다.
완성된 순서는 이렇습니다.
매일 오전 10시: 한국 시간(Asia/Seoul) 기준으로 실행
설정: 키워드, 받는 주소, 최대 기사 수(20건)를 한곳에서 바꿈
구글 뉴스 RSS: '마케팅 when:1d'를 한국어 뉴스로 검색
기사 정리: 24시간 안 기사만 남기고 중복을 빼서 20건으로
Gemini 뉴스레터 요약: 헤드라인에 없는 내용은 쓰지 말고 근거 기사 번호를 붙이게 함
메일 만들기: 요약과 원문 링크로 HTML 뉴스레터를 만듦
Gmail 발송:
gmail.send권한으로 보냄
그때는 n8n MCP가 아직 연결되지 않아서, 점검은 n8n 안에 들어 있는 워크플로 검사 도구로 대신했습니다. 노드 7개가 모두 통과했고, 실제 구글 뉴스 결과로 돌려 보니 '마케팅' 기사 100건에서 20건이 골라졌습니다. 받는 주소를 비워 두면 "'설정' 노드의 recipient에 뉴스레터를 받을 이메일 주소를 입력하세요"라는 안내가 뜨게 해 두었습니다.
클로드 코드 MCP 승인에서 막힌 곳
API 키를 넣고 n8n 폴더에서 클로드 코드를 다시 열었는데, n8n MCP가 꺼진 채로 시작했습니다. 터미널에 이런 선택 창이 먼저 떴습니다.
New MCP server found in this project: n8n
Use this MCP server
Use this and all future MCP servers in this project
❯ Continue without using this MCP(안내 문장은 줄였습니다.)
커서가 처음부터 맨 아래 'Continue without using this MCP'에 놓여 있어서, 그대로 Enter를 누르면 연결이 꺼진 채로 저장됩니다. 게다가 그 터미널 탭은 API 키를 넣기 전에 열어 둔 탭이라 키도 비어 있었습니다. 그래서 이렇게 말했습니다.
설정을 지우고 다시 하자
프로젝트 설정 파일(.claude/settings.local.json)에서 n8n을 끄는 줄을 지우고, 새 탭에서 source ~/.zshrc로 키를 다시 불러온 뒤 claude를 다시 실행했습니다. 이번에는 방향키 ↑로 'Use this MCP server'를 고르자 n8n-mcp가 바로 실행됐습니다. 이 폴더를 신뢰한 폴더로 등록하지 않아서, 다음에 열 때도 같은 창이 다시 뜰 수 있습니다.
한 번 더 헷갈린 곳은 클로드 앱의 커넥터 화면이었습니다.
mcp 목록에 없는데 이 화면 가서 뭘 넣어야 해?
▲ 클로드 앱 설정의 커넥터 메뉴에 있는 n8n 연결 화면, 서버 URL 칸에 https 주소를 넣게 되어 있다
이 화면은 인터넷에서 접속할 수 있는 n8n(예: n8n 클라우드)을 클로드 서버가 직접 부르는 연결이라, 내 맥 안에서만 열리는 n8n 주소는 넣을 수 없습니다. 그래서 취소했습니다. .mcp.json으로 만든 n8n MCP는 앱의 커넥터 목록이 아니라, 그 폴더에서 연 클로드 코드 세션에서만 보입니다.
아직 확인하지 못한 것
뉴스레터 메일이 실제로 들어오는지는 아직 확인하지 못했습니다. n8n 화면에서 제미나이 노드만 먼저 실행해 봤는데 이렇게 실패했습니다.
▲ n8n 제미나이 노드에서 gemini-3.8-flash 호출이 Service unavailable 오류로 실패한 화면
Service unavailable - try again later or consider setting this node to retry automatically (in the node settings)
This model is currently experiencing high demand. Spikes in demand are usually temporary. Please try again later.구글 쪽에 요청이 몰려 잠시 거절된 것이라, 워크플로나 키 문제는 아니었습니다. 매일 10시 실행에 대비해 이 노드의 Settings에서 Retry On Fail을 켜고 Max Tries는 5, Wait Between Tries는 5000으로 두면 됩니다. 설치된 n8n은 재시도를 최대 5번, 간격은 최대 5초까지만 받습니다.
남은 것도 적어 둡니다.
n8n이 터미널 탭에서 돌고 있어서, 10시에 맥이 꺼져 있거나 탭이 닫혀 있으면 그날 메일은 오지 않습니다.
구글 뉴스 RSS에는 기사 본문이 없고 제목과 언론사만 있어요. 그래서 요약도 헤드라인 수준입니다.
지메일 연결(OAuth2)은 만드는 중이었고, 메일이 오는지는 그다음에 확인할 차례입니다.
n8n 뉴스레터는 이렇게 시키면 돼요
처음 요청에 중간에 고른 조건을 합쳐 두면 이렇습니다.
매일 아침 [10시]에 '[키워드]'로 구글 뉴스를 검색해서 최근 24시간 기사만 골라 줘.
[gemini-3.8-flash]로 헤드라인만 근거로 요약하고, 기사 번호와 원문 링크를 붙여 줘.
뉴스레터 형태로 지메일에 보내되, 지메일 권한은 발송(gmail.send)만 써 줘.
받는 주소는 내가 n8n에서 직접 넣을게.설치부터 한다면 n8n이 요구하는 Node 버전과 내 컴퓨터의 Node 버전을 먼저 비교해 달라고 하세요. 다르면 기존 Node는 그대로 두고 n8n용 Node만 따로 깔아 달라고 하면 됩니다. 저는 이 과정에서 기존 Node가 잠깐 멈췄으니, 설치가 끝나면 원래 쓰던 Node 버전이 그대로 도는지도 확인해 달라고 하세요.




처음 써 보는 n8n을 94분 만에 설치부터 워크플로까지 끝낸 기록이 시간까지 적혀 있어 믿음이 가요. 기본 Node가 26이라 Node 24를 따로 깔고 n8n 명령만 24로 돌게 실행 파일을 둔 해결이 깔끔하고, 그 과정에서 Homebrew 때문에 Node 26이 잠깐 멈췄다가 복구한 이야기도 솔직해서 좋았어요.
n8n을 설치해도 클로드 코드 스킬 목록에 n8n 스킬이 생기지 않는다는 점, 스킬을 읽는 세 곳을 정리해 주신 부분은 같은 데서 막힐 분들께 큰 도움이 될 것 같아요. npm 설치가 3.0부터 지원 중단된다는 점까지 확인해 "배우는 용도"로 선을 그은 것도 현명합니다. 뉴스레터가 매일 도착하는 모습, 응원할게요 🐈⬛