让编程 agent 分享私有预览

将 Claude Code、Codex、Cursor、Gemini CLI 或 OpenCode 连接到 TSLink，让 agent 为刚启动的开发服务器返回手机或同事可访问的私有 HTTPS 地址。

Agent 启动应用，你在手机上私有访问。连接一次 TSLink，之后让 agent 分享它刚启动的端口，就能通过 Tailscale 返回手机或已获授权同事可用的私有 HTTPS 地址。

先在运行 agent 和开发服务器的机器上安装 TSLink。下面的配置将已安装的 tslink 二进制注册为本地 MCP server，参数为 mcp；它们不安装二进制，也不启动应用。若 agent 的 PATH 找不到 tslink，使用二进制的绝对路径。在客户端批准连接；工具未出现时，重新开始会话。

选择 Claude Code、Codex CLI、Cursor、Gemini CLI 或 OpenCode。

Claude Code

在终端运行：

bash

claude mcp add --transport stdio --scope user tslink -- tslink mcp

这会在 ~/.claude.json 中添加用户级配置。在 Claude Code 中运行 /mcp 检查连接。见官方 MCP 配置。

插件安装

在 Claude Code 内分别输入以下两条命令：

代码

/plugin marketplace add anydoor7/tslink

代码

/plugin install tslink@tslink

在插件面板选择 Install for you（用户级），启用状态会记录在 ~/.claude/settings.json，插件下载到 ~/.claude/plugins。安装后重新加载插件或重启 Claude Code。插件提供预览 skill 和 MCP 连接。两种方式选一种，避免重复连接 TSLink。见官方插件指南。

如需可选的工作流指引，将 anydoor7/tslink 中的 skills/tslink-preview 目录复制到项目的 .agents/skills/tslink-preview，或用户目录的 ~/.agents/skills/tslink-preview。入口文件为 SKILL.md。Codex 从当前工作目录向上扫描至仓库根目录的 .agents/skills，也读取用户级 skills。Skill 提供指引，仍需保留上面的 MCP 连接。见官方 skill 加载位置。

Cursor

将此配置合并到项目的 .cursor/mcp.json，或所有项目共用的 ~/.cursor/mcp.json，保留文件内已有 server：

json

{
  "mcpServers": {
    "tslink": {
      "command": "tslink",
      "args": ["mcp"]
    }
  }
}

在 Cursor 的 MCP 设置中启用 TSLink。Cursor CLI 读取相同文件，也可在终端批准已有配置：

bash

agent mcp enable tslink

CLI 的旧名称为 cursor-agent。见 Cursor 官方 MCP 配置与 CLI MCP 命令。JSON 配置注册 server，enable 命令批准已存在的配置。

Gemini CLI

先登录 Gemini CLI，再在终端运行：

bash

gemini mcp add --transport stdio --scope user tslink tslink mcp

这会在 ~/.gemini/settings.json 中添加用户级配置。在 Gemini 内用 /mcp 查看工具。见 Gemini 官方 MCP 配置。

OpenCode

将此配置合并到项目的 opencode.json，保留其他设置：

json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tslink": {
      "type": "local",
      "command": ["tslink", "mcp"],
      "enabled": true
    }
  }
}

用户级配置使用 ~/.config/opencode/opencode.json。重新开始会话加载 server。见官方本地 MCP 配置与配置位置。本机 CLI 的 opencode mcp add 是交互式操作，因此这里提供可复制的配置。

让 agent 分享私有预览

Agent 启动开发服务器后，发送：

代码

用 TSLink 将刚启动的开发服务器分享为私有预览，使用它的实际端口。
将访问限制为我的 Tailscale 登录名；不清楚时先问我。
需要入网时，将授权 URL 交给我，等我完成后再获取返回名称的准确应用 URL。
保持私有；我让你结束预览时，删除这次分享。

使用 MCP 时，agent 调用 share 并传入实际 target 和 allow: ["<你的 Tailscale 登录名>"]，再用返回名称调用 url。CLI 访问限制使用人员分享中的 add --allow 流程；tslink share 3000 分享 3000 端口，不额外限制个人身份。

首次运行会发生什么

首次使用需要人打开返回的 Tailscale 入网 URL，在浏览器完成登录及可能的设备审批。needs_login 与 auth_url 表示等待入网，不是应用地址。之后 agent 可用 tslink url <returned-name> --wait 取得准确地址。默认私有流程不需要存储 API token。

首次分享也可能安装 TSLink 的持久 OS 后台服务。如果 TSLink 已在运行，可以用 CLI --no-daemon-install 或 MCP no_daemon_install: true 跳过安装；如果不接受安装且 TSLink 没有运行，分享无法开始。安装后，MCP 结果会包含 daemon_installed，其中有 manager、path 和 undo；CLI 会打印一行以 Undo with: tslink uninstall 结尾的提示。tslink uninstall 会为所有 TSLink 应用移除该服务，执行前先确认其他应用不依赖它。使用 tslink remove <returned-name> 删除预览不会卸载该服务。

谁能打开

手机需要连接 Tailscale，并具有访问应用节点的权限。默认情况下，tailnet 策略允许的每个 tailnet 成员都能访问分享。只在自己手机上预览时，将访问限制为自己的 Tailscale 登录名。访问限制、按人授权与期限设置见人员分享。

同事也需要 Tailscale 与授权；tailnet 外的同事还需接受相应设备共享。仅有 URL 不会授予权限。手机访问指南涵盖入网、登录、热更新与清理；首次手动分享见快速开始。

本地 stdio MCP 默认使用 owner 权限。委派管理前阅读 MCP 角色，工具与协议详见 MCP server 参考。Agent 的私有本地服务解释 CLI JSON 与 MCP 的选择。

客户端文档核对日期为 2026-10-18（America/Los_Angeles）。