MCP 게이트웨이 터널로 MCP 도구 공개하기
Desktop v7.8+ Mobile v10.1+
이 페이지의 내용 섹션 8개
MCP 게이트웨이 터널은 MCP 클라이언트와 AI 어시스턴트를 공개 게이트웨이를 통해 내 기기에서 실행되는 도구에 연결합니다. 게이트웨이는 Localtonet 클라이언트가 실행하며, 터널이 여기에 공개 HTTPS 주소를 부여합니다.
설명 #
Model Context Protocol(MCP)은 AI 어시스턴트가 도구를 호출할 수 있게 해 줍니다. MCP 게이트웨이는 내가 실행하는 MCP 서버들 앞에 놓여 모든 도구를 하나의 엔드포인트로 제공합니다.
MCP 게이트웨이 터널을 시작하면 Localtonet 클라이언트가 기기에서 게이트웨이를 시작하고, Localtonet이 이를 터널의 주소에 게시합니다. 로컬 IP나 포트는 입력하지 않습니다. 게이트웨이에는 다음이 있습니다.
- MCP 서버를 등록하고 클라이언트 토큰을 만드는 웹 대시보드:
https://<ADDRESS>/dashboard - MCP 클라이언트가 연결하는 MCP 엔드포인트:
https://<ADDRESS>/mcp
Localtonet MCP 서버와는 다릅니다. 이 페이지는 내 도구를 공개하는 방법을 다룹니다. AI 어시스턴트가 내 Localtonet 계정(터널, 토큰 등)을 관리하게 하려면 MCP 서버를 참고하세요.
시작하기 전에 #
- 기기에서 Localtonet 클라이언트가 실행 중이며 AuthToken으로 연결되어 있습니다. 빠른 시작을 참고하세요.
- 클라이언트 버전이 충분히 최신이어야 합니다. 이 기능을 사용하려면 Localtonet 앱이 최소
Desktop v7.8,Mobile v10.1버전이어야 합니다.
게이트웨이 만들기 #
-
MCP 게이트웨이 페이지 열기 #
내 터널 › MCP 게이트웨이를 열고 MCP 게이트웨이 터널 만들기를 펼칩니다.
-
양식 작성하기 #
필드 입력할 내용 URL 유형 랜덤 서브도메인, 커스텀 서브도메인 또는 커스텀 도메인. 아래 표를 참고하세요. 기기 토큰 도구를 실행하는 기기의 토큰입니다. 서버 리전 MCP 클라이언트가 접속하는 서버입니다. 서브도메인 커스텀 서브도메인에서 표시됩니다. 원하는 이름입니다. 도메인 주소의 도메인입니다. 터널 만들기를 선택합니다.
-
터널 시작하기 #
게이트웨이가 내 터널 아래에 나타납니다. 시작을 선택하세요. URL 열에 공개 주소가 표시됩니다.
URL 유형 #
| URL 유형 | 받는 주소 | 참고 |
|---|---|---|
| 랜덤 서브도메인 | 선택한 도메인 아래에 생성된 이름입니다. | 처음 테스트하기에 좋습니다. |
| 커스텀 서브도메인 | 선택한 도메인 아래에 입력한 서브도메인입니다. | 잔액이 필요합니다. |
| 커스텀 도메인 | 내 도메인 중 하나입니다. | 잔액이 필요합니다. 도메인 목록에 내 도메인이 표시됩니다. 비어 있으면 먼저 DNS 매니저에서 도메인을 만드세요. 커스텀 도메인을 참고하세요. |
게이트웨이 토큰 #
모든 MCP 게이트웨이 터널은 만들 때 자체 게이트웨이 토큰을 받습니다. 이 토큰은 게이트웨이의 관리자 토큰입니다. 게이트웨이 대시보드와 관리 API는 이 토큰이 있어야만 변경을 허용합니다.
- 터널의 설정 아이콘을 선택합니다.
- 게이트웨이 토큰 옆의 관리를 선택합니다. 게이트웨이 토큰 창에 가운데가 가려진 토큰이 표시됩니다.
- 토큰 옆의 복사 버튼을 선택합니다. 항상 전체 토큰이 복사됩니다. 그 옆의 표시 버튼을 누르면 화면에 토큰이 표시됩니다.
게이트웨이 토큰은 비공개로 유지하세요. 게이트웨이의 서버, 도구, 클라이언트 토큰에 대한 모든 권한을 줍니다. MCP 클라이언트에는 입력하지 마세요. 클라이언트는 자체 토큰을 사용합니다.
MCP 클라이언트 연결하기 #
-
게이트웨이 대시보드 열기 #
터널을 시작한 상태에서 브라우저로
https://<ADDRESS>/dashboard를 엽니다. 사이드 메뉴 맨 아래의 Admin token 필드에 게이트웨이 토큰을 붙여 넣으세요. -
MCP 서버 등록하기 #
Servers를 열고 Add Server를 선택합니다. 서버는 URL로 접속하는 MCP 서버(Streamable HTTP 또는 SSE), 로컬 명령(stdio), OpenAPI 서비스 중 하나일 수 있습니다. Catalog에는 설치할 수 있는 기성 MCP 서버가 나열되고, Tools에는 게이트웨이가 모든 서버에서 수집한 도구가 표시됩니다.
-
클라이언트 토큰 만들기 #
Clients를 열고 New Client를 선택합니다. Name을 입력하고 Create Client를 선택합니다. 게이트웨이는 Client Token을 한 번만 표시합니다. 다시 표시되지 않으므로 지금 복사하세요. 클라이언트 목록의 Allowed Servers와 Allowed Groups에는 클라이언트가 사용할 수 있는 서버와 도구 그룹이 표시됩니다.
-
MCP 클라이언트가 게이트웨이를 가리키게 하기 #
MCP 클라이언트나 AI 어시스턴트에서 다음 두 값으로 원격 MCP 서버를 추가하세요.
MCP 클라이언트 설정URL: https://<ADDRESS>/mcp Header: Authorization: Bearer <CLIENT_TOKEN>입력하는 위치는 클라이언트마다 다릅니다. 원격(HTTP) MCP 서버에 대한 해당 클라이언트의 문서를 따르세요.
대시보드의 Audit Log에는 최근 게이트웨이 요청이 표시되고, Settings에는 백업 및 복원이 있는 게이트웨이 구성이 있습니다.
게이트웨이는 서버, 그룹, 클라이언트, 감사 로그를 내 기기의 Localtonet 클라이언트 작업 디렉터리에 있는 mcp-data-<TUNNEL_ID> 폴더(Android에서는 앱 자체 저장소 안)에 저장합니다. <TUNNEL_ID>는 ID 열의 숫자이므로 MCP 게이트웨이 터널마다 자체 폴더를 가집니다.
설정 #
터널의 설정 아이콘을 선택하면 터널 설정이 열립니다.
| 설정 | 기능 | 추가 정보 |
|---|---|---|
| 로드 밸런스 | 여러 기기에 트래픽을 분산하거나, 대상을 사용할 수 없을 때 백업을 사용합니다. | 로드 밸런싱 |
| HTTPS 전용 | 공개 터널 엔드포인트에 HTTPS만 사용합니다. | 설정 참조 |
| Basic 인증 | 이 터널에 접속하려면 사용자 이름과 비밀번호를 요구합니다. | 접근 제어 |
| HTTP/3 활성화 | 클라이언트가 HTTP/3으로 공개 엔드포인트에 연결할 수 있게 합니다. | 설정 참조 |
| 레거시 연결 | 터널이 일반 연결 방식으로 연결되지 않을 때 시도해 보세요. | 설정 참조 |
| 게이트웨이 토큰 | 이 MCP 게이트웨이의 액세스 토큰을 관리합니다. | 위를 참고하세요 |
| HTTP 타임아웃 | 서버가 요청을 중단하기 전에 로컬 애플리케이션의 응답을 기다리는 시간으로, 1~600초입니다. 비워 두면 서버 기본값을 사용합니다. | 설정 참조 |
| 터널 메모 | 이 터널을 식별하거나 기록하는 데 도움이 되는 비공개 메모를 저장합니다. | 설정 참조 |
| IP 제한 | 이 터널에 접근할 수 있는 클라이언트 IP 주소를 제어합니다. | 접근 제어 |
| 만료일, 속도 제한, 대역폭 제한, 대역폭 사용량 | 만료일, 업로드 및 다운로드 속도 제한, 데이터 전송 한도, 그리고 기록된 사용량을 초기화하는 지우기입니다. | 제한 및 만료 |
| 아웃바운드 포트 | Localtonet 앱이 서버에 연결할 때 사용할 고정 아웃바운드 포트를 선택합니다. | 포트 |
| 대역폭 트래픽, 요청 로그, 활동 로그, 터널 상태 점검 | 시간별 트래픽, 기록된 요청, 시작, 중지, 설정 변경, 최근 상태 점검 결과입니다. | 로그 및 검사 |
터널 목록의 웹훅 열에는 시작된 터널의 요청 검사기를 여는 요청 및 응답 로그 보기 버튼이 있습니다. 로그 및 검사를 참고하세요.
문제 해결 #
게이트웨이가 시작되지 않거나 주소가 응답하지 않습니다
기기의 Localtonet 앱 버전을 확인하세요. MCP 게이트웨이에는 최소 Desktop v7.8 또는 Mobile v10.1이 필요합니다. 그런 다음 터널이 시작되었고 연결 열에 기기가 연결된 것으로 표시되는지 확인하세요.
게이트웨이 대시보드가 데이터를 불러오지 못합니다
대시보드의 관리 요청에는 관리자 토큰이 필요합니다. Admin token 필드가 비어 있거나 잘못되었습니다. 터널의 설정에서 게이트웨이 토큰을 다시 복사해 필드에 붙여 넣으세요.
MCP 클라이언트가 거부됩니다
MCP 엔드포인트에는 Authorization: Bearer 헤더에 클라이언트 토큰이 필요합니다. 게이트웨이 대시보드의 Clients에서 토큰을 만들어 여기에 사용하세요. 게이트웨이 토큰을 쓰면 안 됩니다.
"먼저 터널을 시작하세요."
요청 검사기는 터널이 시작된 동안에만 사용할 수 있습니다.
"DNS 매니저에서 도메인을 먼저 만들어야 합니다!" 또는 "경고! 등록된 도메인이 없습니다!"
커스텀 도메인에는 내 도메인이 필요합니다. DNS 매니저에서 추가하거나 다른 URL 유형을 선택하세요.
"이 기능을 사용하려면 잔액을 구매해야 합니다."
커스텀 서브도메인과 커스텀 도메인에는 잔액이 필요합니다. 랜덤 서브도메인을 사용하거나 잔액을 충전하세요. 플랜 및 잔액을 참고하세요.