UI 살펴보기 — 캔버스·노드·연결선

🎯 학습 목표

이 강을 마치면 다음을 할 수 있습니다.

• n8n 에디터의 캔버스 구조와 각 영역의 역할을 설명할 수 있습니다.
• 노드 패널에서 원하는 노드를 빠르게 찾아 추가할 수 있습니다.
• 연결선이 데이터를 전달하는 방향과 의미를 이해합니다.
• 실행 로그를 읽고 워크플로우의 성공·실패 원인을 파악할 수 있습니다.

🗺️ 에디터 전체 구조 한눈에 보기

이 섹션에서는 n8n 에디터를 처음 열었을 때 보이는 전체 화면 구조를 살펴보겠습니다.

n8n 에디터는 크게 네 개의 영역으로 나뉩니다. 화면 상단의 탑바(Top Bar), 왼쪽의 노드 패널(Node Panel), 화면 대부분을 차지하는 캔버스(Canvas), 그리고 노드를 클릭했을 때 오른쪽에서 열리는 노드 설정 패널(Node Settings Panel)입니다. 각 영역의 역할을 이해하면 이후 모든 실습이 훨씬 수월해집니다.

탑바에는 워크플로우 이름, 저장 버튼, 실행 버튼, 활성화(Active) 토글이 있습니다. 활성화 토글이 꺼진 상태(회색)에서는 트리거가 발동해도 워크플로우가 실행되지 않습니다. 개발·테스트 중에는 꺼두고, 실제 운영할 때만 켜는 것이 안전합니다. 워크플로우 이름을 클릭하면 언제든 이름을 변경할 수 있습니다.

탑바 왼쪽 끝의 햄버거 메뉴(≡)를 클릭하면 대시보드로 돌아가거나, 워크플로우 목록, Credentials(인증 정보 관리), 실행 기록(Executions) 페이지로 이동할 수 있습니다. 이 메뉴가 n8n 전체 네비게이션의 중심입니다.

🎨 캔버스 — 워크플로우의 도화지

이 섹션에서는 워크플로우를 설계하는 공간인 캔버스의 조작 방법과 특성을 살펴보겠습니다.

캔버스(Canvas)는 노드를 배치하고 연결하는 작업 공간입니다. 무한 스크롤 방식으로 크기 제한이 없으므로, 복잡한 워크플로우도 얼마든지 넓게 펼쳐놓을 수 있습니다. 마우스 스크롤로 확대·축소하고, 빈 곳을 드래그하면 화면을 이동할 수 있습니다. 복잡한 워크플로우를 전체적으로 조망하고 싶을 때는 오른쪽 하단의 미니맵을 활용합니다.

캔버스에서 노드를 추가하는 방법은 두 가지입니다. 첫째, 연결선 끝의 +버튼을 클릭하면 해당 노드 다음에 올 노드를 검색해서 추가할 수 있습니다. 이 방식은 흐름을 이어가면서 자연스럽게 노드를 추가할 때 편리합니다. 둘째, 캔버스 빈 공간을 더블클릭하거나 Tab 키를 누르면 노드 검색 팝업이 열립니다. 키보드로 노드 이름을 타이핑하면 실시간으로 검색 결과가 나타납니다.

노드를 선택한 뒤 Delete 또는 Backspace 키를 누르면 삭제되고, Ctrl+C / Ctrl+V로 복사·붙여넣기를 할 수 있습니다. 여러 노드를 동시에 선택하려면 Shift를 누른 채로 클릭하거나, 빈 곳에서 드래그로 범위를 지정합니다. 여러 노드를 동시에 이동시키거나 복사할 때 유용합니다.

🔍 노드 패널 — 400개 노드를 빠르게 찾는 법

이 섹션에서는 n8n이 제공하는 방대한 노드 라이브러리를 효율적으로 탐색하는 방법을 살펴보겠습니다.

캔버스 왼쪽 또는 + 버튼을 클릭하면 열리는 노드 패널에는 n8n이 제공하는 400개 이상의 노드가 카테고리별로 정리되어 있습니다. 노드는 크게 두 그룹으로 나뉩니다. 첫째, App nodes는 Gmail, Slack, Notion 같은 외부 서비스와 연동하는 노드입니다. 둘째, Core nodes는 IF, Set, Merge, Code, HTTP Request처럼 n8n 내부 로직을 처리하는 범용 노드입니다.

