StudioCat
简体中文
获取 StudioCat

文档

开始使用 StudioCat

StudioCat 把 ChatGPT 网页版连接到你 Mac 上的项目。ChatGPT 决定做什么；StudioCat 在本机执行，按你设定的权限检查每一次调用，并在工作台里显示每一处改动。

系统要求

安装

下载签名并经过公证的 DMG，打开后把 StudioCat 拖到“应用程序”文件夹。StudioCat 会自动更新，安装更新前会先征求你的同意。内测期间，请在首页申请资格。

首次启动时，设置助理会带你完成接下来的三步。之后随时可以从顶栏的隧道状态或 StudioCat → 设置助理… 重新打开它。

1 · 创建隧道

  1. 打开 Platform → Tunnels，创建一条隧道，复制它的 Tunnel ID（tunnel_…）。
  2. 打开 Platform → API keys，创建一个 Key：选择 Restricted，只开启 Tunnels: Read 和 Use。
  3. 如果你的账号属于多个组织（例如个人组织和工作组织），记下隧道所在组织的 ID（org-…，位于 Settings → Organization）。

2 · 连接 StudioCat

把 Tunnel ID、API Key（以及需要时的组织 ID）粘贴到设置助理（或 设置 → 通用 → 隧道凭据），然后选择保存并连接。凭据会存进 macOS 钥匙串。StudioCat 连接成功后，顶栏的隧道状态会变成绿色。你的 Mac 只发起出站 HTTPS 连接——StudioCat 从不开放端口。

3 · 在 ChatGPT 添加 MCP Server

  1. 在电脑浏览器中打开 chatgpt.com/plugins。如果看不到添加入口，先在 ChatGPT 的高级设置中开启开发者模式。
  2. 添加一个名为 StudioCat 的 MCP Server。Connection 选择 Tunnel，然后选中你的隧道（或粘贴 Tunnel ID）。
  3. 保存、刷新，然后新开一个启用了 StudioCat 的会话。试试：“用 StudioCat 列出我项目根目录下的文件。”

以后如果换了隧道，记得把 ChatGPT 里的 MCP Server 也改到新隧道——否则调用会报告隧道客户端未连接。

项目与权限

StudioCat 只在你通过 文件 → 打开项目…（⌘O）打开的项目里工作。打开项目时，由你决定它可以做什么：

有两道确认是有意设计的：ChatGPT 可能会问你是否发出这次调用，StudioCat 可能会在执行有风险的调用前再问一次。两者互不替代。

审查与回滚

检查点不是备份。在终端里用 rm -rf 删除、且被 git 忽略的文件（比如 build/）无法恢复。

同时处理多个项目

每个 ChatGPT 会话都绑定在它第一次工作的项目上。你可以切换工作台显示的项目；会话会在后台继续在自己的项目里工作。在会话中（用明确的路径）打开另一个项目，会把这个会话移过去。

故障排查

“API Key 无效”
重新完整复制 Key，或者新建一个。被撤销的 Key 会立即失效。
“这个 Key 没有使用该隧道的权限”（tunnel_use_forbidden）
给这个 Key 开启 Tunnels 的 Read 和 Use 权限。新权限可能需要几分钟才生效。
“需要填写组织 ID”（tunnel_active_organization_required）
你的 Key 属于多个组织。在设置中填写隧道所在组织的 ID，然后重新连接。
ChatGPT 提示隧道客户端未连接
确认顶栏显示隧道已连接，并且 ChatGPT 里的 MCP Server 使用的是与 StudioCat 相同的隧道。
网页版能用，手机上不行
这是预期行为：ChatGPT 手机 App 暂时还不能调用自定义 MCP Server。
连不上 OpenAI
检查网络。如果你通过代理上网，确认系统代理已开启；StudioCat 会使用它，并自动重试。

数据与卸载