如何在 CloudCLI UI 的 MCP 设置里为 Claude、Codex、Cursor、OpenCode 配置 MCP 服务器并同步到本地配置？-北京尧图网络

如何在 CloudCLI UI 的 MCP 设置里为 Claude、Codex、Cursor、OpenCode 配置 MCP 服务器并同步到本地配置【免费下载链接】claudecodeuiUse Claude Code, OpenCode, Cursor CLI, and Codex on mobile and web with CloudCLI (aka Claude Code UI). CloudCLI is a free open source webui/GUI that helps you manage your Claude Code session and projects remotely.项目地址: https://gitcode.com/GitHub_Trending/cl/claudecodeuiCloudCLI又名 Claude Code UI的自托管 Web UI 可以集中管理四个 Agent 的 Model Context Protocol 服务器Claude、Codex、Cursor 和 OpenCode。在 UI 里保存一个 MCP 服务器后配置会直接写进该 Agent 原生的本地配置文件例如 Claude 的.mcp.json、Codex 的.codex/config.toml不需要再手工编辑文件改完立即对原生 CLI 生效。本文说明如何在 UI 的 MCP 设置里为单个 Provider 或全部 Provider 添加 MCP 服务器以及如何核对它确实同步到了本地配置。前提条件已能访问 CloudCLI UI。自托管的启动方式见 docs/README.md例如npx cloudcli-ai/cloudcli目标 Provider 的 CLI 已在同一台机器上可用UI 读写的是本地原生配置例如 Claude 使用~/.claude下的配置需要按 project scope 配置时先在 UI 里能看到对应的项目project 作用域需要选择一个工作区路径。各 Provider 的作用域与传输方式支持范围配置前先确认两个约束作用域scope和传输方式transport。不同 Provider 支持的范围不一样来源是 provider 模块说明和前端能力常量 src/shared/constants.tsProvider本地配置文件支持的作用域支持的传输方式Claude用户/本地/项目位置的.mcp.jsonuser、local、projectstdio、http、sseCodex.codex/config.tomluser、projectstdio、httpCursor.cursor/mcp.jsonuser、projectstdio、httpOpenCode用户级~/.config/opencode/opencode.json项目级workspace/opencode.json存在.jsonc时优先读取.jsoncuser、projectstdio、http由此可以推出几个实际限制sse传输只有 Claude 支持local作用域只有 Claude 支持stdio 服务器的工作目录cwd字段只有 Codex 支持其余 Provider 的表单里不会出现这一项。在 UI 里为单个 Provider 添加 MCP 服务器打开 CloudCLI UI 的设置页面进入对应 ProviderClaude / Codex / Cursor / OpenCode下的 MCP Servers 区块界面实现见 src/modules/mcp/McpServers.tsx。右上角的添加按钮提供两个入口Add to All Providers全局添加一次性把同一个 HTTP/stdio 服务器写入所有 ProviderAdd to Provider Name仅当前 Provider只写入当前选中的 Provider。选择「仅当前 Provider」后弹出表单src/modules/mcp/McpServerFormModal.tsx有两种录入模式模式一表单模式form按顺序填写作用域user对所有项目生效或project只对选定的工作区生效。选project时必须在下拉框里选择项目表单会显示解析后的工作区路径。编辑已有服务器时作用域不可更改需要换作用域就删除后重新添加。服务器名称必填写入配置文件后作为条目名。传输方式按当前 Provider 支持范围选择。按传输方式补全字段stdiocommand必填例如npx my-org/mcp-server和args多行文本每行一个参数http/sseurl必填所有模式都可以填envKEYvalue每行一个用于 stdio 进程的环境变量http/sse额外支持headers每行KeyValue例如AuthorizationBearer token。Codex 专属字段stdio 模式下可以填envVars只写变量名每行一个如GITHUB_TOKENhttp 模式下可以填bearerTokenEnvVar存放 bearer token 的环境变量名。提交。保存成功后列表上方会短暂显示保存成功提示服务器卡片上出现名称、transport 和 scope 徽标列表里已有条目则本次是更新upsert同名服务器会被覆盖。模式二JSON 模式json新增时可以切换到 json 标签直接粘贴一段 JSON 配置粘贴内容必须是合法 JSON否则输入框会显示校验错误。文档中给出的示例格式见表单内的提示文案{ type: stdio, command: npx, args: [upstash/context7-mcp] }{ type: http, url: https://api.example.com/mcp }第二个api.example.com是文档中的占位示例地址请替换为你实际的 MCP 端点。可选分支一次添加到所有 Provider如果同一个stdio或http服务器需要在 Claude、Codex、Cursor、OpenCode 上都生效使用添加菜单里的「Add to All Providers」。该模式的限制传输方式只支持stdio和http不支持sse作用域只支持user和project不支持local每个 Provider 独立写入结果是逐 Provider 的成功的条目标记为created: true失败的条目返回created: false和对应的error信息不会整体回滚。用 REST API 做同样的事并核对结果UI 背后调用的是 Provider 路由里的一组 MCP 接口server/modules/providers/provider.routes.ts。用 curl 调用时把host:port替换为你访问 CloudCLI UI 的主机和端口project-path替换为 project 作用域对应的工作区绝对路径user 作用域不需要workspacePath列出某 Provider 的所有 MCP 服务器按作用域分组curl http://host:port/api/providers/claude/mcp/servers只看某一个作用域curl http://host:port/api/providers/codex/mcp/servers?scopeuser curl http://host:port/api/providers/cursor/mcp/servers?scopeprojectworkspacePathproject-path添加/更新一个 stdio 服务器示例参数来自仓库测试中的用例args内容请按实际 MCP 服务器替换curl -X POST http://host:port/api/providers/claude/mcp/servers \ -H Content-Type: application/json \ -d { name: my-server, scope: user, transport: stdio, command: npx, args: [upstash/context7-mcp], env: { API_KEY: secret } }请求成功后返回201和写入后的服务器对象同名请求即更新。从全部 Provider 中删除时先按单个 Provider 删除curl -X DELETE http://host:port/api/providers/claude/mcp/servers/my-server?scopeuser全局添加等价于 UI 的 Add to All Providersbody 与单个添加相同scope省略时按project处理local会被拒绝并返回INVALID_GLOBAL_MCP_SCOPEcurl -X POST http://host:port/api/providers/mcp/servers/global \ -H Content-Type: application/json \ -d { name: my-server, scope: user, transport: stdio, command: npx, args: [upstash/context7-mcp] }返回体里是逐 Provider 的结果数组每一项包含provider、created失败时带error用它判断哪些 Provider 写入成功。验证配置确实同步到了本地文件判断写入是否落盘按作用域检查对应 Provider 的原生配置文件Claudeuser 作用域写在~/.claude下的配置里project 作用域写入workspace/.mcp.json。仓库测试 server/modules/providers/tests/mcp.test.ts 的做法可以作为核对依据用 upsert 更新workspace/.mcp.json中mcpServers.name条目后直接读取该文件确认目标字段如url已经变成新值。Codex检查.codex/config.toml中是否出现/更新了同名服务器条目user 或 project 作用域。Cursor检查.cursor/mcp.json。OpenCodeuser 作用域检查~/.config/opencode/opencode.jsonproject 作用域检查workspace/opencode.json。除了直接看文件也可以用 UI 的列表页或上面的 GET 接口复查新服务器出现在对应作用域分组下transport 和 scope 徽标与填写一致即说明读写链路一致。docs/README.md 的 FAQ 明确了同步语义自托管模式下CloudCLI UI 与 Claude Code 读写同一份~/.claude配置「MCP servers you add via the UI show up in Claude Code immediately and vice versa」——UI 里添加的服务器会立刻出现在 Claude Code 中反向修改也立即生效。因此验证时不必等待同步周期保存成功即代表原生 CLI 已可用。边界与已知限制列表中名称以cloudcli-开头的服务器带有 Managed 徽标只读。它们由 CloudCLI 的功能开关例如 Browser 标签页自动写入不要手工编辑或删除否则会和对应功能失配。全局添加不支持sse和local这是硬限制不是 UI 隐藏选项确有需要时改用逐 Provider 添加。编辑模式锁定作用域改 transport、command、url、env 都可以但不能把user级服务器改成project级反之亦然。不同 Provider 的配置文件格式互不相同JSON、JSONC、TOMLUI 按各自格式序列化不要把某个 Provider 的配置块直接复制成另一个 Provider 的文件内容。各 Provider 的完整实现约束作用域、传输方式、必填方法以 provider 模块说明为准其中还列出了mcp能力面对应的readScopedServers/writeScopedServers等接口定义。【免费下载链接】claudecodeuiUse Claude Code, OpenCode, Cursor CLI, and Codex on mobile and web with CloudCLI (aka Claude Code UI). CloudCLI is a free open source webui/GUI that helps you manage your Claude Code session and projects remotely.项目地址: https://gitcode.com/GitHub_Trending/cl/claudecodeui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

如何在 CloudCLI UI 的 MCP 设置里为 Claude、Codex、Cursor、OpenCode 配置 MCP 服务器并同步到本地配置？

相关推荐

固态硬盘删除后数据为何无法恢复？TRIM机制深度解析

React Native NetInfo鸿蒙化改造与网络状态管理实践

抖音批量下载器全攻略：去水印下载、主页搬空、直播录制，一篇讲透

更多资讯

Apache DolphinScheduler Switch 条件分支任务：用表达式驱动工作流动态流转

Milkdown 贡献者开发指南：基于 pnpm 工作区的构建、测试与提交流程实战

帆软报表JS开发实战：从对象模型到控件与单元格的高效获取

GradNorm多任务学习梯度归一化：原理、PyTorch实现与避坑指南

遥感目标检测数据集选型与预处理实战指南

开放式运动耳机选购指南：从耳廓生物力学到声学安全

今日更新

基于高阶循环谱的MPSK载波频率估计与MATLAB实现

MiniPdf方：.NET开源Office转PDF的高效解决方案

Solon AI v3.10：Java全栈智能体开发框架解析

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？