본문으로 건너뛰기

클로드 코드에 n8n-mcp 연동하기: 윈도우 로컬 n8n 연결

이성학

2026.10.08

클로드 코드에 n8n-mcp 연동하기: 윈도우 로컬 n8n 연결

클로드 코드(Claude Code)에 n8n-mcp를 연동해 윈도우 노트북의 n8n과 연결했습니다. AI가 못 하는 일과 내가 할 일을 나눠서, 2026년 10월 5일 약 1시간 10분 만에 연결까지 마쳤어요.

MCP는 AI에 도구를 꽂는 규격입니다. n8n-mcp를 꽂으면 클로드 코드에서 n8n 워크플로우를 다룰 수 있습니다. 중간에 설정 파일 하나를 세 번 고쳤고, 오류 문구 세 개를 만났습니다.

클로드 코드에 n8n을 붙이려던 이유

지피터스 24기 업무자동화 멤버 이성학이에요. 음악·영화 좋아하는 총무/개발자예요. 이번 작업은 업무에 n8n을 써 보려는 것이었고, 공부 삼아 해 본 것이기도 하고, 스터디 과제이기도 했습니다.

n8n을 제 컴퓨터에 띄우고, 클로드 코드에 말로 시켜서 워크플로우를 만드는 게 목표였습니다. 출발은 클로드(Claude) 대화창이었어요. 제 윈도우 노트북과 연결해 둔 대화창에 이렇게 보냈습니다.

https://docs.n8n.io/deploy/host-n8n 문서를 참고해서 npm으로 내 컴퓨터에 n8n을 설치해줘

문서에서 확인한 조건은 이랬습니다. npm으로 설치하려면 Node.js 20.19 이상 24.x 이하가 필요하고, npm 설치 방식은 n8n 3.0부터 지원이 중단될 예정이라는 내용이었습니다(n8n 공식 문서, 2026년 10월 5일 기준). 문제는 그다음이었어요.

AI가 못 하는 일과 내가 할 일 나누기

설치 명령을 실행하는 단계에서 멈췄습니다. 대화창 클로드는 제 컴퓨터 화면을 보고 클릭할 수는 있지만, 터미널에 글자를 입력하지 못한다는 답이 왔어요. 그래서 이렇게 되물었습니다.

윈도우라 설치 못하는건가 왜 너가 못하지? 권한도 줬는데 말이야

돌아온 답은 윈도우 문제가 아니라는 것이었습니다.

주신 권한은 제가 컴퓨터 화면을 보고 앱을 조작하는 기능을 켜는 권한입니다. 다만 이 기능에는 앱 종류별로 허용 범위가 정해져 있고, 터미널과 코드 편집기는 사용자가 승인해도 "보기와 클릭"까지만 허용됩니다.

터미널에서는 명령 한 줄로 파일을 지우거나 시스템을 바꿀 수 있어서 걸어 둔 안전장치라는 설명이었습니다. 맥이어도 똑같다고 했어요. 그 뒤로는 누가 무엇을 할지 나눠서 진행했습니다. 이번 작업에서 실제로 나뉜 일은 이렇습니다.

  • 대화창 클로드: 공식 문서 찾기, 설정 파일 초안 만들기, 폴더 속 파일 이름과 크기 확인, 오류 화면 보고 원인 짚기

  • 제 컴퓨터의 클로드 코드: n8n 설치, 설정 파일 수정

  • 저: 터미널 명령 실행, 파일 옮기기, API 키 붙여 넣기, 클로드 코드 다시 켜기

결국 n8n 설치는 제 컴퓨터에서 띄운 클로드 코드에 맡겼습니다. 대화창은 제 손이 닿지 않는 곳을 대신 보고 원인을 짚는 자리로 썼어요.

n8n-mcp 설정 파일을 세 번 고친 과정

n8n이 깔린 뒤에는 대화창에 n8n-mcp 연결을 부탁했습니다. 이번엔 API 키를 채팅창에 절대 쓰지 않겠다고 먼저 정해 뒀어요. 실제로 보낸 요청입니다.

