APPENDIX · 부록

A-1. n8n-admin 소개 — 설치 + 서버 연동 + 대시보드

강사가 직접 만든 오픈소스 n8n 관리 도구 n8n-admin을 소개합니다. 본편에서는 Claude Code의 자연어 명령으로 n8n을 관리했다면, n8n-admin은 같은 작업을 GUI 기반으로 처리할 수 있는 데스크톱 앱입니다.

1. n8n-admin이란?

n8n-admin은 n8n 서버를 편리하게 관리하기 위해 만든 오픈소스 데스크톱 애플리케이션입니다. GitHub에 공개되어 있고 누구나 무료로 사용할 수 있습니다.

API 직접 연결

n8n API를 활용해 서버에 바로 접속

데스크톱 단독 실행

브라우저 없이 앱 하나로 관리

다중 서버 지원

여러 n8n 서버를 등록하고 전환 가능

접근 방식은 다르지만 같은 n8n API를 사용하므로 할 수 있는 일의 범위는 본편의 Claude Code + 스킬 방식과 비슷합니다.

2. 핵심 기능 다섯 가지

워크플로우 백업/복원

전체 워크플로우를 JSON으로 한 번에 내려받고, 다른 서버에 올려 복원

유저 관리

등록된 사용자 목록 확인, 역할 변경, 비활성 유저 정리

크레덴셜 관리

API 키·OAuth 토큰 목록 확인, 어떤 워크플로우가 어떤 크레덴셜을 쓰는지 파악

서버 이관

개발 서버에서 운영 서버로 워크플로우 이전. 선택한 워크플로우만 골라 이관 가능

웹 대시보드

워크플로우 현황·실행 통계·에러 현황을 한 화면에서 확인

본편에서 Claude Code로 "전부 백업해줘"라고 했던 작업이 버튼 한 번으로 처리됩니다.

3. 설치 방법 — 두 가지

설치 경로는 두 가지입니다.

방법 1: DMG 다운로드 (Mac 전용)

GitHub Releases 페이지에서 최신 DMG 파일을 받습니다. 파일을 열어 n8n-admin 아이콘을 Applications 폴더로 드래그하면 끝입니다. 일반적인 Mac 앱 설치와 동일합니다.

방법 2: 소스에서 직접 빌드

Mac이 아니거나 최신 개발 버전을 쓰고 싶을 때 사용합니다.

git clone https://github.com/team-datapopcorn/n8n-admin.git
cd n8n-admin
npm install
cd admin
pnpm install

루트에서 npm install로 Electron 의존성을, admin 폴더에서 pnpm install로 프론트엔드 의존성을 설치합니다. 이후 npm start로 앱을 실행할 수 있습니다.

4. 서버 연동 설정

설치 후 n8n 서버와 연결해야 합니다. 연결에 필요한 정보는 두 가지입니다.

두 값을 .env 파일에 입력합니다.

SERVER_URL=http://localhost:5678
SERVER_API_KEY=eyJhbGciOiJIUzI1NiIs...

본편에서 MCP 서버 연결할 때 사용했던 API 키와 동일합니다. 이미 발급받은 키가 있다면 그대로 사용하면 됩니다.

앱을 실행했을 때 서버의 워크플로우 목록이 표시되면 연동 성공입니다.

5. 대시보드 맛보기

대시보드는 세 영역으로 구성됩니다.

워크플로우 현황

전체 워크플로우 수, 활성/비활성 비율, 최근 생성 목록을 한 화면에서 확인

유저 목록

등록 사용자, 역할, 마지막 로그인 시간, 보유 워크플로우 수 표시

백업 실행

버튼 한 번으로 전체 워크플로우를 JSON으로 다운로드. 날짜별로 자동 저장되어 버전 관리도 용이

본편에서 Claude Code에게 "운영 리포트 만들어줘"라고 했을 때 나오는 정보와 유사한 내용이 그래픽으로 정리됩니다.

6. 스킬 vs n8n-admin — 보완 관계

Claude Code + 스킬

자연어 · 복합 작업

  • "비활성 찾아 태그 붙이고 리포트" 같은 다단계 명령
  • 상황별로 다르게 동작하는 유연함
  • 커스텀 리포트·복합 분석에 강함
n8n-admin

GUI · 반복 작업

  • 버튼 한 번으로 끝나는 단순 작업
  • 직관적인 화면, 빠른 클릭 흐름
  • 일상 백업·유저 확인에 강함

두 도구는 경쟁이 아닌 보완 관계입니다. 복합 분석과 커스텀 리포트는 Claude Code로, 일상적인 백업과 유저 확인은 n8n-admin으로 나눠 처리하면 됩니다.

★ 핵심. 도구가 많을수록 선택지가 넓어집니다. 자연어와 GUI를 상황에 맞게 골라 쓰십시오.

7. 마무리

이번 클립에서는 n8n-admin의 기능, 설치 방법, 서버 연동, 대시보드까지 살펴봤습니다. 본편에서 배운 스킬 기반 관리와 함께 사용하면 n8n 운영이 한결 편해집니다.

다음 부록 클립에서는 강의에서 사용한 모든 명령어를 한 장에 정리한 치트시트를 제공합니다.

다음 클립
A-2. 명령어 치트시트 — 만들기 + 관리하기 전체
이어보기 →