Figma MCP 配置指南

状态：已确认

适用范围：TRAE / TRAE SOLO CN 中安装的 Figma AI Bridge MCP（figma-developer-mcp），用于 AI 代理直接拉取 Figma 设计稿节点数据与导出图片资源。

1. 背景

Figma 官方 API 域名（api.figma.com、www.figma.com）在国内网络环境下无法直连（DNS 解析超时）。MCP 服务器默认不走系统代理，导致 get_figma_data / download_figma_images 调用报错：

Error fetching file: Failed to make request to Figma API endpoint ...
Could not connect to the Figma API. If your network requires a proxy,
set the --proxy flag in your MCP server config or the FIGMA_PROXY
environment variable to your proxy URL (e.g. http://proxy:8080).

解决方式：在 MCP 配置中显式指定代理地址（本地 VPN 客户端监听端口）。

2. 配置文件位置

TRAE SOLO CN 的 MCP 配置文件：

C:\Users\<用户名>\AppData\Roaming\TRAE SOLO CN\User\mcp.json

若为 TRAE CN（非 SOLO 版本），对应路径一般在 C:\Users\<用户名>\AppData\Roaming\Trae CN\User\ 下，文件名相同。

3. 完整配置示例（含代理）

{
  "mcpServers": {
    "Figma AI Bridge": {
      "command": "npx",
      "args": [
        "-y",
        "figma-developer-mcp",
        "--stdio"
      ],
      "env": {
        "FIGMA_API_KEY": "<你的Figma个人访问令牌>",
        "FIGMA_PROXY": "http://127.0.0.1:7890"
      },
      "fromGalleryId": "GLips.Figma-Context-MCP"
    }
  }
}

字段说明：

字段	说明
command / args	通过 npx 启动 figma-developer-mcp，--stdio 为标准输入输出模式（TRAE MCP 默认通信方式），保持不动
FIGMA_API_KEY	Figma 个人访问令牌，获取方式见第 5 节
FIGMA_PROXY	代理地址。127.0.0.1:7890 为 Clash 默认监听端口；其他客户端按实际端口填写（见第 4 节）
fromGalleryId	表示该 MCP 从 TRAE MCP 市场安装，保留即可

3.1 代理配置的两种等价写法

写法一：环境变量（推荐，改动最小）

"env": {
  "FIGMA_API_KEY": "<你的token>",
  "FIGMA_PROXY": "http://127.0.0.1:7890"
}

写法二：启动参数

"args": [
  "-y",
  "figma-developer-mcp",
  "--stdio",
  "--proxy=http://127.0.0.1:7890"
]

两种方式二选一即可，不要重复配置。

4. 如何确定本地代理端口

打开 PowerShell 执行：

netstat -ano | findstr "LISTENING" | findstr ":7890 :7891 :10808 :10809 :1080"