Skip to main content

​
什么是远程访问

Linkly AI 运行在你的本机上，而 ChatGPT、Claude.ai 等在线 AI 应用运行在云端，它们无法直接访问你本地的知识库 MCP 服务。 远程访问通过在你的桌面端和云端之间建立一条安全隧道，实现公网中转：
  1. 桌面端建立 WebSocket 隧道连接到 mcp.linkly.ai
  2. 在线 AI 应用通过 OAuth 授权后，将 MCP 请求发送到 https://mcp.linkly.ai/mcp
  3. 云端服务将请求通过隧道转发到你的桌面端，桌面端执行后返回结果
你的文档数据始终保存在本地，隧道仅转发 MCP 请求和响应，不存储任何文档内容。
**远程访问是 Pro 独占功能。**免费账户可以看到并点击「连接公网隧道」，但连接会被服务端拒绝，状态变成「需要升级」并提示「远程访问需要 Pro 订阅。」。如果你只是想让云端 AI 读到某一批资料，不必升级——云端知识库免费账户就能用，而且不需要你的电脑开机。两者的区别见下方该选哪一个。
mcp.linkly.ai 是一个云端 MCP 中转服务，由 Linkly AI 官方维护。数据在其中匿名发送，Linkly AI 仅记录使用次数用于展示。

​
该选哪一个

远程访问和云端知识库都能让云端的 AI 读到你的资料，但解决的是不同方向的问题： 两者可以同时用，互不冲突。
还有第三种情况经常被忽略：如果你的 AI 客户端就装在同一台电脑上（Claude Code、Cursor、Cherry Studio 等），根本不需要隧道——直接连本机的 http://127.0.0.1:60606/mcp 即可，免费且更快。见使用 MCP。

​
配置步骤

1

登录 Linkly AI 账号并升级到 Pro

在桌面端 设置 → 账户 点「登录」，浏览器完成授权后会自动回到应用。登录后 API Key 会自动获取，不需要你手工去控制台复制粘贴。远程访问需要 Pro 订阅，可在官网定价页升级。
如果你有特殊需求（比如想用某个指定的 Key），设置 → 账户 底部的「可选：通过手动设置 API Key 完成账户连接」仍然保留着手工粘贴的入口，Key 以 lkai_ 开头，在控制台生成。
2

在桌面端连接隧道

进入 设置 → MCP，找到「远程访问（公网）」区域，打开右侧开关展开：
  1. 如果还没登录，这里会提示「请先登录账户以启用远程访问。」，点「打开账户设置」先完成上一步
  2. 点击「连接公网隧道」按钮
  3. 等待状态显示为 ● 已连接，下方会出现「公网 MCP 端点」
3

在 AI 应用中添加 MCP 服务

在 ChatGPT、Claude.ai 等支持 MCP 的 AI 应用中，添加以下 MCP 端点：
首次添加时会触发 OAuth 授权流程，按照提示在浏览器中登录并授权即可。各应用的具体配置方式，请参阅集成总览。

​
连接状态一览

「远程访问（公网）」区域的状态标签有这几种取值，看懂它就能判断问题出在哪：

​
OAuth 授权说明

ChatGPT、Claude.ai 等在线 AI 应用在首次连接远程 MCP 服务时，会自动触发 OAuth 2.1 授权流程：
  1. AI 应用发现 MCP 端点需要授权
  2. 自动跳转到 linkly.ai 的登录页面
  3. 你登录并确认授权后，AI 应用获得访问令牌
  4. 后续请求自动携带令牌，无需重复授权
如果你已经在浏览器中登录了 linkly.ai，授权过程会更加快速。

​
安全注意事项

  • 凭证保管：隧道凭证等同于访问你本地知识库的钥匙，不要分享给他人。如果怀疑泄露，可在控制台撤销并重新生成 API Key
  • HTTPS 传输：远程隧道全程使用 HTTPS/WSS 加密传输
  • 随时可撤销：你可以在桌面端随时断开隧道。在控制台中撤销 API Key 可阻止新的连接和重连，但不会立即断开已建立的隧道会话
  • 数据不上云：你的文档数据始终保存在本地电脑上，隧道仅转发 MCP 工具调用的请求和响应

​
常见问题

这说明当前账号不是 Pro——隧道建连会被服务端直接拒绝（HTTP 402）。有两条路：
  • 升级到 Pro：点状态下方的「升级到 Pro →」，或直接去定价页
  • 改用云端知识库：把需要被远程访问的那批资料推送到云端。免费账户可用，而且电脑关机也能查
注意一个容易踩的坑：即使你用的是云端知识库，检索时也必须显式指定库（library="cloud://owner/slug"）。省略库参数时请求会默认路由回你的本机，也就是走隧道——免费账户在这条路径上会收到 Pro 提示。
按这个顺序排查：
  1. 确认 设置 → 账户 显示「已连接至 Linkly AI Cloud」。没登录的话，远程访问区域会直接提示「请先登录账户以启用远程访问。」
  2. 如果你是手工填的 API Key，检查是否完整粘贴（以 lkai_ 开头），以及是否已在控制台被撤销
  3. 在控制台重新生成一个新的 API Key，或者干脆退出登录再登录一次让它自动获取
远程 MCP 服务需要桌面端保持运行并连接隧道。如果桌面端关闭或隧道断开，远程调用会立即返回 503 错误。请确保：
  • Linkly AI Desktop 已启动
  • MCP 服务正在运行（设置 → MCP 顶部显示「运行中」）
  • 隧道状态为 ● 已连接
如果你希望「电脑关着也能查」，那需要的其实是云端知识库，不是隧道。
隧道具有自动重连机制（最多重试 10 次，采用指数退避策略），期间状态显示「重连中（第 N 次）」。如果频繁断开，请检查：
  • 网络连接是否稳定
  • 凭证是否仍然有效
如果持续断开，可尝试手动「断开公网隧道」后重新连接。
如果在 ChatGPT 或 Claude.ai 中添加 MCP 后授权失败：
  1. 确保桌面端隧道处于连接状态
  2. 尝试在浏览器中先登录 linkly.ai
  3. 重新在 AI 应用中添加 MCP 服务器
如果问题持续，请移除已添加的 MCP 服务器后重新添加。

​
延伸阅读