MCP 연결

Claude Code나 ChatGPT 같은 AI 앱에서 평소 말로 Nelper에게 물어볼 수 있습니다. 화면을 오가지 않고 워크플로 상태, 실패 원인, 사용량을 확인합니다.

이렇게 씁니다

터미널이나 채팅창에 질문을 쓰면 AI 앱이 Nelper를 조회해 답합니다. 내 Nelper 권한으로 볼 수 있는 내용만 답에 나옵니다.

> 이번 계약에서 n8n 실행이 얼마나 남았어?

● nelper · n8n 라이선스 사용량

이번 계약에서 남은 n8n 실행은 약 212,790회이지만, 확정값은 아닙니다.

  계약 기간: 2026-06-30 00:00 ~ 2027-06-30 00:00 (KST)
  포함 한도: 600,000회
  누적 사용: 387,210회 (약 64.5%)
  남은 실행: 최소 212,790회 (약 35.5%)
  초과 실행: 0회

비용·사용량 화면에서 확인할 수 있습니다. → /settings?tab=cost

> 지금 열려 있는 이상 감지 경보 있어?

● nelper · 이상 감지 경보 (state: open)

네, demo.n8n에 열린 경보가 9건 있습니다. 모두 실행 시간 초과 경보이고
임계값은 30분입니다.

  - SSL 인증서 만료 알림 (플랫폼 · IT): 약 10.6일째, 10/25 03:32 감지
  - 재고 부족 알림 (커머스 운영): 약 10.6일째, 10/25 03:32 감지
  - 광고비 ROAS 집계 (데이터): 약 10.6일째, 10/25 03:32 감지
  - 6건 생략

모니터 상태는 정상이고 9건 모두 이메일 알림이 발송됐습니다.
Nelper에서 경보 보기 → ?view=live&panel=alerts

시작하기

세 단계입니다. 앞 단계가 이미 끝나 있으면 건너뜁니다. 쓸 수 있는 도구가 이미 있는 사용자는 3단계부터 보면 됩니다.

Nelper 라이선스에 MCP 연동이 포함되어 있어야 합니다. 없으면 MCP 연결 메뉴와 멤버 표의 MCP 열이 보이지 않습니다.

1단계: 서버에서 켜기 (설치 담당자)

1. 서버 환경 변수 MCP_ENABLED=true를 설정합니다. 기본값은 꺼짐입니다.
2. WEBSITE_DOMAIN을 사용자가 접속하는 HTTPS 주소로 둡니다. localhost가 아닌 http면 서버가 시작되지 않습니다.
3. 백엔드를 다시 시작합니다.

2단계: 도구 켜기 (Owner, Admin)

도구는 처음에 모두 꺼져 있습니다. Owner와 Admin 자신도 예외가 아닙니다. 도구 결과는 연결한 AI 서비스로 전달되며 실행 오류 메시지와 작성자 이메일이 포함될 수 있으니, 조직의 AI 사용 정책을 확인한 뒤 켜세요.

1. 설정 → 멤버의 MCP 열에서 사람을 선택합니다.
2. MCP 허용 도구 창에서 묶음이나 도구를 체크하고 저장을 선택합니다. 저장하면 이미 연결된 앱에도 바로 적용됩니다.

• Member와 Explorer 여러 명은 표에서 체크한 뒤 선택 막대의 MCP 도구로 한 번에 맞춥니다.
• 새 도구가 추가되어도 자동으로 켜지지 않습니다.
• 도구를 켜도 Nelper 라이선스에 해당 화면 기능이 없으면 라이선스 제한으로 표시되고 쓸 수 없습니다.

3단계: 내 AI 앱에 연결하기 (각 사용자)

1. 계정 설정에서 MCP 연결을 엽니다. 쓸 수 있는 도구가 0개면 관리자에게 도구를 요청합니다.
2. Owner와 Admin이 아니라면 n8n 계정 연결을 먼저 마칩니다. 연결하지 않은 인스턴스는 조회되지 않습니다.
3. AI 클라이언트에 추가에서 쓰는 앱의 탭을 고르고 안내대로 추가합니다.
4. 브라우저가 열리면 Nelper에 로그인하고 승인합니다. 승인 화면이 열리고 10분이 지나면 AI 앱에서 다시 연결해야 합니다.
5. AI 앱으로 돌아가 질문합니다.