노드를 찾는 가장 빠른 방법은 검색입니다. 패널 상단의 검색창에 서비스 이름(예: 'gmail', 'slack')이나 기능 키워드(예: 'http', 'merge')를 입력하면 매칭되는 노드가 즉시 필터링됩니다. 정확한 이름을 모를 때는 카테고리 탭을 탐색하거나, 원하는 동작(예: 'send email', 'create row')을 자연어로 검색하면 관련 노드를 찾을 수 있습니다.

노드 위에 마우스를 올리면 해당 노드의 간략한 설명이 툴팁으로 표시됩니다. 클릭하면 캔버스에 노드가 추가되고 오른쪽에 설정 패널이 열립니다. 자주 쓰는 노드는 별표(★) 버튼으로 즐겨찾기에 추가해두면 매번 검색하지 않아도 됩니다.

🔗 연결선 — 데이터가 흐르는 통로

이 섹션에서는 노드와 노드를 연결하는 연결선의 작동 원리와 데이터 흐름 방향을 살펴보겠습니다.

n8n에서 연결선(Connection)은 단순한 시각적 화살표가 아닙니다. 연결선은 앞 노드(소스)의 출력 데이터를 다음 노드(타겟)의 입력으로 전달하는 실제 데이터 파이프입니다. 연결선을 만들려면 소스 노드 오른쪽의 동그라미 핸들을 드래그해서 타겟 노드의 왼쪽 핸들에 연결합니다. 연결이 성립되면 회색 곡선으로 두 노드가 이어집니다.

대부분의 노드는 하나의 출력 핸들만 가집니다. 그러나 IF 노드나 Switch 노드 같은 분기 노드는 여러 개의 출력 핸들을 가집니다. IF 노드의 경우 조건이 참(true)일 때의 경로와 거짓(false)일 때의 경로로 나뉘어, 두 개의 서로 다른 연결선이 각각 다른 노드로 이어집니다. 이것이 바로 n8n에서 조건 분기를 구현하는 방식입니다.

연결선을 클릭하면 선택(파란색 강조)되며, Delete 키로 삭제할 수 있습니다. 이미 연결된 노드 사이에 새 노드를 끼워 넣고 싶다면, 새 노드를 연결선 위로 드래그하면 자동으로 중간에 삽입됩니다. 이 기능은 기존 워크플로우에 처리 단계를 추가할 때 매우 유용합니다.

📋 실행 로그 — 문제를 진단하는 창

이 섹션에서는 워크플로우 실행 결과를 확인하고 문제를 파악하는 방법을 살펴보겠습니다.

워크플로우를 실행하면 각 노드 아래에 실행 결과가 표시됩니다. 초록색 체크마크(✓)는 성공, 빨간색 X는 실패를 의미합니다. 노드를 클릭하면 오른쪽 설정 패널이 열리고, 상단의 INPUT과 OUTPUT 탭에서 해당 노드가 받은 데이터와 내보낸 데이터를 확인할 수 있습니다.

Execution Log(실행 로그)는 탑바의 실행 목록 아이콘이나 왼쪽 메뉴 → Executions에서 확인합니다. 여기서는 과거의 모든 실행 기록을 시간 순서로 볼 수 있습니다. 각 실행 항목을 클릭하면 그 시점의 워크플로우 상태(어떤 노드가 성공/실패했는지, 각 노드를 통과한 데이터가 무엇이었는지)를 완전히 재현해서 볼 수 있습니다.

실패한 실행의 경우, 실패한 노드를 클릭하면 오른쪽 패널에 에러 메시지가 표시됩니다. 에러 메시지는 대부분 API 인증 오류, 잘못된 필드명, 타임아웃 등의 원인을 명확하게 설명해줍니다. 이 메시지를 기반으로 노드 설정을 수정하면 대부분의 문제를 해결할 수 있습니다. 에러 메시지를 복사해서 검색 엔진이나 n8n 공식 커뮤니티 포럼에 검색하면 해결책을 빠르게 찾을 수도 있습니다.

📝 핵심 요약

UI 구성 요소	역할	핵심 조작
탑바	저장, 실행, 활성화 토글	Active 토글로 운영/개발 전환
캔버스	노드 배치·연결 작업 공간	더블클릭/Tab으로 노드 추가
노드 패널	400+ 노드 검색·추가	검색창에 서비스명 입력
연결선	노드 간 데이터 전달	핸들 드래그로 연결, 위로 드래그로 삽입
실행 로그	실행 결과·에러 진단	노드 클릭 → INPUT/OUTPUT 탭 확인

다음 강에서는 첫 워크플로우를 직접 만들어 봅니다. Manual Trigger로 워크플로우를 시작하고 Set 노드로 데이터를 생성하는 가장 기본적인 실습을 통해, 캔버스 조작과 노드 설정에 완전히 익숙해지겠습니다.