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

在桌面端开启远程访问

  1. 点击主窗口左侧栏底部的 Agent 图标，进入「Agent 使用」页
  2. 在「管理」区打开「允许远程访问（公网）」。「允许本机访问」也要保持开启，否则这个开关无法打开
  3. 等待状态显示为 ● 已连接。如果显示「未登录」、开关自动关上，说明还没登录，先完成上一步
  4. 公网地址在「集成」区的「查看 MCP 接入配置」里：弹窗的「远程（公网）」一节有地址和一段可直接复制的配置
3

在 AI 应用中添加 MCP 服务

在 ChatGPT、Claude.ai 等支持 MCP 的 AI 应用中，添加以下 MCP 端点：
首次添加时会触发 OAuth 授权流程，按照提示在浏览器中登录并授权即可。各应用的具体配置方式，请参阅集成总览。
改用 Linkly AI CLI 访问（比如在服务器或容器里）？在那台机器上运行 linkly auth login：它会打印一个可以在任意设备上打开的链接，你授权后即保存一个新的 API Key。之后在任意命令上加 --remote 即可。如果更想粘贴已有的 Key，可以在你自己的终端里运行 linkly auth set-key lkai_…，不要交给 AI 助理执行。详见使用 CLI → 远程模式。

​
连接状态一览

「允许远程访问（公网）」一行会显示隧道的连接状态，接入配置弹窗的「远程（公网）」一节显示的也是它。看懂这个状态，就能判断问题出在哪：

​
OAuth 授权说明

ChatGPT、Claude.ai 等在线 AI 应用在首次连接远程 MCP 服务时，会自动触发 OAuth 2.1 授权流程：
  1. AI 应用发现 MCP 端点需要授权
  2. 自动跳转到 linkly.ai 的登录页面。新账号第一次登录，会先进入「完善你的资料」页设置显示名称和用户名
  3. 授权页会写明「授权后将跳转到」哪个域名，确认是你正在使用的 AI 应用（如 claude.ai、chatgpt.com）再点同意
  4. AI 应用获得访问令牌，后续请求自动携带，无需重复授权
不再使用的应用，可以在控制台「集成」页的「已授权的应用」里撤销。撤销后该应用最多还能访问 1 小时，之后需要重新授权。
如果你已经在浏览器中登录了 linkly.ai，授权过程会更加快速。

​
安全注意事项

  • 凭证保管：隧道凭证等同于访问你本地知识库的钥匙，不要分享给他人，也不要粘贴进任何 AI 对话（ChatGPT、Claude、Cursor、Codex、豆包、Kimi 等）——对话内容会发送给模型服务商、写进会话记录。让 AI 应用连接时用 OAuth 授权，让 AI 助理使用 CLI 时用 linkly auth login，都不需要你复制 Key。Key 已经出现在对话里或怀疑泄露，可在控制台撤销并重新生成 API Key
  • HTTPS 传输：远程隧道全程使用 HTTPS/WSS 加密传输
  • 随时可撤销：你可以在桌面端随时断开隧道。在控制台中撤销 API Key 可阻止新的连接和重连，但不会立即断开已建立的隧道会话；经 OAuth 连接的 AI 应用，在「集成」页的「已授权的应用」里撤销
  • 敏感信息自动隐藏：经远程 MCP 返回的内容，会先把 API Key、密码、私钥、银行卡号、身份证号等 200 多种敏感信息替换成 [REDACTED:类型] 标记，再交给 AI 应用。笔记暂不隐藏，以免 AI 编辑笔记时把原文覆盖掉。这能降低泄露风险，但不是万无一失：更重要的资料，建议用排除规则挡在索引之外。本机和局域网连接不经过云端，不做替换
  • 数据不上云：你的文档数据始终保存在本地电脑上，隧道仅转发 MCP 工具调用的请求和响应

​
常见问题

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

​
延伸阅读