1-2. n8n 서버 설치 (Docker) + API 키 발급
이번 클립에서는 n8n 서버를 Docker로 내 컴퓨터에 설치하고, Claude Code가 n8n을 제어할 수 있도록 API 키를 발급합니다.
1. 왜 Docker인가?
n8n을 설치하는 방법은 여러 가지입니다. npm으로 직접 설치하거나, 별도 서버에 올리는 방식도 있습니다.
가장 쉬운 방법은 Docker입니다. 프로그램을 하나의 상자에 담아 실행하는 도구로, 명령어 한 줄이면 n8n 서버가 바로 실행됩니다. 설치도 쉽고, 삭제도 깔끔합니다.
2. Docker Desktop 설치
이 강의에서 직접 손으로 해야 할 일은 단 하나, Docker Desktop 설치입니다. 이것만 깔아두면 나머지는 모두 Claude Code가 처리합니다. 이미 설치되어 있다면 건너뛰어도 됩니다.
웹 브라우저에서 docker.com에 접속합니다.
Download Docker Desktop 버튼을 클릭합니다.
운영체제(macOS 또는 Windows)에 맞는 설치 파일을 다운로드하고 설치합니다.
★ Windows 사용자. 설치 도중 WSL2(Windows Subsystem for Linux) 동반 설치를 묻습니다. 반드시 예를 선택합니다. WSL2 없이는 Docker가 동작하지 않습니다. 설치 중 재시작이 필요할 수 있습니다.
설치가 끝나면 Docker Desktop을 실행합니다. 화면 하단에 "Docker is running" 표시가 보이면 준비 완료입니다.
터미널에서도 확인합니다.
docker --versionDocker version 27.x.x 같은 버전 정보가 출력되면 정상입니다.
3. Claude Code에게 n8n 설치 명령하기
Docker가 준비되었으니, n8n 설치는 Claude Code에게 맡깁니다. Claude Code 프롬프트에 다음과 같이 입력합니다.
"Docker로 n8n 서버를 로컬에 설치해줘"
Claude Code가 아래와 같은 docker run 명령어를 생성합니다.
docker run -d --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n각 옵션의 의미는 다음과 같습니다.
-d
백그라운드 실행. 터미널을 닫아도 서버가 계속 동작합니다.
--name n8n
컨테이너 이름을 n8n으로 지정합니다.
-p 5678:5678
내 컴퓨터의 5678번 포트와 n8n 서버의 5678번 포트를 연결합니다.
-v n8n_data:/home/node/.n8n
n8n 데이터를 내 컴퓨터에 보존합니다. 컨테이너를 삭제해도 데이터는 남습니다.
n8nio/n8n
n8n 공식 Docker 이미지를 사용합니다.
Claude Code가 실행 권한을 요청하면 허용합니다. 처음 실행 시에는 이미지를 내려받느라 1~2분 정도 걸릴 수 있습니다.
4. 설치 확인
명령 실행이 끝나면 브라우저에서 다음 주소로 접속합니다.
http://localhost:5678"Set up owner account" 문구와 함께 n8n 초기 설정 화면이 나타나면 성공입니다.
화면이 안 뜨나요?
"사이트에 연결할 수 없음"
Docker Desktop이 실행 중인지 확인합니다. 컨테이너 시작에 10~20초 정도 소요될 수 있으니 잠시 후 새로고침합니다.
"포트가 이미 사용 중입니다" (port already in use)
다른 프로그램이 5678번 포트를 점유한 상태입니다. 포트를 바꿔 실행합니다. docker run -d --name n8n -p 5679:5678 -v n8n_data:/home/node/.n8n n8nio/n8n 으로 실행 후 http://localhost:5679로 접속합니다.
Windows "WSL2 설치가 완료되지 않았습니다"
Docker Desktop을 종료하고 터미널에서 wsl --update 실행 후 컴퓨터를 재시작합니다.
5. n8n 초기 설정
처음 접속하면 관리자 계정을 만듭니다. 다음 항목을 입력합니다.
관리자 이메일 주소
First Name / Last Name
이름
Password
비밀번호 (8자 이상)
입력 후 Next 버튼을 클릭합니다. 이어 나오는 설문은 건너뛰어도 무방합니다. 설정이 완료되면 n8n 메인 대시보드가 표시됩니다.
6. API 키 발급
이어서 API 키를 발급합니다.
대시보드 좌측 하단의 Settings(톱니바퀴 아이콘)를 클릭합니다.
n8n API 탭으로 이동합니다.
Create API Key 버튼을 클릭합니다.
생성된 API 키를 복사합니다.
API 키는 화면에 한 번만 표시됩니다. 반드시 안전한 곳에 저장합니다. 메모장이나 .env 파일에 임시로 보관하는 방식을 권장합니다.
★ 보안 주의. API 키는 n8n 서버의 모든 워크플로우를 제어할 수 있는 강력한 권한을 갖습니다. GitHub, 블로그 등 공개된 곳에 절대 노출하지 마십시오.
7. n8n Cloud 사용자 안내
이미 n8n Cloud를 사용 중이라면 Docker 설치는 필요 없습니다. n8n Cloud는 서버가 이미 운영 중이기 때문입니다.
해야 할 일은 하나, API 키 발급뿐입니다. 절차는 동일합니다. Settings → n8n API → Create API Key 순으로 진행합니다.
발급받은 API 키와 n8n Cloud 주소(예: https://my-instance.app.n8n.cloud)를 함께 메모해 둡니다. 다음 클립에서 모두 사용합니다.
8. 마무리
이번 클립에서 완료한 작업은 세 가지입니다.
- Docker Desktop 설치 및 n8n 서버 실행
- 관리자 계정 생성과 초기 설정
- API 키 발급
다음 클립에서는 Claude Code와 n8n을 MCP로 연결합니다. Claude Code에게 n8n을 직접 조종할 수 있는 능력을 부여하는 단계입니다.