如何在 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），仅供参考