外部智能体

并非由 T3 Code 启动的智能体，可以通过环境（environment）的 MCP 服务器与该环境协作。它们可以读取项目和对话线程（thread）、启动对话线程并向其发送消息，以及查看哪些提供方（provider）和模型可用。这包括你自己终端里的 Claude Code 或 Codex、ChatGPT，以及支持 MCP 的机器人。每个智能体登录一次，由你决定它可以做什么。

把 T3 Code 添加到助手应用

打开命令面板（Cmd/Ctrl+K），选择在另一个应用中使用 T3 Code（MCP），或使用设置 → 共享与访问中的按钮。选中应用，并按该应用对应的步骤操作。Poke 和 Claude 这类助手在云端运行，因此向导会先要求你登录 T3 Connect，并为该环境（environment）开启它。要通过同一连接访问你的其他机器，请在实验室中打开关联环境，并关联它们。

应用打开登录页后，选择它可以做什么，并用你的 T3 Connect 账户批准。在较旧的环境上，向导会询问级别，并改为给你一段需要粘贴的代码。代码只能使用一次，有效期为 5 分钟，并且只批准该级别。

如果应用不在列表中，选择其他…，在该应用中添加一个使用 OAuth 的远程 MCP 服务器，并粘贴 URL。要求使用自己的客户端 ID 的应用无法连接。

获取 MCP URL

在设置 → 环境中，打开某个已保存环境（environment）的菜单，选择复制 MCP URL。该 URL 是环境地址后面接上 /mcp，例如：

text

https://<environment-address>/mcp

当 T3 Connect 为该环境提供服务时，复制得到的 URL 是它的 T3 Connect 地址，智能体从任何地方都能访问。否则，它使用这台设备当前连接所走的路由，因此同一台设备上的智能体可以访问它。

你自己电脑上的智能体可以使用主机上的 localhost、T3 Connect，或任何 https 地址，例如 Tailscale HTTPS。登录会把智能体的凭据发送到环境，而智能体只会通过 https，或向 localhost 这样做。未加密的 http 局域网地址或 Tailscale 地址，例如 http://100.x.y.z:3773，可以让智能体找到环境，但无法完成登录。
托管智能体，例如 ChatGPT 或在云端运行的机器人，必须能够从互联网访问该环境。请使用 T3 Connect 地址。Tailscale 地址只在你自己的 tailnet 中有效。

智能体第一次连接时会打开登录页。当智能体通过 T3 Connect 到达环境（environment）时，页面在 T3 Code Web 应用中打开：使用该环境所关联的 T3 Connect 账户登录，并在那里批准，不需要代码。否则，页面在环境上打开。两种页面都会写明智能体是谁，以及它的访问权限去向何处：

对于你电脑上的智能体，批准会返回到打开该页面的电脑上的 localhost 地址。
对于托管智能体，批准会发往该服务，例如 chatgpt.com。运行该服务的任何人都将获得这次访问权限。

只批准你刚刚发起的登录。在环境自己的页面上，输入来自在另一个应用中使用 T3 Code（MCP）、设置 → 共享与访问，或主机上 t3 auth pairing create 的代码。已经登录该环境、并且有权管理访问的浏览器，可以不使用代码直接批准。在 Web 应用中，改用登录码会打开环境自己的页面。

来自在另一个应用中使用 T3 Code（MCP）的代码，已经带有你在那里选择的级别。如果是其他代码，就在这里选择智能体可以做什么：默认选中自动，或者你所在组织的策略所允许的、最接近的更低模式。不使用代码进行批准时，从只读开始：

只读允许智能体读取项目和对话线程（thread），并查看可用的提供方（provider）和模型。它不能更改任何内容。
从监督到完全访问还允许它在每个项目中启动、发送消息和停止对话线程。它启动或引导的对话线程，运行时的权限不能高于你选择的模式。

外部智能体能调用什么

有些工具只对在 T3 对话线程（thread）内部运行的智能体有效，因为它们以该对话线程的身份行事：子智能体、密钥请求、渲染后的 HTML、浏览器预览、设备，以及工作树（worktree）交接。它们仍会出现在外部智能体的工具列表中，但调用其中一个会返回错误，说明需要一个在 T3 Code 内部运行的智能体。

要交接工作，请用 t3_thread_launch 启动一个对话线程，再用 t3_thread_wait 或 t3_thread_read 跟进，而不要使用 create_threads 或 delegate_task。
默认使用调用方自己的项目或对话线程的工具，需要显式的 projectId 或 threadId。
要跨项目列出对话线程，请调用 t3_thread_list 并带上 allProjects: true，或使用 t3_thread_search。

Claude Code

claude mcp add --transport http t3 https://<environment-address>/mcp
claude mcp login t3

claude mcp login 会在浏览器中打开登录页。在没有浏览器的机器上，加上 --no-browser，到别处打开打印出的 URL，并在被询问时把最终 URL 粘贴回去。你批准之后，claude mcp list 会把 t3 显示为已连接。

Codex

codex mcp add t3 --url https://<environment-address>/mcp
codex mcp login t3

codex mcp login --no-browser 会打印登录 URL，而不是打开它。你批准之后，codex mcp list 会显示带有 OAuth 的 t3。

ChatGPT

在 ChatGPT 的应用设置中，把该环境添加为自定义 MCP 应用：

新建一个带有自定义 MCP 服务器的应用或插件。
把服务器 URL 设为 https://<environment-address>/mcp，使用 T3 Connect 地址。
身份验证选择 OAuth。其余部分由 ChatGPT 发现；你不需要客户端 ID 或密钥。
创建该应用，然后批准打开的登录页。

其他智能体和机器人

任何支持通过 HTTP 与 OAuth 连接远程 MCP 服务器的智能体都可以连接。把 MCP URL 交给它并选择 OAuth，智能体就会自己找到登录设置。不支持 OAuth 的智能体无法连接。

主机上的脚本

在运行该环境（environment）的机器上，t3 thread 使用同样的工具，无需登录：

id=$(t3 thread start . "Find why the tests are slow")
t3 thread send "$id" "Now fix it" --wait
t3 thread show "$id"
t3 thread list

. 表示包含当前文件夹的项目；项目 id 也可以。新的对话线程（thread）使用项目的默认模型和权限模式，并在项目文件夹中运行，除非你传入 --worktree <base-branch>。send 从不中途打断：忙碌的对话线程会把这条消息作为下一个回合（turn）。把 - 作为消息传入，即可从标准输入读取它。

--wait 会打印智能体的回复。运行失败或停止时，它以状态码 1 退出；智能体正在等待你在应用中给出的回答时，以状态码 2 退出。加上 --json，得到的结果会始终包含对话线程 id。

移除智能体

已批准的智能体出现在设置 → 共享与访问下面，与其他客户端（client）一样。在那里撤销其中一个，即可立即切断它的访问。一次登录持续 30 天；到期之后，智能体会再次请你批准。

外部智能体 ​

把 T3 Code 添加到助手应用 ​

获取 MCP URL ​

批准一次登录 ​

外部智能体能调用什么 ​

Claude Code ​

Codex ​

ChatGPT ​

其他智能体和机器人 ​

主机上的脚本 ​

移除智能体 ​