跳到内容
Localtonet Localtonet 控制台

用 MCP 网关隧道公开 MCP 工具

桌面版 v7.8+ 移动版 v10.1+

获取本页帮助
本页内容 8 个章节
  1. 它是什么
  2. 开始之前
  3. 创建网关
  4. 打开 MCP 网关页面
  5. 填写表单
  6. 启动隧道
  7. URL 类型
  8. 网关令牌
  9. 连接 MCP 客户端
  10. 打开网关控制台
  11. 注册你的 MCP 服务器
  12. 创建客户端令牌
  13. 让 MCP 客户端指向网关
  14. 设置
  15. 故障排查
  16. 相关页面

MCP 网关隧道通过公共网关,把 MCP 客户端和 AI 助手连接到运行在你设备上的工具。网关由 Localtonet 客户端为你运行,隧道则为它提供公开的 HTTPS 地址。

它是什么 #

模型上下文协议(Model Context Protocol,MCP)让 AI 助手可以调用工具。MCP 网关位于你运行的各个 MCP 服务器之前,通过一个端点提供它们的所有工具。

启动 MCP 网关隧道时,Localtonet 客户端会在你的设备上启动一个网关,Localtonet 则把它发布在隧道的地址上。你不需要输入本地 IP 或端口。网关包含:

  • 位于 https://<ADDRESS>/dashboard 的 Web 控制台,你可以在其中注册 MCP 服务器并创建客户端令牌;
  • 位于 https://<ADDRESS>/mcp 的 MCP 端点,你的 MCP 客户端连接到这里。

它与 Localtonet MCP 服务器不是一回事。本页讲的是发布你自己的工具。如果想让 AI 助手管理你的 Localtonet 账户(隧道、令牌等),请参阅 MCP 服务器。

开始之前 #

  • 设备上运行着 Localtonet 客户端,并已使用 AuthToken 连接。参见快速入门。
  • 客户端版本足够新。使用此功能所需的 Localtonet 应用最低版本:Desktop v7.8、Mobile v10.1。

创建网关 #

  1. 打开 MCP 网关页面 #

    打开我的隧道 › MCP 网关,然后展开创建 MCP 网关隧道。

  2. 填写表单 #

    字段填写内容
    URL 类型随机子域名、自定义子域名或自定义域名。见下表。
    设备令牌运行你的工具的设备的令牌。
    服务器区域你的 MCP 客户端所连接的服务器。
    子域名选择自定义子域名时显示:你想要的名称。
    域名地址所用的域名。

    选择创建隧道。

  3. 启动隧道 #

    网关会出现在你的隧道下。选择启动。URL 列显示公开地址。

URL 类型 #

URL 类型得到的地址说明
随机子域名在你所选域名下生成的名称。适合第一次测试。
自定义子域名你输入的子域名,位于你所选的域名之下。需要有余额。
自定义域名你自己的某个域名。需要有余额。域名列表会显示你的域名;如果为空,请先在 DNS 管理器中创建域名。参见自定义域名。

网关令牌 #

每条 MCP 网关隧道在创建时都会获得自己的网关令牌。它是网关的管理令牌:网关控制台及其管理 API 只接受带有该令牌的更改。

  1. 选择隧道的设置图标。
  2. 在网关令牌旁选择管理。网关令牌窗口会显示令牌,中间部分被隐藏。
  3. 选择令牌旁的复制按钮。它总是复制完整的令牌。旁边的显示按钮可以在屏幕上显示令牌。

请妥善保管网关令牌。它能完全控制网关:包括它的服务器、工具和客户端令牌。不要把它填进 MCP 客户端;客户端使用它们自己的令牌。

连接 MCP 客户端 #

  1. 打开网关控制台 #

    隧道启动后,在浏览器中打开 https://<ADDRESS>/dashboard。把网关令牌粘贴到侧边菜单底部的 Admin token 字段中。

  2. 注册你的 MCP 服务器 #

    打开 Servers 并选择 Add Server。服务器可以是通过 URL 访问的 MCP 服务器(Streamable HTTP 或 SSE)、本地命令(stdio)或 OpenAPI 服务。Catalog 列出可以安装的现成 MCP 服务器,Tools 显示网关从所有服务器收集到的工具。

  3. 创建客户端令牌 #

    打开 Clients 并选择 New Client。输入 Name,然后选择 Create Client。网关只会显示一次 Client Token:请立即复制,之后不会再显示。在客户端列表中,Allowed Servers 和 Allowed Groups 显示客户端可以使用哪些服务器和工具组。

  4. 让 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。设置参考
基本认证?访问此隧道需要用户名和密码。访问控制
启用 HTTP/3?允许客户端使用 HTTP/3 连接公开端点。设置参考
旧版连接?如果隧道无法通过常规连接方式连接,请尝试此项。设置参考
网关令牌管理此 MCP 网关的访问令牌。见上文
HTTP 超时服务器在中止请求之前,等待你本地应用响应的时长,范围 1 到 600 秒。留空则使用服务器默认值。设置参考
隧道备注保存一条私有备注,帮助你识别或记录这条隧道。设置参考
IP 限制控制哪些客户端 IP 地址可以访问此隧道。访问控制
到期日期、速度限制、带宽限制、带宽用量到期日期、上传和下载速度限制、数据传输上限,以及用于重置已记录用量的清除。限制与到期
出站端口为 Localtonet 应用连接服务器选择一个固定的出站端口。端口
带宽流量、请求日志、活动日志、隧道健康状态随时间变化的流量、记录的请求、启动、停止和设置更改,以及最近的健康检查结果。日志与检查

在隧道列表中,Webhook列有一个查看请求和响应日志按钮,可为已启动的隧道打开请求检查器。参见日志与检查。

故障排查 #

网关无法启动,或地址没有响应

请检查设备上的 Localtonet 应用版本:MCP 网关至少需要 Desktop v7.8 或 Mobile v10.1。然后检查隧道已启动,并且连接列显示设备已连接。

网关控制台无法加载数据

控制台的管理请求需要管理令牌。Admin token 字段为空或不正确。请从隧道的设置中重新复制网关令牌,并粘贴到该字段。

MCP 客户端被拒绝

MCP 端点需要在 Authorization: Bearer 头中提供客户端令牌。请在网关控制台的 Clients 下创建一个并在这里使用,而不是使用网关令牌。

“请先启动你的隧道。”

请求检查器只有在隧道已启动时才可用。

“你必须先在 DNS 管理器中创建域名!”或“警告!你还没有任何域名!”

自定义域名需要你自己的某个域名。请在 DNS 管理器中添加,或选择其他 URL 类型。

“你需要购买余额才能使用此功能。”

自定义子域名和自定义域名需要有余额。请使用随机子域名,或充值余额。参见套餐与余额。

支持