Skip to content

常用 AI IDE 添加 MCP 指南(以 Figma 为例)

MCP (Model Context Protocol) 的安装通常非常简单,大多数情况下只需一条命令即可完 成,具体的步骤在对应 mcp 的文档里面也会有说明。本文档旨在记录在不同 AI 编程工具 中配置 Figma MCP 的具体步骤和注意事项,作为备忘。

1. Claude Code

Claude Code 的配置最为标准和直接。

添加步骤

最简单的方法是使用 claude mcp add 命令直接添加 Figma 的远程 MCP 服务。

  1. 运行安装命令:打开终端,运行以下命令:

    bash
    claude mcp add --transport http figma https://mcp.figma.com/mcp
  2. 认证授权

    • 在 Claude Code 中输入 /mcp 命令查看服务器列表,确保 figma 已列出。
    • 系统会提示认证 (Authenticate)。
    • Claude 会提供一个 URL,点击打开浏览器,登录你的 Figma 账户。
    • 在 Figma 授权页面点击 Allow Access(允许访问)。
    • 返回 Claude Code,看到 "Authentication successful" 即表示成功。

使用方法

  • 读取设计:查看 Figma 文件内容,选中节点右键复制所选元素的 link 给到然后直 接给到对话中。
  • 生成代码:结合设计上下文,让 Claude 生成对应的代码组件。

2. Cursor

Cursor 原生支持 MCP,配置界面友好,支持自动安装依赖。

添加步骤

  1. 打开设置
    • 点击右上角齿轮图标 -> General -> MCP (或直接在设置中搜索 "MCP")。
  2. 添加新服务
    • 点击 + Add New MCP Server
    • 在弹出的配置框中,填入以下 JSON 配置:
      json
      {
        "mcpServers": {
          "Figma": {
            "url": "https://mcp.figma.com/mcp"
          }
        }
      }
    • 保存后,Cursor 会自动处理依赖安装和启动。
  3. 认证
    • 添加完成后,Cursor 会尝试启动服务。如果需要认证,通常会弹出提示或在输出面 板显示认证链接,流程与 Claude Code 类似。

检查与使用

  • 检查状态:在设置页面的 MCP 列表中,确保 Figma 服务的开关处于 On 状态且 无报错。
  • Composer 生成:在 Composer (Cmd+I) 中,输入 "参考 Figma 设计 [链接] 生成代 码"。
  • 上下文引用:在 Chat (Cmd+L) 中,可以使用 @Figma (如果插件支持) 或直接用 自然语言描述,Cursor 会自动调用工具。

3. VS Code (GitHub Copilot)

VS Code 的 MCP 支持主要通过 GitHub Copilot 扩展实现。需要注意的是,微软目前的实 现与标准 MCP 协议在配置文件结构上略有不同。

注意事项

  • 配置格式差异:标准协议使用 mcpServers 字段,而 VS Code 目前使用 servers 字段。
  • 兼容性:VS Code 生成的配置文件可能无法被其他遵循标准协议的工具(如 Claude Code)直接读取。

添加步骤

  1. 通过命令添加
    • 按下 Cmd+Shift+P,搜索 MCP: Add Server
    • 根据提示选择方式并填入参数。
  2. 手动配置 (推荐)
    • 在当前项目的 .vscode 文件夹下创建 .mcp.json 文件。
    • 填入以下内容:
      json
      {
        "servers": {
          "Figma": {
            "url": "https://mcp.figma.com/mcp",
            "type": "http"
          }
        },
        "inputs": []
      }
  3. 初始化与状态
    • 保存文件后,VS Code 会自动尝试初始化连接。
    • 如果未自动连接,可以打开 .mcp.json 文件,文件上方通常会出现 MCP 状态菜单 (显示 Running 或 Start),点击即可重启服务。
    • 后续使用 Copilot 时,可以像引用其他上下文一样引用 MCP 服务。

4. Google Antigravity

Google Antigravity 对 MCP 的支持还在演进中。现在的话确实不好用

现状与体验

  • MCP Store:自带一个 MCP Store,搜索和安装通用 MCP 工具比较方便。
  • 复杂配置挑战:对于像 Figma 这样需要复杂认证或初始化的服务,体验尚待优化。
    • 虽然 Store 中提供了 Figma,也有授权说明,但如果需要手动修改配置文件添加,或 者处理初始化流程,操作相对繁琐。
    • Figma 限制:Figma MCP 目前对权限有一定要求(如需要 Pro 计划,且通常需要 项目负责人配置开启 MCP Server),这对普通开发者来说可能是一个门槛。