Claude Code는 화면의 명령을 복사해 터미널에서 실행합니다. 이어서 claude를 실행하고 /mcp에서 nelper를 고른 뒤 Authenticate를 선택하면 브라우저가 열립니다.

$ claude mcp add --transport http --scope user nelper https://nelper.example.com/api/mcp

$ claude
> /mcp

다른 AI 앱은 아래처럼 추가합니다. 화면의 탭에 같은 안내가 복사 버튼과 함께 나옵니다.

승인 화면에서 확인할 것

무엇을 물어볼 수 있나요

> 지난 30일 동안 토큰을 가장 많이 쓴 워크플로 5개 보여 줘

● nelper · LLM 토큰 사용량 (by: workflow, limit: 5)
  └ 지난 30일 0건
● nelper · LLM 토큰 사용량 (기간을 올해 전체로 넓혀 다시 조회)

지난 30일 동안 demo.n8n에 기록된 토큰 사용량이 0건이라 상위 5개를 뽑을 수
없습니다. 참고로 기록이 있는 기간 전체의 상위는 다음과 같습니다.

  1. 상품 카탈로그 임베딩 동기화: 31,080,688 토큰, $29.77
  2. AI 리뷰 감성 분석 배치: 10,282,051 토큰, $48.77
  3. CS 문의 알림 라우팅: 3,196,650 토큰, $0.70

할 수 없는 일

• n8n 워크플로나 운영 설정을 바꿀 수 없습니다.
• 새 AI 분석을 실행하지 않습니다. 저장된 결과만 읽으며, 새 분석은 Nelper 화면에서 실행합니다.

바꿀 수 있는 것은 내 알림뿐입니다

내 알림 읽음 처리와 내 알림 설정만 바꿀 수 있습니다. 변경 도구는 바뀔 내용을 먼저 확인한 뒤 저장합니다. 요청이 분명하면 AI 앱이 내게 다시 묻지 않고 저장까지 진행할 수 있습니다. 원하지 않으면 승인할 때 변경도 허용을 끕니다. 필수 알림은 꺼도 계속 옵니다.

> 워크플로 오류 알림을 모든 실행으로 받게 바꿔 줘

● nelper · 워크플로 오류 알림 범위 (미리보기)
  └ 바뀔 내용: 운영 실행만 → 모든 실행. 아직 저장하지 않았습니다.
● nelper · 워크플로 오류 알림 범위 (저장)
  └ 저장했습니다.

워크플로 오류 알림 범위를 운영 실행만에서 모든 실행으로 바꿔 저장했습니다.

연결 끊기

1. 설정 → MCP 연결의 내 연결에서 앱을 찾습니다.
2. 해제와 연결 해제를 차례로 선택합니다. 바로 끊깁니다.

• Owner와 Admin은 멤버 표의 MCP 셀에서 연결 모두 끊기로 멤버의 연결을 끊습니다.
• 도구를 끄면 다시 승인하지 않아도 다음 호출부터 거부됩니다.
• 30일 동안 쓰지 않은 연결은 다시 승인해야 합니다.
• 계정이 비활성·삭제되면 연결도 막힙니다. 등급이 내려가면 관리자 조회 도구가 빠지고, 다시 올려도 자동으로 돌아오지 않습니다.

어떤 정보가 어디로 가나요

• AI 서비스로 전달되는 것: 도구 결과입니다. 실행 오류 메시지와 작성자 이메일이 포함될 수 있으니 조직의 AI 사용 정책을 확인한 뒤 도구를 켜세요.
• 전달되지 않는 것: 비밀값과 실행 입력·출력은 도구 결과에 없고, 노드 정책 값은 가려집니다.
• 남는 기록: 연결 승인·거부·해제, 모든 도구 호출, 도구 허용 변경이 감사로그의 MCP 유형에 남습니다.

문제가 생겼을 때