chatgpt-mcp-connectorlisted
Install: claude install-skill hawklithm/chatgpt-mcp-connector
# ChatGPT 自定义 MCP 连接器:从 0 到 1 接入本地 MCP 服务器
把本地自托管 MCP 服务器通过公网 HTTPS 隧道接入 ChatGPT 网页版,让 ChatGPT 直接读写本地代码、执行命令。
**上游核心依赖是 `Waishnav/devspace`**(npm 包 `@waishnav/devspace`,下文简称 DevSpace)——
**MCP 服务器本体由它提供**:工具实现、路径白名单、OAuth 授权、工作区与会话都在它那边。
> **本 skill 不含 DevSpace 的源码,也不修改它。** 它只是 DevSpace 外面的一层
> 「安装 → 配置 → 接入 ChatGPT」引导(1 个 skill + 2 个脚本 + 一组文档),
> 负责让 DevSpace **装得对、连得上、不踩坑**;想改 MCP 服务器本身的实现,请直接去看 `Waishnav/devspace`。
**实测环境**
- **Windows**:Windows 11 + Git Bash,DevSpace `1.0.8`,Tailscale `1.102.4`,winget `1.29.290`,Node `24.15.0`
- **macOS**:Intel Mac,DevSpace `1.0.8`
- **共同**:ChatGPT 新版中文 UI + Plus 账号
版本差异会影响命令语法(尤其 Tailscale),照做前先跑一遍 `--version`。
**平台支持**:Windows / macOS / Linux 三平台都支持,脚本无需改动。
差异集中在**依赖安装方式、shell 解析、Tailscale 服务模型、路径写法**四处 ——
见 `references/cross-platform.md`。
- ✅ **Windows**:实机跑通完整 0→1(Windows 11 + Git Bash)
- ✅ **macOS**:实机跑通完整 0→1(Intel Mac,含阶段 6 建连接器 + OAuth 授权)
- ⚠️ **Linux**:**未实机验证**,结论来自 DevSpace 源码阅读;实机结果与文档不符时**以实际输出为准**
**浏览器自动化依赖**:阶段 6(建连接器 + OAuth 授权)默认用 **`browser-harness`** 驱动浏览器完成
(本机实测 `0.1.8`,命令在 `~/.local/bin/browser-harness`)。
装不上、或连不上浏览器时阶段 6 **降级为人工作业** —— 把该填的值列清楚交给用户,
步骤见 `references/chatgpt-connector.md` 的「完整步骤(人工兜底路径)」。两条路径产出的结果完全一致。
## 何时使用
- **让 agent 自己把连接器配好、不要用户手动填表** —— 阶段 6 默认用 `browser-harness`
驱动浏览器完成(开发者模式 → 建连接器 → OAuth 授权)
- 「让 ChatGPT 网页版驱动本地 codex / 读我本地项目」「把本地 MCP 接到 ChatGPT」
- 报错 `MCP server ... does not implement OAuth` / `Something went wrong...`
- **`bash` / shell 工具持续异常**:`git status`、`cargo fmt`、`e