권한 요약·문제 해결

등급별 권한 요약

* n8n 계정 링크가 필요하며 n8n에서 본인에게 허용된 리소스만 표시됩니다. 프로젝트 그룹 트리는 공통이지만 포함 프로젝트와 집계는 사용자 권한으로 필터링됩니다. 승인 대기 사용자는 로그인해도 대기 화면 외 기능을 사용할 수 없습니다.

자주 묻는 질문

프로젝트 그룹·API 키·네이밍 규칙 메뉴가 보이지 않습니다.

Owner/Admin 등급인지 확인하고 현재 라이선스에 프로젝트 그룹, 외부 API 또는 리소스 네이밍 기능이 포함됐는지 관리자에게 문의합니다.

프로젝트 그룹의 값이 전체 사용량과 다릅니다.

그룹 미지정·프로젝트 미확인 행과 권한으로 제외된 프로젝트 수를 확인합니다. 프로젝트를 한 그룹에만 배정하면 Owner/Admin 기준 그룹 합계가 전체와 일치합니다.

네이밍 위반을 선택했는데 이름을 변경할 수 없습니다.

복수 허용값·임의 문자열·정규식이 들어간 규칙은 목표 이름을 하나로 결정할 수 없어 점검·확인 요청만 지원합니다. 지정값 또는 프로젝트 그룹 값으로 결정 가능한 구성인지 확인합니다.

외부 API 호출이 인증에 실패합니다.

키가 활성·미만료 상태인지, 발급자가 아직 Owner/Admin인지, 요청에 필요한 조회·수정 권한이 있는지 확인합니다. 폐기했거나 원문을 잃은 키는 복구할 수 없으므로 새 키를 발급합니다.

인스턴스를 추가했는데 AI 채팅의 범위에 나오지 않습니다.

설정 → 연동에서 상태와 스키마 스캔을 확인하고 재스캔합니다. 스캔 완료 전 인스턴스는 분석 범위에 표시되지 않을 수 있습니다.

Member/Explorer인데 리소스 맵이나 대시보드 데이터가 없습니다.

프로필의 n8n 계정 링크를 연결하고 API Key 만료와 n8n 원본 권한을 확인합니다.

워크플로 오류 알림이 오지 않습니다.

n8n Log Streaming에 Nelper Webhook이 등록됐는지, 설정 → 연동의 마지막 이벤트 수신 시각이 갱신되는지 확인합니다.

Live Runs에 Workflow 이벤트 미선택 또는 Node 이벤트 미선택이 표시됩니다.

n8n Settings → Log Streaming의 해당 Webhook에서 Workflow Events의 Started, Success, Failed를 모두 선택합니다. 현재 노드도 보려면 Node Executions의 Started를 추가로 선택합니다.

n8n 감사 이벤트가 비어 있습니다.

Log Streaming destination에서 Audit 이벤트 구독을 켭니다. 구독 전 이벤트는 자동 소급 수집되지 않습니다.

Error Workflow 할당 목록이 비어 있습니다.

n8n에 Error Trigger로 시작하는 워크플로가 있고 Published 상태인지 확인합니다. Nelper는 Error Workflow를 자동 생성하지 않습니다.

Error Workflow 할당이 실패합니다.

인스턴스 n8n API Key가 등록됐는지, 연결 검증에서 필요한 workflow 권한과 만료 상태가 정상인지 확인합니다.

AI Insight에 Addon 연결 필요가 표시됩니다.

설정 → 연동에서 AI Workflow Addon URL과 API Secret을 저장하고 Health Check를 통과한 뒤 활성화합니다.

LLM 연동에 실패하여 AI 기능을 사용할 수 없다는 안내가 표시됩니다.

비용·사용량 → Nelper AI 비용의 LLM 연동 카드에서 인증·결제·권한 또는 연결 오류 원인을 확인합니다. 원인을 해결한 뒤 다시 확인을 선택하면 정상 상태에서 새 AI 작업이 다시 열립니다.

채팅·보고서·분석 버튼이 ‘한도 도달’로 비활성화됩니다.

비용·사용량 → Nelper AI 비용의 기능별 월 한도를 확인합니다. 한도는 매월 1일 UTC에 초기화됩니다.

Token Usage 예상 비용이 보이지 않습니다.

LiteLLM 가격표 조회 네트워크와 모델명 매칭을 확인합니다. 실제 비용이 아니라 추정치임도 함께 확인합니다.

Relation 그래프가 너무 커서 표시되지 않습니다.

노드와 연결선을 합친 전체 요소가 10,000개를 넘으면 프로젝트 범위를 선택해야 합니다. 선택한 범위도 크면 프로젝트 수를 줄이며, 한 프로젝트만으로 한도를 넘으면 해당 프로젝트는 표시할 수 없습니다.

노드 정책이 정상 워크플로를 위반으로 표시합니다.

정책의 실제 필드 경로와 마스킹 값을 확인하고, 표현식·서브도메인·포트·대소문자를 반영해 조건을 조정합니다.

노드 정책 자동 게시 해제가 실패합니다.

n8n API Key의 workflow:read와 workflow:deactivate 권한, 키 만료와 대상 워크플로 Published 상태를 확인합니다.

MFA 인증기와 복구 코드를 모두 잃었습니다.

Owner/Admin에게 멤버 관리의 MFA 초기화를 요청하고 다음 로그인에서 MFA를 다시 등록합니다.

승인됐는데 계속 가입 대기 화면이 표시됩니다.

완전히 로그아웃한 뒤 다시 로그인합니다. 계속되면 멤버 화면에서 승인 상태와 등급을 확인합니다.

프로젝트 공유 링크를 상대가 열지 못합니다.

같은 Nelper 조직에 로그인한 Owner/Admin인지 확인합니다. Member/Explorer는 AI 프로젝트에 접근할 수 없습니다.

AI 채팅 대화가 사라졌습니다.

채팅 기록은 화면 이동이나 새로고침 뒤 유지되지 않습니다. 생성 결과는 사이드바 프로젝트 또는 보고서에서 다시 엽니다.

관리자에게 전달할 진단 정보

• 발생 시각과 사용한 사용자 등급
• 대상 n8n 인스턴스명과 화면 경로
• 재현 순서와 화면에 표시된 오류 문구
• 인스턴스 연결·스캔·마지막 이벤트 수신 상태
• 관련 감사 이벤트 ID 또는 워크플로 Execution ID