如何在 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),仅供参考

相关新闻

gs_quant 时序代数库 weighted_sum:加权和/加权均值计算的实现原理与实战指南

gs_quant 时序代数库 weighted_sum:加权和/加权均值计算的实现原理与实战指南

gs_quant 时序代数库 weighted_sum:加权和/加权均值计算的实现原理与实战指南 【免费下载链接】gs-quant Python toolkit for quantitative finance 项目地址: https://gitcode.com/GitHub_Trending/gs/gs-quant 导读 weighted_sum 是 gs_quant 时间序列代数…

2026/11/22 11:42:00 阅读更多 →
从零实现物质点法MPM:PIC与APIC原理、调试与工程落地

从零实现物质点法MPM:PIC与APIC原理、调试与工程落地

1. 这不是“又一个物理引擎教程”,而是一次从零重建物质点法直觉的实操记录我第一次在GAMES201课堂上看到那个红色小球撞进沙堆、沙粒飞溅却保持连续形变的动画时,手心是出汗的。不是因为震撼——当时我刚写完第三个基于网格的弹性体模拟,对“…

2026/11/22 11:42:00 阅读更多 →
Typebot React 嵌入库完整指南:Standard、Popup 与 Bubble 三种模式的实战配置

Typebot React 嵌入库完整指南:Standard、Popup 与 Bubble 三种模式的实战配置

Typebot React 嵌入库完整指南:Standard、Popup 与 Bubble 三种模式的实战配置 【免费下载链接】typebot.io 💬 Typebot is a powerful chatbot builder that you can self-host. 项目地址: https://gitcode.com/GitHub_Trending/ty/typebot.io T…

2026/11/4 7:48:08 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