Imagifly 开发者文档
Agent

Cursor

把 Imagifly MCP 服务器接入 Cursor。

Cursor

Cursor 是 Anysphere 的 AI 代码编辑器。它的 Agent 模式能理解代码库、跨文件修改并执行命令。接入 Imagifly 后,Agent 不必离开编辑器,就能生成界面或营销活动所需的图片和视频。

添加服务器

创建 API Key,并在 Cursor 启动的环境里导出为 IMAGIFLY_API_KEY。
创建或编辑 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目)。
重载窗口,然后检查 设置 → MCP。
{
  "mcpServers": {
    "imagifly": {
      "url": "https://imagifly.net/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IMAGIFLY_API_KEY}"
      }
    }
  }
}

${env:IMAGIFLY_API_KEY} 由 Cursor 解析,所以 Key 不会留在文件里。

Cursor 必须带请求头

Cursor 不会从 query string 里读取 API Key。真正让 MCP 服务器通过鉴权的是 Authorization 请求头;缺少它的配置能连上,但列不出任何工具。

验证

打开 Cursor 设置 → MCP。imagifly 条目应显示绿色状态和六个工具。在 Agent 模式下输入:

Generate a 1:1 icon for a weather app: soft blue gradient, white sun, no text.

Agent 会调用 generate_image,任务完成后返回 URL。

说明

  • 项目级的 .cursor/mcp.json 对团队协作很方便,但不能包含 Key;这里同样建议使用 ${env:...}。
  • MCP 工具只在 Agent 模式出现,普通对话里没有。

本页内容