n8n Cloud 연동하기

n8n Cloud API 키를 발급하고 심플리에서 워크플로 실행량을 확인하는 방법을 안내합니다.

n8n Cloud를 연동하면 여러 인스턴스의 워크플로 실행량을 심플리 한곳에서 확인할 수 있습니다. 심플리는 n8n 공개 API를 읽기 전용으로 사용하며, 워크플로를 실행·수정·삭제하지 않습니다.

연동 전에 확인하기

다음 항목을 준비하세요.

연동할 n8n Cloud 인스턴스에 로그인합니다.
왼쪽 아래 사용자 메뉴에서 Settings를 엽니다.
n8n API를 선택합니다.
Create an API key를 누릅니다.
키의 용도를 알아볼 수 있도록 이름을 입력하고 만료일을 정합니다. 예: SMPLY usage collection
Enterprise 요금제에서 범위를 선택할 수 있다면 user:list, project:list, workflow:list, execution:list만 허용합니다.
생성된 API 키를 복사해 심플리에 등록할 때까지 안전하게 보관합니다.

심플리는 사용자 목록을 포함한 인스턴스 정보를 조회합니다. n8n 공개 API에서 사용자 목록은 인스턴스 소유자에게만 제공되므로, 인스턴스 소유자가 API 키를 발급해야 합니다.

인스턴스가 여러 개라면 같은 방법으로 계속 추가할 수 있습니다. 인스턴스마다 API 키와 수집 상태를 따로 관리합니다.

심플리는 사용량을 계산하고 프로젝트·워크플로·소유자별로 보여 주기 위해 다음 정보를 수집합니다.

구분	수집하는 정보	사용하는 곳
실행	실행 식별자, 실행 번호, 워크플로·프로젝트, 상태, 실행 방식, 시작·종료·대기 시각, 재시도 관계	전체 실행, 성공·실패, 평균 소요 시간, 추정 청구 실행
워크플로	이름, 활성·보관 상태, 소유 프로젝트, 노드·연결·설정 등 공개 API가 반환한 워크플로 구성	워크플로별 사용량과 프로젝트 연결
프로젝트	이름, 개인·팀 프로젝트 구분	프로젝트별 사용량
n8n 사용자	이름, 이메일, 인스턴스 역할, 초대 대기 여부	소유자 표시와 심플리 구성원 연결
프로젝트 구성원	프로젝트, 사용자, 프로젝트 역할	프로젝트 소유자별 사용량

다음 정보는 수집하지 않습니다.

워크플로 구성에는 노드 매개변수, 메모, 연결 구조와 자격증명 참조가 포함될 수 있습니다. API 키를 발급하기 전에 회사의 정보보호 기준에 맞는지 확인하세요.

심플리는 매시간 n8n 정보를 수집합니다. 첫 수집에서는 최근 30일의 실행을 확인하고, 이후에는 새 실행과 완료되지 않았던 실행을 이어서 반영합니다. 따라서 마지막 수집 이후에 시작한 실행은 다음 수집 전까지 보이지 않을 수 있습니다.

화면 항목	계산 기준
전체 실행	선택한 기간에 시작한 실행 수
추정 청구 실행	n8n의 실행 방식과 종료 상태를 기준으로 추정한 청구 대상 실행 수
성공	성공 상태로 끝난 실행 수
실패	오류 또는 중단 상태로 끝난 실행 수
평균 소요 시간	시작·종료 시각을 모두 확인할 수 있는 실행의 평균

추정 청구 실행은 심플리가 공개 API 정보로 계산한 참고값입니다. 실제 청구서와 차이가 날 수 있으므로 비용 확인에는 n8n 청구 내역을 함께 사용하세요.

프로젝트 소유자의 이메일이 심플리 구성원의 이메일과 같으면 같은 사람으로 연결합니다. 여러 n8n 인스턴스에 같은 이메일이 있어도 심플리 구성원과 연결된 경우에만 한 사람으로 합산합니다.

상태	의미	확인할 것
수집 완료	선택한 날짜의 실행과 분류 정보를 정상적으로 수집했습니다.	별도 조치가 필요하지 않습니다.
수집 전	연동 후 첫 수집이 아직 끝나지 않았습니다.	다음 수집까지 기다린 뒤 새로고침합니다.
일부 수집	실행은 수집했지만 프로젝트·사용자 정보 일부를 가져오지 못했거나 실행 사이에 누락 가능성이 있습니다.	API 키 권한과 n8n 상태를 확인합니다.
수집 실패	실행 정보를 가져오지 못했습니다.	연동 상태와 API 키를 확인합니다.
인증 실패	API 키가 만료·삭제되었거나 조회 권한이 부족합니다.	새 키를 발급해 API 키 교체를 실행합니다.
연결 불가	심플리에서 n8n Cloud 인스턴스에 연결할 수 없습니다.	인스턴스 주소와 n8n 서비스 상태를 확인합니다.
실행 번호 역행	n8n이 이전에 수집한 실행 번호보다 작은 번호를 반환해 실행 누락 가능성을 확인하는 상태입니다.	같은 상태가 다음 수집 후에도 계속되면 심플리에 문의하세요.

API 키가 만료되기 전 새 키를 만든 뒤 해당 인스턴스의 API 키 교체를 누릅니다. 기존 키는 화면에 다시 표시되지 않으며, 새 키가 정상인지 확인한 뒤 교체합니다.

연동 해제를 선택하면 해당 인스턴스의 이후 수집만 중단됩니다. 다른 n8n 인스턴스에는 영향을 주지 않습니다. 이미 수집한 기간의 사용량은 과거 기록을 확인할 수 있도록 유지됩니다.