用 MCP 网关隧道公开 MCP 工具
桌面版 v7.8+ 移动版 v10.1+
本页内容 8 个章节
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。
创建网关 #
-
打开 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。 | 设置参考 |
| 基本认证? | 访问此隧道需要用户名和密码。 | 访问控制 |
| 启用 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 类型。
“你需要购买余额才能使用此功能。”
自定义子域名和自定义域名需要有余额。请使用随机子域名,或充值余额。参见套餐与余额。