이 폴더에서 내 n8n(내 컴퓨터 주소)에 워크플로우를 만들 수 있게 n8n-mcp를 연결해줘.

중요: n8n API 키는 채팅에 입력하지 않을 거야.

1. 이 폴더에 .mcp.json 파일을 만들되, API 키 자리에는 YOUR_N8N_API_KEY 라고 적어줘.
2. 그 파일을 내가 직접 열어서 키를 붙여넣을 수 있게 열어줘. (Mac은 open, Windows는 notepad로)
3. 내가 저장했다고 말하면 그때 이어서 진행해줘. 키 값은 절대 읽거나 화면에 출력하지 마.
4. n8n-mcp 실행에 필요한 것(npx/Node.js)이 없으면 먼저 알려주고 설치를 도와줘.

(뒤로 1줄 더)

첫 단계부터 막혔습니다. 프로젝트 폴더에 설정 파일을 쓰려고 하자 이 문구가 나왔어요.

Writing to .mcp.json is not permitted via remote tools.

원격으로는 이 이름의 파일을 쓸 수 없게 막혀 있었습니다. 그래서 키 자리에 YOUR_N8N_API_KEY를 적어 둔 설정 파일을 대화창에서 첨부받아, 제가 내려받아 폴더로 옮겼습니다. 여기서부터 세 번을 고쳤어요.

  • 첫 번째는 파일 이름입니다. 내려받은 파일 이름이 점이 빠진 mcp.json이었습니다. 앞에 점을 붙여 .mcp.json으로 바꿨어요.

  • 두 번째는 키입니다. 저장했다고 했더니 파일 크기가 원본과 같은 333바이트라는 답이 왔습니다. 키가 안 들어갔다는 뜻이었고, 다시 붙여 넣어 저장하니 421바이트가 됐어요.

  • 세 번째는 형식입니다. 클로드 코드에서 /mcp를 치니 빨간 글씨가 떴습니다.

[Failed to parse] Project config (shared via .mcp.json)
[Error] MCP config is not a valid JSON

키가 있는 줄을 다시 고쳐 저장하고 확인하니 이 오류가 사라졌습니다. 이 과정에서 파일 내용은 한 번도 대화창에 열리지 않았어요. 처음에 "키 값은 절대 읽거나 화면에 출력하지 마"라고 해 둔 덕에, 확인은 파일 이름과 크기로만 했습니다. 333바이트에서 421바이트로, 다시 423바이트로 바뀌는 숫자만으로 키가 들어갔는지 알 수 있었습니다.

클로드 코드 연결 뒤에 막힌 곳

형식 오류가 사라지자 n8n-mcp가 목록에 나타났는데, 앞에 빨간 × 표시가 붙어 있었습니다. 상세 화면에는 "failed" 한 단어뿐이었어요. 그래서 클로드 코드와 별개로 터미널 창을 하나 더 열고 두 줄을 직접 쳤습니다.

node -v
v24.18.0
npx -y n8n-mcp

Node.js 버전은 요구 범위 안이었고, n8n-mcp는 오류 없이 대기 상태로 멈춰 있었습니다. 그 뒤 클로드 코드의 /mcp 화면을 다시 보니 초록색 체크와 함께 "28 tools"가 떴어요.

연결됐으니 워크플로우 목록을 보여 달라고 했는데, 여기서 또 막혔습니다.

SSRF protection: Localhost access is blocked in strict mode

n8n-mcp는 기본 보안 모드(strict)에서 제 컴퓨터 안의 주소로 나가는 요청을 막습니다. 제 컴퓨터의 클로드 코드가 이 원인을 찾아 설정 파일에 "WEBHOOK_SECURITY_MODE": "moderate"를 추가했습니다. 제 컴퓨터 주소는 허용하고 사설망 주소는 계속 막는 모드라는 설명이 붙어 있었어요.

