MonstarX에서 n8n 사용하기

Q: 키가 거부되는 이유는 무엇인가요?

주소가 https://로 시작하고 ? 뒷부분이 없는지, 요금제에 n8n API가 포함되어 있는지(Cloud 무료 체험 제외), 키가 만료되지 않았는지 확인하세요.

핵심 요약백엔드 → 클라우드의 n8n 행에 n8n 인스턴스 주소와 n8n API 키를 입력하세요. 그러면 MonstarX 에이전트가 워크플로와 실행 내역을 조회하고 읽을 수 있습니다. 워크플로의 웹훅을 호출하는 앱을 만들거나, 실행이 실패한 이유를 찾을 때 유용합니다. 읽기만 하며, 워크플로를 실행하거나 바꾸지는 않습니다.

n8n 워크플로와 실행 결과를 확인합니다.

유형: 업무 도구 · API 키
카테고리: 자동화
연결 방법: API 키

n8n은 워크플로 자동화 도구입니다. 여러 앱과 단계를 이어 트리거가 오면 실행되는 워크플로를 만들고, 한 번 실행될 때마다 실행 내역(execution)이 남습니다. API 키(소프트웨어가 내 n8n을 쓸 수 있게 해 주는, 비밀번호 같은 코드)로 n8n 인스턴스를 연결하면 MonstarX 에이전트(대화를 나누는 AI)가 작업하면서 워크플로와 실행 내역을 읽을 수 있습니다. 앱을 웹훅에 연결하기 전에 워크플로의 웹훅이 어떤 데이터를 기대하는지 확인하거나, 어젯밤 실행이 왜 실패했는지 살펴보는 식입니다.

이 커넥터는 업무 도구입니다. MonstarX가 사용자를 대신해 n8n을 읽습니다. 만드는 앱에는 키가 전달되지 않습니다.

MonstarX는 무엇을 할 수 있나요?

MonstarX가 할 수 있는 일	언제
워크플로 목록 보기(한 번에 최대 100개)	모든 모드
워크플로 하나 읽기: 단계와 설정	모든 모드
실행 내역 목록 보기: 전체 워크플로 또는 워크플로 하나	모든 모드
실행 내역 하나 읽기: 실행이 어떻게 진행되었는지	모든 모드

다음 작업은 하지 않습니다: 워크플로 실행·활성화·비활성화·생성·수정·삭제, 실행 재시도나 중지.

시작하기 전에

인터넷에서 일반 웹 주소의 HTTPS로 접근할 수 있는 n8n 인스턴스가 필요합니다. n8n Cloud(예: https://your-name.app.n8n.cloud)나 내 서버 모두 됩니다. 사설 네트워크 주소, IP 주소만 있는 주소, localhost는 거부됩니다.
n8n API가 필요합니다. n8n Cloud 무료 체험 중에는 쓸 수 없으니 먼저 업그레이드하세요. 셀프 호스팅 인스턴스라면 공개 API가 꺼져 있으면 안 됩니다.
MonstarX 프로젝트의 소유자여야 합니다. 도구를 연결하거나 연결 해제할 수 있는 사람은 소유자뿐입니다.

키 발급받기

n8n에 로그인하고 Settings > n8n API로 이동하세요.
Create an API key를 선택하고 Label(예: MonstarX)과 Expiration을 정하세요.
Enterprise 요금제라면 Scopes도 선택합니다. workflow:list, workflow:read, execution:list, execution:read를 주세요. 다른 요금제에서는 키에 모든 권한이 있습니다.
My API Key를 복사하세요.

n8n 공식 가이드: Authentication

MonstarX에서 연결하기

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터까지 스크롤해 n8n을 찾고 연결을 클릭하세요.
n8n 인스턴스 URL에 인스턴스 주소만 입력하고(예: https://your-name.app.n8n.cloud), API 키 입력란에 키를 붙여 넣은 뒤 연결을 클릭하세요.
MonstarX가 워크플로 하나를 조회해 주소와 키를 확인합니다. 확인되면 행에 인스턴스 주소와 함께 …에 연결됨이 표시됩니다. 주소나 키가 거부되면 오류 메시지가 표시되고, 아무것도 저장되지 않습니다.

MonstarX에 사용 요청하기

입력 예시	결과
“내 n8n 워크플로 ‘새 예약’을 읽고, 예약 양식이 그 웹훅으로 보내도록 만들어 주세요.”	MonstarX가 워크플로를 읽고 웹훅이 기대하는 데이터를 파악한 뒤, 만들기 모드에서 양식을 웹훅에 연결합니다.
“‘일일 보고서’ 워크플로가 어젯밤 실패한 이유가 뭔가요?”	해당 워크플로의 실행 내역을 조회하고 실패한 실행을 읽어 원인을 설명합니다.
“내 n8n 워크플로 중 활성화된 것은 무엇인가요?”	워크플로 목록과 각 상태를 보여 줍니다.

보안과 개인정보 보호

MonstarX에만 보관됩니다. 키는 암호화되어 MonstarX 서버에 저장됩니다. 앱 코드에 기록되거나 앱에 전달되는 일은 없습니다.
읽기 전용입니다. MonstarX는 읽기만 합니다. Enterprise 요금제라면 키에 읽기 권한만 주세요.
정보로만 읽습니다. 워크플로 데이터와 실행 결과에는 비즈니스 데이터가 들어 있을 수 있습니다. MonstarX는 이를 참고할 정보로만 다루고, 지시로 따르지 않습니다.
언제든 연결 해제할 수 있습니다. 백엔드클라우드에서 n8n 옆의 연결 해제를 클릭하고 이 프로젝트에서 n8n 연결을 해제할까요?를 확인하세요. MonstarX는 주소와 키를 삭제합니다. 더 이상 필요 없다면 Settings > n8n API에서도 키를 삭제하세요.

알아 두면 좋은 점

인스턴스는 요청마다 15초 안에 응답해야 합니다. 아주 느리거나 절전 상태인 인스턴스는 시간 초과가 날 수 있으니 다시 시도하세요.
n8n에서 키가 만료되면 요청이 실패합니다. 새 키를 만들고 다시 연결하세요.
앱이 워크플로를 실행하게 하려면 MonstarX에 앱에서 워크플로의 웹훅을 호출해 달라고 요청하세요. 웹훅 주소는 이 연결이 아니라 워크플로에 들어 있습니다.

자주 묻는 질문

MonstarX가 내 n8n 워크플로를 실행할 수 있나요?

이 연결로는 안 됩니다. 워크플로와 실행 내역을 읽기만 합니다. 대신 앱이 웹훅을 호출해 워크플로를 시작할 수는 있습니다. MonstarX에 그 기능을 만들어 달라고 요청하세요.

셀프 호스팅 n8n에서도 작동하나요?

네. 인스턴스가 인터넷에서 HTTPS 주소로 접근 가능하고 공개 API가 켜져 있다면 작동합니다. 사설 네트워크나 localhost에 있는 인스턴스에는 접근할 수 없습니다.

키가 거부되는 이유는 무엇인가요?

주소가 https://로 시작하고 ? 뒷부분이 없는지, 요금제에 n8n API가 포함되어 있는지(Cloud 무료 체험 제외), 키가 만료되지 않았는지 확인하세요.