figma-mcp-config

# Figma 智能体配置参考 使用此代码片段在 `~/.codex/config.toml` 中将 Figma 智能体服务器注册为流式 HTTP 服务器，并使用从环境变量中提取的 bearer 认证。 toml [mcp_servers.figma] url = "https://mcp.figma.com/mcp" bearer_token_env_var = "FIGMA_OAUTH_TOKEN" http_headers = { "X-Figma-Region" = "us-east-1" } ## 注意事项和选项 - Bearer 令牌必须在启动 Codex 的环境中作为 `FIGMA_OAUTH_TOKEN` 可用。 - 保持区域标头与您的 Figma 区域一致。如果您的组织使用其他区域，请相应更新 `X-Figma-Region`。 - 流式 HTTP 上的 OAuth 需要 RMCP 客户端：在 `config.toml` 的顶层设置 `[features].rmcp_client = true`（或在旧版本中为 `experimental_use_rmcp_client = true`）。 - 可选的每个服务器超时：如果需要，可以在 `[mcp_servers.figma]` 中设置 `startup_timeout_sec`（默认 10）和 `tool_timeout_sec`（默认 60）。 ## 环境变量设置（如果缺失） - 当前 shell 的一次性设置：`export FIGMA_OAUTH_TOKEN=""` - 为未来会话持久化：将 export 行添加到您的 shell 配置文件（例如 `~/.zshrc` 或 `~/.bashrc`），然后重启 shell 或 IDE。 - 在启动 Codex 前验证：`echo $FIGMA_OAUTH_TOKEN` 应打印出一个非空的令牌。 ## 设置 + 验证检查清单 - 将上述代码片段添加到 `~/.codex/config.toml` 中的 `[mcp_servers.figma]` 下，并启用 `[features].rmcp_client = true`（或旧版本中的 `experimental_use_rmcp_client = true`）。 - 更新配置和环境变量后重启 Codex (CLI/IDE)。 - 要求 Codex 列出 Figma 工具或运行简单的调用以确认服务器可达。 ## 故障排除 - 令牌未被识别：在启动 Codex 的同一个 shell 中导出 `FIGMA_OAUTH_TOKEN`，或者将其添加到 shell 配置文件并重启。 - OAuth 错误：验证 `rmcp_client` 已启用且 bearer 令牌有效。从 Figma 复制的令牌不应包含周围的引号。 - 网络/标头：保留 `X-Figma-Region` 标头；如果您的组织使用其他区域，请在配置和请求中一致地更新标头。 ## 使用提醒 - 服务器是基于链接的：复制 Figma 框架或图层链接，然后要求智能体客户端实现该 URL。客户端将从链接中提取节点 ID（它不会浏览页面）。 - 如果输出感觉通用，请重申主技能中的项目特定规则，并确保遵循必需流程（get_design_context → 如果需要则 get_metadata → get_screenshot）。