n8n 연동

n8n 워크플로 속 HelpRange

셀프 호스팅이나 n8n 클라우드 – HTTP Request 노드로 HelpRange에 문서를 올리고, 원하는 보호가 적용된 추적 링크를 만들고, 문서가 열리면 워크플로를 실행하세요. n8n AI 에이전트와 MCP 서버와 함께 쓰세요.

바이너리 데이터 업로드

아무 노드(Drive, S3, IMAP)에서 바이너리 파일을 multipart “file”로 /api/v2/files에 보내세요.

원하는 설정의 링크

링크별 암호, 만료, 열람 횟수 제한, 워터마크, 이메일 확인, 다운로드 제어.

열람 기반 워크플로

Webhook 노드 + HelpRange 웹훅, 또는 /api/v2/views를 폴링하는 Schedule Trigger.

AI 에이전트

n8n AI Agent는 MCP Client 도구로 HelpRange를 쓸 수 있습니다: https://www.helprange.com/mcp.

내 권한만

API 키는 본인으로 동작합니다 – 내 폴더만, 아무것도 삭제할 수 없습니다.

셀프 호스팅 친화적

순수 HTTPS와 JSON – 커뮤니티 노드 설치 불필요.

API

Zapier, Make, n8n용 엔드포인트

가이드: Zapier · Make · n8n · AI 어시스턴트용 MCP

인증. Settings → Profile → API key의 API 키를 X-API-Key 헤더(또는 Authorization: Api-Key <key>)로 보내세요. OAuth 액세스 토큰도 됩니다.

POST https://www.helprange.com/api/v2/files
파일 업로드: multipart 필드 "file", 또는 "file_url"(공개 링크), 또는 "content_base64" + "filename", 선택 "folder_id". 문서 id와 기본 공유 링크를 반환합니다.

POST https://www.helprange.com/api/v2/files/{id}/links
공유 링크 생성. JSON: label, allow_download, passcode, expires_on(YYYY-MM-DD), views_limit, watermark, require_email, disallow_forwarding, one_viewer_at_a_time. URL을 반환합니다.

GET https://www.helprange.com/api/v2/views
트리거 “New document view”: 최신 열람 순 – 열람자, 문서, 링크, 읽은 초, 국가.

GET https://www.helprange.com/api/v2/uploads
트리거 “New file from a client”: 파일 요청과 데이터룸으로 업로드된 파일.

GET https://www.helprange.com/api/v2/folders, /api/v2/documents, /api/v2/me
드롭다운용 폴더와 문서, “me”로 연결을 테스트합니다.

curl -X POST https://www.helprange.com/api/v2/files/123/links \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"label": "ACME – Anna", "passcode": "s3cret", "expires_on": "2026-12-31", "watermark": true}'
작동 방식
1. 자격 증명 만들기

이름 X-API-Key와 HelpRange API 키로 Header Auth.

2. HTTP Request 노드 추가

POST https://www.helprange.com/api/v2/files, 본문 “Form-Data”, 바이너리 필드 “file”.

3. 링크 만들기

HTTP Request 하나 더: JSON 설정과 함께 POST /api/v2/files/{{ $json.id }}/links.

3일 체험과 Pro, Unlimited 플랜에 포함. 플랜 및 요금

FAQ

n8n 연동 – 개 질문

HelpRange 커뮤니티 노드가 있나요?

필요 없습니다: HTTP Request 노드로 모든 엔드포인트를 다루며, X-API-Key 헤더가 있는 자격 증명만 설정하면 됩니다.

n8n AI 에이전트가 제 문서로 작업할 수 있나요?

네 – 에이전트를 HelpRange MCP 서버에 연결하면 문서와 통계를 읽고, 파일을 올리고, 링크를 만들 수 있습니다.

파일은 어디에 저장되나요?

독일 프랑크푸르트(EU)에 암호화 저장.

내 문서로 직접 해보기

3일 무료 체험 후 무료 플랜으로 전환됩니다. 신용카드가 필요 없습니다.

무료 체험 시작