확인일: 2026년 8월 23일
n8n은 여러 앱과 API를 연결해 반복 업무를 자동화하는 워크플로우 도구입니다. 처음부터 Gmail, Notion, AI를 한꺼번에 연결하려고 하면 인증과 데이터 형식에서 쉽게 막힙니다. 이 글에서는 외부 계정 연결 없이도 “자동화가 어떤 순서로 움직이는지” 이해할 수 있는 첫 워크플로우를 만드는 흐름을 정리합니다.
이 글의 범위: n8n의 기본 개념과 첫 테스트 워크플로우입니다. 실제 서비스 계정 연결, 비용 비교, 운영 환경 선택은 별도 글에서 다룹니다. 화면 명칭과 세부 UI는 n8n 업데이트에 따라 달라질 수 있으므로, 중요한 설정은 n8n 공식 문서를 함께 확인하세요.
시작 전에 확인할 것
이 글의 예시는 외부 서비스 계정이나 실제 고객 데이터를 연결하지 않는 연습용 워크플로우입니다. 아래 세 가지만 준비하면 됩니다.
- n8n에서 새 워크플로우를 만들 수 있는 계정 또는 작업 공간
- 실제 업무 데이터가 아닌, 직접 만든 테스트용 값
- 처음에는 활성화하지 않고 수동 실행으로 결과를 확인한다는 원칙
이 글을 끝내면 버튼을 눌러 테스트 데이터를 만들고, 각 단계의 입력과 출력을 확인하는 기본 흐름을 설명할 수 있게 됩니다.
먼저 이해할 다섯 가지
n8n을 어렵게 느끼는 이유는 “자동화”라는 말이 너무 넓기 때문입니다. 시작할 때는 아래 다섯 가지로 나누면 충분합니다.
- 워크플로우: 자동화 전체 설계도입니다. 예를 들어 “새 문의가 오면 내용을 정리해 담당자에게 알린다”가 하나의 워크플로우가 됩니다.
- 트리거: 워크플로우를 시작시키는 사건입니다. 버튼을 눌러 직접 시작할 수도 있고, 새 메일·폼 응답·Webhook 수신처럼 외부 사건으로 시작할 수도 있습니다.
- 노드: 각 단계를 수행하는 블록입니다. 데이터를 만들고, 조건을 나누고, 다른 서비스에 보내는 작업이 각각 노드가 됩니다.
- 데이터: 노드 사이를 오가는 정보입니다. 이름, 이메일, 주문번호처럼 한 건의 데이터를 어떤 형식으로 넘길지 확인하는 습관이 중요합니다.
- 실행과 활성화: 테스트 실행은 지금 한 번 돌려 보는 것이고, 활성화는 특정 조건이 생길 때 계속 작동하도록 켜 두는 것입니다.
첫 자동화는 “수동 실행 → 데이터 만들기”로 시작하세요
처음부터 실제 이메일을 보내거나 고객 데이터를 연결할 필요는 없습니다. 실수로 메시지를 발송하거나 API 사용량을 늘리는 일을 막기 위해, 아래처럼 외부 계정이 필요 없는 테스트부터 권합니다.
목표: 버튼을 눌러 실행하면 “오늘 처리할 업무”라는 데이터를 만들고, 다음 노드에서 그 값을 확인한다.
흐름: 수동 실행 → 값 입력/편집 → 실행 결과 확인
1. 새 워크플로우를 만듭니다
n8n에서 새 워크플로우를 열고, 제목을 알아보기 쉽게 정합니다. 예를 들어 first-workflow-test처럼 목적이 드러나는 이름이 좋습니다. 나중에 실행 기록을 확인할 때 이름만으로 용도를 알아볼 수 있어야 합니다.
2. 수동 트리거를 추가합니다
첫 노드에는 수동으로 실행할 수 있는 트리거를 둡니다. 이 단계는 실제 서비스에서 새 데이터가 들어오는 상황을 흉내 내기 위한 안전한 시작점입니다. 아직 활성화하지 않아도 됩니다.
3. 테스트 데이터를 만듭니다
다음 노드에서 텍스트 필드를 만들어 보세요. 예시는 아래 정도면 충분합니다.
{
"task": "주간 업무 정리",
"owner": "나",
"priority": "high"
}중요한 것은 특정 노드 이름을 외우는 일이 아니라, 다음 단계가 어떤 키와 값을 받을지 정하는 것입니다. n8n에서는 이전 노드의 데이터를 다음 노드의 필드에 매핑하거나 표현식으로 참조할 수 있습니다. 공식 문서도 이전 노드의 값을 드래그해 넣거나 표현식 편집기로 참조하는 방식을 안내합니다.
4. 한 단계씩 실행하고 결과를 봅니다
워크플로우 전체를 곧바로 활성화하지 말고, 수동 실행 뒤 각 노드의 입력과 출력을 확인하세요. 아래 세 가지를 확인하면 됩니다.
- 입력: 앞 단계가 기대한 필드를 보냈는가?
- 출력: 지금 단계가 필요한 값을 만들었는가?
- 형식: 텍스트, 숫자, 날짜, 배열 같은 값의 형태가 다음 단계의 요구와 맞는가?
데이터를 참조하는 방법은 공식 데이터 매핑 가이드에서 확인할 수 있습니다. 자동화 오류의 상당수는 연결 자체보다 필드 이름 또는 데이터 형식이 달라서 발생합니다.
“작동했다”는 기준을 정하는 법
첫 실행에서 초록색 표시가 보였다고 끝난 것은 아닙니다. 아래 기준을 통과해야 다음 서비스 연결로 넘어갈 수 있습니다.
| 확인 항목 | 통과 기준 |
|---|---|
| 입력 데이터 | 예상한 키와 값이 첫 노드에 들어온다. |
| 노드 연결 | 각 노드가 의도한 순서대로 실행된다. |
| 출력 데이터 | 다음 단계에서 쓸 값이 누락되지 않는다. |
| 재실행 | 같은 입력으로 다시 실행해도 결과를 설명할 수 있다. |
| 실패 처리 | 일부 값이 비어 있을 때 어떻게 멈추는지 확인한다. |
이 기준을 먼저 익혀 두면 Gmail, Google Sheets, Notion, AI 모델을 연결한 뒤에도 “어느 단계에서 틀어졌는지” 빠르게 좁힐 수 있습니다.
계정 연결은 두 번째 단계에 하세요
실제 앱을 연결할 때는 인증 정보가 필요합니다. API 키, OAuth 토큰, 비밀번호를 워크플로우 본문이나 메모에 직접 입력하지 말고 n8n의 자격 증명 기능을 이용하세요. 또한 권한은 꼭 필요한 범위만 부여하고, 테스트용 계정이나 테스트용 문서에서 먼저 확인하는 편이 안전합니다.
특히 Webhook, 파일 시스템 접근, 코드 실행, 커뮤니티 노드는 운영 환경에 영향을 줄 수 있습니다. self-hosted 환경이라면 n8n이 제공하는 보안 점검 기능과 보안 점검 문서도 함께 살펴보세요.
처음에는 활성화하지 않아도 됩니다
수동 트리거로 만든 테스트 워크플로우는 활성화하지 않아도 됩니다. 활성화가 필요한 시점은 새 메일 수신, 폼 제출, 일정 도래처럼 외부 사건을 계속 감지해야 할 때입니다. 활성화 전에는 다음을 다시 확인하세요.
- 테스트 데이터가 아니라 실제 데이터를 다루는지
- 실패했을 때 누가 알아차리고 어디서 재실행할지
- 외부 서비스에 메시지·이메일·파일을 중복으로 보내지 않는지
- 권한이 넓거나 민감한 데이터가 로그에 남지 않는지
초보자가 가장 자주 막히는 지점
노드는 연결됐는데 값이 비어 있습니다
앞 노드의 출력에서 실제 필드 이름을 확인하세요. 화면에 보이는 라벨과 데이터의 키 이름이 다를 수 있습니다. 다음 노드에 값을 직접 다시 입력하기보다, 이전 출력에서 필요한 값을 매핑해야 이후 단계가 늘어나도 유지보수가 쉽습니다.
한 번은 되는데 다시 실행하면 결과가 달라집니다
날짜, 현재 시간, 외부 API 응답처럼 매번 바뀌는 값이 있는지 확인하세요. 원인을 찾을 때는 먼저 입력을 고정한 뒤 한 노드씩 실행하는 방식이 좋습니다.
인증 화면에서 계속 실패합니다
다른 브라우저 탭의 로그인 상태, 리디렉션 URL, 앱의 OAuth 권한 범위, 조직 계정의 보안 정책이 원인일 수 있습니다. 토큰 값을 화면 캡처나 문의에 그대로 공유하지 말고, 공식 연결 문서를 기준으로 설정을 다시 확인하세요.
첫 실전 자동화로 추천하는 범위
다음 단계에서는 한 번에 하나의 입력과 하나의 출력을 연결하세요. 예를 들면 “Google Sheets의 새 행을 감지해 나에게 이메일 한 통 보내기”처럼 결과가 분명한 작업이 좋습니다. AI 요약, 여러 앱 분기, 고객 데이터 처리는 그 다음에 붙여도 늦지 않습니다.
이 사이트에서는 이어서 n8n Cloud와 self-hosted 방식의 차이, Webhook의 기본 원리, Gmail과 Google Sheets를 연결하는 흐름을 다룰 예정입니다.
마무리 체크리스트
- 워크플로우의 시작 조건을 한 문장으로 설명할 수 있는가?
- 각 노드가 넘기는 데이터의 키를 확인했는가?
- 실제 계정 연결 전, 수동 실행으로 결과를 확인했는가?
- 자격 증명과 민감한 데이터를 워크플로우 본문에 넣지 않았는가?
- 활성화 전에 중복 실행과 실패 알림을 생각했는가?
참고한 공식 자료
다음 단계
수동 실행 흐름을 이해했다면, n8n 웹훅 첫 테스트 가이드에서 외부 데이터 수신과 응답 반환을 이어서 연습해 보세요.