---
title: "让编程 agent 分享私有预览"
description: "将 Claude Code、Codex、Cursor、Gemini CLI 或 OpenCode 连接到 TSLink，让 agent 为刚启动的开发服务器返回手机或同事可访问的私有 HTTPS 地址。"
url: "https://tslink.md/zh/docs/agent-integrations"
locale: "zh"
product_version: "0.2.0"
source: "https://github.com/anydoor7/tslink/blob/v0.2.0/docs/agents.md"
---

> Documentation index: https://tslink.md/zh/llms.txt · Installed binary is authoritative: `tslink manifest`.

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

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

选择 [Claude Code](https://tslink.md/zh/docs/agent-integrations.md#claude-code)、[Codex CLI](https://tslink.md/zh/docs/agent-integrations.md#codex-cli)、[Cursor](https://tslink.md/zh/docs/agent-integrations.md#cursor)、[Gemini CLI](https://tslink.md/zh/docs/agent-integrations.md#gemini-cli) 或 [OpenCode](https://tslink.md/zh/docs/agent-integrations.md#opencode)。

## Claude Code

在终端运行：

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

这会在 `~/.claude.json` 中添加用户级配置。在 Claude Code 中运行 `/mcp` 检查连接。见[官方 MCP 配置](https://code.claude.com/docs/en/mcp)。

### 插件安装

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

```text
/plugin marketplace add anydoor7/tslink
```

```text
/plugin install tslink@tslink
```

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

## Codex CLI

在终端运行：

```bash
codex mcp add tslink -- tslink mcp
```

这会写入 `~/.codex/config.toml`；若设置了 `CODEX_HOME`，则写入该目录的 `config.toml`。在 Codex 内运行 `/mcp` 检查连接。等效 TOML 配置为：

```toml
[mcp_servers.tslink]
command = "tslink"
args = ["mcp"]
```

见 [Codex 官方 MCP 配置](https://learn.chatgpt.com/docs/extend/mcp?surface=cli#configure-with-the-cli)。

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

## 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 配置](https://cursor.com/docs/mcp)与 [CLI MCP 命令](https://cursor.com/docs/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 配置](https://geminicli.com/docs/tools/mcp-server/)。

## 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 配置](https://opencode.ai/docs/mcp-servers/)与[配置位置](https://opencode.ai/docs/config/)。本机 CLI 的 `opencode mcp add` 是交互式操作，因此这里提供可复制的配置。

## 让 agent 分享私有预览

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

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

使用 MCP 时，agent 调用 `share` 并传入实际 target 和 `allow: ["<你的 Tailscale 登录名>"]`，再用返回名称调用 `url`。CLI 访问限制使用[人员分享](https://tslink.md/zh/docs/people-sharing.md)中的 `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 登录名。访问限制、按人授权与期限设置见[人员分享](https://tslink.md/zh/docs/people-sharing.md)。

同事也需要 Tailscale 与授权；tailnet 外的同事还需接受相应设备共享。仅有 URL 不会授予权限。[手机访问指南](https://tslink.md/zh/docs/agent-ui-phone.md)涵盖入网、登录、热更新与清理；首次手动分享见[快速开始](https://tslink.md/zh/docs/quickstart.md)。

本地 stdio MCP 默认使用 owner 权限。委派管理前阅读 [MCP 角色](https://tslink.md/zh/docs/mcp-scopes.md)，工具与协议详见 [MCP server 参考](https://tslink.md/zh/docs/mcp-server.md)。[Agent 的私有本地服务](https://tslink.md/blog/ai-local-services)解释 CLI JSON 与 MCP 的选择。

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