MCP 服务器 | Open Design Docs

「MCP 服务器」用于把 Open Design 提供给其他 MCP 客户端使用，例如 Claude Code、Codex、Cursor、VS Code、Antigravity、Zed 和 Windsurf。配置后，这些外部编码工具可以通过 MCP 读取 Open Design 当前项目和文件信息。

如果你只在 Open Design 页面里完成设计和生成任务，通常不需要配置这里。

MCP 服务器是 Open Design 对外提供上下文和工具能力的入口。可以把它理解为「让其他 AI 编码工具访问当前 Open Design 项目的一扇门」。

当你想在 Claude Code、Codex、Cursor、VS Code 等工具里继续实现 Open Design 生成的页面，或让外部智能体读取项目文件、样式、组件和设计包时，就会用到它。

使用前，需要保持 Open Design 正在运行，并把页面生成的配置片段复制到对应客户端。不同客户端使用的配置格式不同，请按页面中选中的客户端说明操作。

它能做什么

读取或搜索项目中的 HTML、JSX、CSS、JSON、SVG、Markdown 等文件。
一次性拉取设计包，包括入口文件和它引用的 CSS 变量、组件、字体等信息。
默认使用你在 Open Design 中打开的项目和文件，减少在外部工具里重复说明上下文。

支持的客户端

设置页会先从本地 daemon 读取当前安装路径，然后按所选客户端生成配置片段。

客户端	页面提供的方式	使用方式
Claude Code	CLI 命令	在终端运行页面给出的 `claude mcp add-json` 命令
Codex	TOML 配置和一键配置	追加到 Codex 配置文件，或点击「配置到 Codex」
Cursor	一键安装和 JSON 配置	点击「在 Cursor 中安装」，或合并到 Cursor MCP 配置
VS Code	JSON 配置	打开 MCP 用户配置后合并页面片段
Antigravity	JSON 配置	在 MCP Servers 的 raw config 中合并片段
Zed	JSON 配置	合并到 Zed Settings 的 `context_servers`
Windsurf	JSON 配置	合并到 Windsurf MCP 配置文件或在 Cascade 中配置

复制配置后，通常需要重启客户端或刷新窗口。Cursor、VS Code、Antigravity、Windsurf 一般可以通过开发者命令刷新窗口；Zed 和 Claude Code 通常需要退出后重新打开。

页面状态

状态	含义	处理方式
正常显示配置片段	本地 daemon 已返回可用安装信息	按当前客户端复制或安装
显示本地 daemon 错误	设置页无法读取 MCP 安装路径	确认 Open Design 正在运行，然后重新打开此面板
Codex 一键配置不可用	没有在 PATH 中找到 Codex CLI	先安装 Codex，或手动复制 TOML 片段
当前为最新配置但客户端无工具	客户端可能还没重新加载 MCP 配置	重启客户端或刷新窗口

Open Design 必须保持运行，外部 MCP 客户端才能成功调用它。如果你先启动了外部编码工具，再打开 Open Design，建议重启或刷新外部工具。

和「外部 MCP」的区别

「MCP 服务器」是把 Open Design 提供给其他工具使用；「外部 MCP」是让 Open Design 连接第三方 MCP 工具服务器，例如图像生成、网页截图、GitHub、Filesystem 等工具服务。两者方向相反：

设置项	方向	典型用途
MCP 服务器	外部工具 → Open Design	让 Claude Code、Codex、Cursor 等读取 Open Design 项目
外部 MCP	Open Design → 第三方 MCP 服务	让 Open Design 的编码智能体使用 Higgsfield、GitHub 等外部工具

常见问题

问题	处理方式
复制后外部工具看不到 Open Design MCP	重启对应工具，或刷新窗口
页面提示守护进程不可用	确认 Open Design 正在运行，再重新打开设置页
不知道选哪个配置方式	选择你正在使用的客户端，不要混用不同客户端的配置格式
Codex 点了一键配置后仍不可用	重启 Codex，让它重新读取 MCP 配置
外部工具能读取哪个项目	默认读取你在 Open Design 中打开的项目和文件