본문으로 건너뛰기

클로드 코드와 n8n을 이용한 업무자동화 스터디 1주차 후기

칼로스

2026.10.01

시도하고자 했던 것과 그 이유

Claude Code와 n8n으로 업무 자동화 스터디를 시작하면서, 오늘은 첫 단계로 두 도구를 설치하고 서로 연결하는 것까지 해 보았습니다.

n8n은 "메일이 오면 → 내용을 정리해서 → 시트에 저장"처럼 반복되는 일을 블록을 이어 붙여 자동화하는 도구입니다. 블록을 하나하나 직접 이어 붙이는 대신, Claude에게 말로 부탁하면 Claude가 n8n 안에서 자동화를 대신 만들어 주게 하고 싶었습니다. 이렇게 하려면 먼저 Claude와 n8n이 서로 대화할 수 있게 연결해 두어야 합니다.

저는 코딩을 거의 모르는 초보입니다. 그래서 명령어 입력은 최대한 Claude에게 맡기고, 저는 화면에서 버튼만 누르는 방식으로 진행했습니다.

## 진행 방법

사용한 도구

| 도구 | 역할 |

|---|---|

| Claude 데스크톱 앱 (Code 탭) | 명령어 실행과 문제 해결을 맡아 준 AI 도우미 |

| Docker | n8n을 내 컴퓨터에서 돌려 주는 프로그램 |

| n8n | 업무 자동화 도구 (`http://localhost:5678`에서 접속) |

| n8n-mcp | Claude가 n8n을 조작할 수 있게 이어 주는 연결 도구 |

1단계: n8n 설치 (Docker 이용)

Docker로 n8n을 내 컴퓨터에 설치하고, 브라우저에서 localhost:5678로 들어가 관리자 계정을 만들었습니다.

- 사용한 프롬프트: [설치를 부탁할 때 쓰신 문장을 넣어 주세요]

2단계: n8n API 키 발급

n8n 화면에서 Settings → n8n API → Create an API key로 들어가 API 키(Claude가 n8n에 들어갈 때 쓰는 출입증 같은 긴 암호)를 발급받았습니다. 메뉴 이름은 n8n 버전에 따라 조금 다를 수 있습니다.

- [캡처: API 키 발급 화면. 키 값은 꼭 가리고 올려 주세요]

3단계: Claude와 n8n 연결

작업 폴더(`C:\Users\Admin\n8n`)에 .mcp.json이라는 설정 파일을 만들었습니다. 이 파일에는 "n8n 주소는 여기고, 출입증은 이것이다"라는 내용이 들어갑니다.

- 사용한 프롬프트: [연결 설정을 부탁할 때 쓰신 문장을 넣어 주세요]

4단계: 연결 확인 → 문제 발견 → 해결

연결이 잘 됐는지 확인하려고 Claude에게 이렇게 물었습니다.

```

n8n 연결 상태 확인해줘

```

Claude가 세 가지를 차례로 확인해 주었습니다.

| 확인 항목 | 결과 |

|---|---|

| n8n 프로그램이 켜져 있나? | ✅ 정상 |

| localhost:5678 주소가 응답하나? | ✅ 정상 |

| Claude ↔ n8n 연결이 되나? | ❌ 막힘 |

n8n은 잘 켜져 있었는데, 연결 도구의 보안 기능이 내 컴퓨터 안 주소(localhost)로 들어가는 것을 기본으로 막고 있었습니다. 원래는 외부의 나쁜 요청을 막는 기능인데, n8n이 내 컴퓨터 안에 있을 때는 오히려 걸림돌이 됩니다.

Claude가 설정 파일에 한 줄(`WEBHOOK_SECURITY_MODE`)을 넣어서 해결해 주었습니다. 보안 기능을 끄는 게 아니라, 내 컴퓨터 주소만 허용하는 "보통" 단계로 낮춘 것입니다.

최종 설정 파일은 다음과 같습니다. API 키는 가렸습니다.

```json

{

"mcpServers": {

"n8n-mcp": {

"command": "cmd",

"args": ["/c", "npx", "-y", "n8n-mcp"],

"env": {

"MCP_MODE": "stdio",

"LOG_LEVEL": "error",

"DISABLE_CONSOLE_OUTPUT": "true",

"N8N_API_URL": "http://localhost:5678",

"WEBHOOK_SECURITY_MODE": "moderate",

"N8N_API_KEY": "여기에_발급받은_API_키"

}

}

}

}

```

설정을 고친 뒤 Claude 앱을 완전히 껐다가 다시 켰습니다. 그리고 다시 확인해 보니 연결 정상이 나왔습니다.

## 결과와 배운 점

결과

Claude Code와 n8n 연결에 성공했습니다. 이제 Claude에게 말로 부탁하면 n8n 안에서 자동화 흐름을 만들고, 고치고, 실행할 수 있는 상태가 되었습니다.

배운 점과 꿀팁

1. "켜져 있다"와 "연결됐다"는 다릅니다. n8n이 잘 돌아가도 Claude와는 연결이 안 되어 있을 수 있습니다. 설치가 끝나면 꼭 "n8n 연결 상태 확인해줘"라고 한 번 물어보세요.

