WebCodex MCP 接入指南ChatGPT 与 Claude 双客户端认证配置全解析【免费下载链接】webcodexGive cloud AI agents a real development environment on your own machines.项目地址: https://gitcode.com/gh_mirrors/web/webcodexWebCodex是一个开源项目它通过MCPModel Context Protocolendpoint让ChatGPT、Claude等 AI 客户端直接使用你本机上的真实开发环境项目文件、Git、编译器和测试工具。本指南面向新手完整解析两条最常用的接入路径与三种认证方式帮助你用最少的配置把云 AI Agent 接到自己的电脑上 一句话心智模型AI 客户端ChatGPT / Claude→ MCP → WebCodex Server → Runner → 你的项目。Tunnel 只负责网络可达不改变权限边界。一、先搞清楚WebCodex 的三条接入路径场景推荐入口认证方式特点Windows / macOS 日常使用Desktop OpenAI Secure TunnelTunnel No Auth最简单推荐首选 ✅临时试用一个仓库webcodex shareAccess token / API keyBearer一条命令关闭即失效长期 CLI / Linux / 已有 Server普通 Server RunnerBearer / Shared key / OAuth完整能力可多项目三者共用同一套 model-facing MCP runtimeAdaptive Runtime区别只在凭据生命周期与网络入口。更多细节见 MCP 官方文档。二、ChatGPT 接入推荐路径Desktop OpenAI Secure Tunnel这是官方文档 Desktop 安装指南 中为普通 Windows / macOS 用户最推荐的路径WebCodex Desktop 在本机运行 Server 和 RunnerChatGPT 网页版通过官方OpenAI Secure Tunnel连接全程不需要配置公开地址、反向代理或 OAuth。步骤 1创建 Tunnel 凭据在 OpenAI 平台的Tunnels页面创建 Tunnel记下完整的 Tunnel ID在API keys页面创建密钥。建议使用Restricted key只授予Tunnels: Read Use权限遵循最小权限原则 步骤 2在 Desktop 保存凭据并启动隧道进入 WebCodex Desktop 的连接 → Tunnel 连接配置填入 Tunnel ID 与 API key 后点击保存配置再在OpenAI Secure Tunnel页点击启动安全隧道。看到已就绪等待 ChatGPT 连接即可继续API key 以未加密形式保存在本机用户目录请勿分享该文件。步骤 3在 ChatGPT 开启开发者模式并添加插件打开 ChatGPT 账户安全设置开启开发人员模式Developer Mode打开插件页面创建新插件连接方式选择隧道 / Tunnel选择为 WebCodex 配置的 Tunnel身份验证选择无身份验证No Auth——因为 WebCodex 的本地 Bearer 由原生 Rust Tunnel client 在本机内存中注入ChatGPT 侧永远不需要、也不应该拿到这份凭据。确认自定义 MCP 风险提示后点击Create再在确认页点击Connect步骤 4验证工具与链路插件页会列出 WebCodex 暴露的 MCP 工具如apply_text_edits写入操作等点击Scan Tools成功加载工具即表示握手完成最后做一次真实项目读取验收例如列出项目并列出顶层文件。注意本地状态全绿或tunnel_ready: true都不等于 ChatGPT 链路打通只有真实读取成功才是最终证据。成功后 Desktop 的连接页会显示已连接⚠️ 若 ChatGPT 返回FORBIDDEN: This conversation does not support developer MCPs这是 ChatGPT Host 侧的会话级准入限制不代表 WebCodex 配置错误请在允许 Developer MCP 的会话中重试。详见 故障排查。三、ChatGPT 快速试用webcodex share 一步接入只想几分钟体验一个仓库不需要提前运行setup/doctor/runcd /path/to/your/repository npx --yes yyjeqhc/webcodex share看到WebCodex ready后CLI 会打印MCP URL和临时Credential。在 ChatGPT 插件设置中选择服务器 URL方式粘贴 MCP URL认证选择Access token / API keyBearer 令牌填入 Credential点击Scan Tools。关闭终端即连接失效凭据随之作废——这就是临时试用与完整使用的核心区别完整流程见 快速试用指南。四、Claude 接入同一份 MCP 地址换个认证姿势Claude以及其他标准 MCP client与 ChatGPT 共用同一个/mcpURL 和认证值区别只在客户端 UI 的填法Bearer默认推荐在 Claude 的Custom Connector中粘贴 MCP URL 与认证值其余与常规 MCP Server 配置一致。Query token客户端不支持 Bearer 时改用webcodex share --auth query-token把输出的完整/mcp?token...URL 粘贴进 Claude认证选择No authentication。注意整条 URL 都是密钥不要写进日志或聊天记录。Claude 专属提示Claude Custom Connector 存在不向模型暴露structuredContent的情况。为这类客户端服务的 operator 可设置环境变量WEBCODEX_MCP_TEXT_JSON_COMPATtrue让结构化结果同时序列化到文本字段保证工具结果可读。另外share只允许本地 client 使用--tunnel none无需 cloudflaredHosted ChatGPT 无法访问 loopback 地址这也是两者认证入口不同的根本原因。五、认证方式速查表新手版认证方式适用客户端凭据来源安全要点OpenAI Secure Tunnel No AuthChatGPT 网页版Tunnel client 本机注入 BearerChatGPT 不接触 WebCodex 凭据 ✅Access token / API keyBearerChatGPT、Claude、标准 MCP clientshare/login --print-mcp-config输出凭据等同密钥勿粘贴到 issue/截图Query token无 Bearer 输入框的客户端share --auth query-tokenURL 整体视为 secretShared key团队/长期 hosted Serverwebcodex connect ... --key-file适合运维长期接入OAuth2authorization-code强制 OAuth 的客户端share --auth oauth/connect --auth oauth需注册精确 callback URL完整凭据分类wc_pat_*、wc_agent_*、Shared key、Project Credential 等请看 认证与凭据模型。六、常见错误与排查现象处理project_not_configured运行webcodex setupserver_unreachable/agent_offline运行webcodex run/webcodex doctorFORBIDDEN: ... developer MCPsChatGPT Host 侧限制换允许 Developer MCP 的会话重试找不到 Bearer 选项改用--auth query-token路径Tunnel 就绪但 ChatGPT 列不出项目核对 Tunnel ID、确认 No Auth、做真实读取验收命令参考见 CLI 文档Windows 独立 Server OpenAI Tunnel 的深入排障含验收清单见 Windows OpenAI Secure MCP Tunnel 实操指南。七、下一步从能连上到真干活接入成功后先用一个只读 prompt 热身检查这个仓库并总结它的结构。先不要做任何修改。 验证无误后再让 Agent 做可审查的小修改并运行测试。典型 coding 工作流为work_on_project→ 读取/搜索 → 编辑 →project_validate→present_work_result→finish_coding_task完整行为说明见 Coding 工作流 与 完整使用指南。 安全提醒只注册你确实要交给 AI 的目录不要把 API key、token 写进提示词、截图、Git 或共享日志。WebCodex 的 scope 不会扩大 ChatGPT / Claude 客户端自身未授予的权限。【免费下载链接】webcodexGive cloud AI agents a real development environment on your own machines.项目地址: https://gitcode.com/gh_mirrors/web/webcodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考