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

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

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

- [참고하신 클로더즈 글이 있으면 링크를 넣어 주세요]