2. localhost에서 막히면 설정 한 줄로 해결됩니다. n8n을 내 컴퓨터에 설치했다면 .mcp.json의 env에 "WEBHOOK_SECURITY_MODE": "moderate"를 넣어 주세요.

3. 설정을 고친 뒤에는 앱을 "완전히" 다시 켜야 합니다. 창의 X 버튼만 누르면 앱이 뒤에서 계속 돌아갑니다. 작업 표시줄 오른쪽 아래 ^ 버튼 → Claude 아이콘 오른쪽 클릭 → 종료까지 해야 새 설정이 적용됩니다.

4. API 키는 절대 그대로 공유하지 마세요. 사례글이나 캡처를 올릴 때는 꼭 가려 주세요.

5. 초보라면 "한 단계씩, 쉬운 말로"를 미리 부탁해 두세요. Claude의 기본 지침 파일에 "전문용어 쓰지 말기, 한 단계씩 진행하기"를 적어 두었더니 따라가기가 훨씬 쉬웠습니다.

  1. 어떤 일을 자동화 해야 할까? 고민을 많이 하게 되는데... 파트장님이 알려주신 프롬프트를 이용해서 심층인터뷰를 진행한 것이 매우 인상깊었습니다. 회사에서 직원들에게 그대로 적용하면 자동화 대상 업무를 선정하는데 많은 도움이 될 것 같습니다.^^

시행착오

- 처음 연결 확인 때 "localhost 접근이 막혔다"는 오류가 나왔습니다. n8n이 꺼진 줄 알았는데, 실제 원인은 연결 도구의 보안 설정이었습니다.

- 설정을 고치고 앱을 다시 켰는데도 똑같은 오류가 났습니다. Claude가 연결 도구가 켜진 시각(22:11)과 설정 파일을 고친 시각(22:13)을 비교해 보더니, 도구가 옛 설정 그대로 돌고 있다는 것을 찾아냈습니다. 창만 닫고 앱은 완전히 끄지 않았던 것이 원인이었습니다. 앱을 완전히 종료한 뒤에야 해결됐습니다.

도움이 필요한 부분

앞으로의 계획

다음 주부터 본격적으로 n8n 워크플로우 작성하는 법을 배울것 같네요. 기대됩니다.

## 도움 받은 글 (옵션)

- n8n-mcp 공식 안내 (GitHub): https://github.com/czlonkowski/n8n-mcp

- [참고하신 지피터스 글이 있으면 링크를 넣어 주세요]

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.01

칼로스님, 안녕하세요! 설치에서 연결 확인까지 한 단계씩 따라갈 수 있게 정리해 주셔서 읽기 편했어요.

특히 "localhost 접근이 막혔다"는 오류가 n8n이 아니라 연결 도구의 보안 설정 때문이었다는 걸 찾아낸 대목이 좋았어요. 설정을 고치고도 같은 오류가 나서 도구가 켜진 시각(22:11)과 파일을 고친 시각(22:13)을 비교해 앱을 완전히 종료하지 않은 게 원인임을 짚어낸 과정은 다른 분들께도 바로 쓸모가 있을 것 같아요.

하나만 덧붙이면, 1단계·3단계의 "사용한 프롬프트" 칸과 2단계 캡처 자리에 안내 문구가 그대로 남아 있어요. 실제 프롬프트를 채워 주시면 따라 하는 분들이 훨씬 수월할 거예요.

다음 주 워크플로우 실습 후기도 기대할게요. 꼬리 탁! 치고 응원하고 갑니다 🐈‍⬛

라

앟ㅎㅎ 사업자동화 스터디신줄알고 ㅎㅎㅎ 제가 답글을 썼네요
업무자동화 화이팅입니다!
참고 - 태그가 지금 '사업자동화'로 되어있어요!

벌써 Claude Code와 n8n 연결에 성공하셨다니, 실행력에 큰 박수 드립니다! 👏
AI에게 맡겨서 하나씩 풀어가는 방법을 잘 익혀가고 계신 것 같아 정말 기쁘네요.

"켜져 있다 ≠ 연결됐다"에서 특히 많이 막히셨던 것 같아요. localhost 보안 설정, 앱 완전 종료까지 끝까지 원인을 찾아내신 과정이 그대로 담겨 있어서 다른 분들께도 큰 도움이 될 것 같습니다.

앞으로 n8n을 쓰다 보면 모르는 기능이 계속 나올 텐데, 이것도 지금처럼 클로드에게 물어보면서 하시면 됩니다!

여기서 꿀팁 하나!
n8n은 노드를 여러 개 이어 붙일 수 있어서, 한 가지 일도 단계별로 쪼개서 맡기면 결과가 훨씬 좋아집니다.

📰 뉴스 발행 예시
노드 1 - 뉴스 수집 (RSS 등)
노드 2 - AI가 사실만 추출
노드 3 - AI가 읽기 좋은 글로 편집
노드 4 - AI가 원문과 대조해서 빠지거나 지어낸 내용이 없는지 검토

AI도 한 번에 많은 일을 시킬수록 완성도가 떨어지기 쉬워서, 이렇게 나눠서 시키면 더 좋은 결과물을 얻을 수 있어요.

정리글 정말 잘 읽었습니다 😍
2주차도 파이팅!!!

칼로스 프로필 이미지
칼로스2026.10.04

앗 태그를 잘못 달았네요. 죄송합니다. ^^;

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기