원인이 하나 더 있었는데, 그때 n8n이 꺼져 있었습니다. 5678 포트에서 응답하는 프로그램이 없었어요. 터미널에서 n8n을 실행해 두고 크롬으로 제 컴퓨터의 n8n 주소를 열어 보니 로그인된 n8n 화면이 떴습니다.

연결 결과와 아직 안 된 것

이번 일은 AI 덕에 처음 할 수 있게 된 일입니다. 약 1시간 10분 작업으로 남은 것은 이렇습니다.

  • 프로젝트 폴더의 설정 파일 하나(.mcp.json). API 키는 제가 직접 넣었고 채팅창에는 한 번도 쓰지 않았습니다.

  • 클로드 코드의 /mcp 화면에서 n8n-mcp가 도구 28개로 연결된 상태

  • 크롬에서 제 컴퓨터의 n8n 주소를 열면 뜨는 n8n 화면

아직 안 된 것도 있습니다. 설치와 연결까지만 진행했고, 클로드 코드로 워크플로우 목록을 불러오는 확인은 아직 안 했습니다. 키가 제대로 들어갔는지는 그 요청을 해 봐야 확실히 압니다. 하나 더, n8n은 터미널 창을 열어 둔 동안에만 돌아갑니다. 사흘 뒤 다시 확인했을 때는 n8n이 꺼져 있었어요.

자주 묻는 질문

n8n을 띄운 터미널 창은 늘 켜 둬야 하나요? n8n을 쓰는 동안만 켜 두면 됩니다. 만든 워크플로우는 컴퓨터에 저장되어 다음에 켜도 남아 있습니다. 다만 "매일 아침 9시 실행" 같은 예약 워크플로우는 그 시각에 n8n이 켜져 있어야 돌아갑니다.

클로드 코드를 실행한 창도 매일 켜야 하나요? 아니요. 클로드 코드는 워크플로우를 만들거나 고칠 때만 켜면 됩니다. 이미 만든 워크플로우는 n8n이 직접 실행해서, 클로드 코드 창을 닫아도 계속 돌아갑니다.

도커(Docker)도 깔아야 하나요? 지금 구성에는 필요 없습니다. npm으로 설치한 n8n과 n8n-mcp만으로 연결됐어요. 컴퓨터를 켜면 n8n이 자동으로 뜨게 하고 싶거나, npm 방식 지원이 끝나는 n8n 3.0 이후에도 쓰려면 그때 도커 방식을 고려하면 됩니다.

클로드 코드로 따라 하는 순서

  1. 터미널에서 n8n을 실행하고 그 창은 열어 둡니다.

  2. n8n 설정 화면에서 API 키를 발급합니다.

  3. 프로젝트 폴더에서 클로드 코드를 열고 아래처럼 시킵니다.

  4. 열린 메모장에서 YOUR_N8N_API_KEY 자리에 키를 붙여 넣고 저장합니다. 저장했다고 하면 파일 이름과 크기만 확인받습니다.

  5. 클로드 코드를 껐다 켜고 /mcp에서 n8n-mcp 앞에 초록색 체크가 떴는지 봅니다.

이렇게 시키면 돼요. 제가 보낸 요청에 이번에 실제로 연결된 설정을 더해 다듬은 것입니다.

이 폴더에서 내 n8n([내 n8n 주소])에 워크플로우를 만들 수 있게 n8n-mcp를 연결해줘.
n8n API 키는 채팅에 입력하지 않을 거야.
1. .mcp.json을 만들고 API 키 자리에는 YOUR_N8N_API_KEY라고 적어줘.
2. [윈도우]라서 npx는 cmd /c로 실행되게 하고, 로컬 n8n이니 WEBHOOK_SECURITY_MODE는 moderate로 넣어줘.
3. 파일을 [메모장]으로 열어 주면 내가 키를 붙여넣을게. 키 값은 절대 읽지 마.
4. 내가 저장했다고 하면 파일 이름과 크기만 보고 이어서 진행해줘.

함께 이야기해요 0

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

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

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

이런 사례도 있어요

사례 전체 보기