대시보드
지역
-
공유기
-
포트포워딩 규칙
-
👋 처음이신가요?
- 왼쪽 지역 탭에서
Seoul-HQ같은 라벨을 한두 개 만드세요 (선택). - 그 다음 공유기 탭 → + 공유기 추가 로 ipTIME / UniFi 정보를 등록.
- 등록된 공유기의 ▸ 버튼을 누르면 포트포워딩 탭이 자동으로 활성화됩니다.
- AI 가 자동으로 포트를 열게 하려면 설정 → MCP 토큰 에서 본인 토큰을 발급하세요.
이 안내는 공유기·규칙이 하나라도 생기면 자동으로 사라집니다.
포트포워딩 현황
모든 공유기의 포트포워딩 규칙을 한눈에 봅니다. 행을 클릭하면 해당 공유기의 포트포워딩 관리로 이동합니다.
| 규칙 | 프로토콜 | 외부 포트 | → 내부 | 설명 |
|---|
등록된 공유기
좌측의 ▸ 버튼을 누르면 상세 정보·관리자 페이지·포트포워딩 규칙을 한 화면에서 볼 수 있어요.
| 이름 | 지역 | 타입 | 호스트 | 계정 | 작업 |
|---|
공유기 추가
지역 목록
지역은 공유기를 위치 단위로 묶는 그룹입니다. 지역 삭제 시 소속 공유기의 지역은 자동 해제됩니다(공유기 자체는 보존).
| 이름 | 코드 | 설명 | 공유기 수 | 작업 |
|---|
지역 추가 (관리자 전용)
포트포워딩 규칙
| 순번 | 이름 | 프로토콜 | 외부 포트 | 내부 IP | 내부 포트 | 설명 | 등록자 | 작업 |
|---|
규칙 추가
🤖 MCP — AI 에이전트 연결
전체 가이드 ↗
두 단계면 끝: 아래에서 ① 본인 토큰 발급 → ② 사용할 AI 클라이언트 카드의 "복사" 버튼. URL·토큰을 직접 조립할 필요 없이, 클립보드에 들어간 그대로 클라이언트 설정에 붙여 넣으면 됩니다.
① 토큰 발급 + 선택
로그인한 본인(
-) 명의 토큰만 보입니다. 토큰으로 들어온 호출은 모두 본인 이름으로 audit log 에 남고, 포트를 열면 created_by 가 자동 채워집니다.
🔑 토큰이 생성됐습니다 — 이 화면을 떠나면 평문은 다시 못 봅니다
…
아래 ②번의 클라이언트 카드는 이 토큰까지 박힌 채로 자동 채워져 있습니다.
| 이름 | 발급 | 마지막 사용 | 만료 | 상태 | 작업 |
|---|---|---|---|---|---|
| 불러오는 중… | |||||
② AI 클라이언트에 붙여넣기
현재 토큰:
(없음 — ①에서 발급)아래 카드들은 ①에서 방금 발급한 토큰을 직접 박아 넣은 채로 자동 채워집니다. 기존 토큰을 쓰고 싶다면 발급 시 따로 보관한 값을
<YOUR_TOKEN> 자리에 붙여 넣어 주세요.
🌐 URL 한 줄 — 다른 MCP 클라이언트처럼 주소만 붙여넣기
토큰이 URL
?token=… 에 묻어있어 헤더 설정 없이 그대로 한 줄로 등록됩니다.
ChatGPT Connectors · Claude.ai Custom Connectors · Cursor "Add Remote MCP" 등에 가장 잘 맞는 방식입니다.
…
⚠️ URL 에 토큰이 들어있으므로 채팅·이메일·이슈에 공유하지 마세요. 노출되면 즉시 ①에서 폐기 + 재발급.
⚡ stdio 어댑터 —
mcp-remote
HTTP 를 못 받는 클라이언트(현행 Claude Desktop, 일부 Cline 버전)에서 stdio↔HTTP 변환. Node 필요.
…
🧪 curl 테스트 — 도구 목록 확인
연결 확인용. 21 개 도구 이름이 JSON 으로 나옵니다.
…
🟠 Claude Desktop —
claude_desktop_config.json
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json…
🟣 Cursor —
~/.cursor/mcp.json
채팅에서
@router-port-manager 로 도구를 호출하세요.…
🟢 Cline (VS Code) — settings.json
Cline 사이드패널 → "MCP Servers" → "Edit Configuration" 으로 열고 붙여 넣기.
…
🛡️ URL + 헤더 분리형 — 보안 우선
토큰이 access log·history 에 안 남게 분리.
Authorization: Bearer 헤더 입력란이 있는 클라이언트에서 사용.…
③ 도구 — AI 가 호출할 수 있는 것들
읽기 (10)
get_status·get_overview·list_regions·list_routersget_router_details·list_port_forwards·crawl_port_forwardstest_router_connection·list_tags·whoamipermissions_self_check— 내 가시 라우터 / 그룹 / 도구 카운트 진단
쓰기 (11)
create_port_forward_rule✱ — code_url/deployment_url/execution_server 중 1개 필수delete_port_forward_rule·update_rule_metadatacreate_router·update_router·delete_routercreate_region·update_region·delete_regioncreate_tag·delete_tag
권장 순서:
whoami → permissions_self_check → 읽기 → 쓰기. 포트가 이미 있으면 충돌 응답에 conflicts 가 들어옵니다.설정 (Settings)
관리자만 수정할 수 있습니다. 일반 사용자는 읽기 전용.
Cloudflare API 계정들
새 계정 추가
NPM (Nginx Proxy Manager) 계정
불러오는 중…
내 그룹
-
Django Admin에서 사용자 그룹을 관리하세요.
그룹별 접근 정책
관리자 전용. 그룹별로 어떤 공유기를 볼 수 있는지 지정합니다. 아래는 위저드, 상세 편집은 JSON 으로 펼쳐서.
고급 — JSON 직접 편집
태그 관리
규칙에 다는 태그의 색상 변경/삭제. 새 태그는 규칙 편집에서 입력하면 자동 생성됩니다.
🤖 MCP 토큰
토큰 발급 · 폐기 · 클라이언트별 자동 채워진 설정 스니펫(Claude Desktop / Cursor / Cline / curl)은 모두 🤖 MCP 탭 한 화면에서 처리합니다.
설정 탭에서는 이 안내만 남겨 두었습니다 — 발급된 내 토큰 빠른 확인:
| 이름 | 마지막 사용 | 상태 |
|---|---|---|
| 불러오는 중… | ||
담당자(
-) 명의의 토큰만 표시됩니다.🔌 연결 상태
Cloudflare
상태 확인 중…
Nginx Proxy Manager
상태 확인 중…
연결이 안 되면 설정 → Cloudflare / NPM 계정 카드에서 자격증명을 갱신하세요.
All-in-one: 도메인 + 역방향 프록시 자동 구성
Cloudflare DNS 레코드 (개별 생성)
Nginx Proxy Manager — 프록시 호스트 (개별 생성)
🌐 Cloudflare 발급 DNS
관리자만 삭제 가능. 표는 선택한 zone 의 DNS 레코드 전체를 가져옵니다.
| Type | Name | Content | Proxied | TTL | 작업 |
|---|---|---|---|---|---|
| Zone 을 선택하면 표시됩니다. | |||||
🪜 NPM 프록시 호스트
관리자만 삭제 가능. NPM 인스턴스에 등록된 모든 프록시 호스트.
| 도메인 | Forward | SSL | 활성 | 수정 | 작업 |
|---|---|---|---|---|---|
| 불러오는 중… | |||||