Agent
MCP 服务器
把 Imagifly 接入任何支持 Model Context Protocol 的 Agent。
Imagifly 提供一个远程 MCP 服务器：
https://imagifly.net/api/mcp它使用 Streamable HTTP 传输，鉴权用的 Key 与 HTTP API 相同，对外提供六个工具。任何支持远程 HTTP 服务器的 MCP 客户端都能连接；本节介绍我们实际测试过的客户端。
工具
| 工具 | 作用 |
|---|---|
list_image_models | 图片模型目录，含积分价格与各项限制。 |
generate_image | 提交文生图任务（可选参考图、比例、质量、分辨率、步数）。 |
get_image_generation | 轮询图片任务并读取图片 URL。 |
list_video_models | 视频模型目录，含尺寸、时长和支持的工作流。 |
generate_video | 提交文生视频、参考图生视频或首帧/尾帧任务。 |
get_video_generation | 轮询视频任务并读取视频 URL。 |
工具调用只是 HTTP API 的轻量封装：同样的模型、同样的积分、同样的错误码。生成依然是异步的，所以 Agent 通常调用一次 generate_*，再反复调用 get_* 直到任务结束。
鉴权
每个请求都通过请求头传入 Key：
Authorization: Bearer imf_your_key_here也接受 x-api-key: imf_your_key_here。Key 请在 API 控制台 创建。
手动配置
大多数客户端都接受下面这段 JSON：
{
"mcpServers": {
"imagifly": {
"type": "http",
"url": "https://imagifly.net/api/mcp",
"headers": {
"Authorization": "Bearer imf_your_key_here"
}
}
}
}客户端支持的话，优先使用环境变量插值（${IMAGIFLY_API_KEY} 或 ${env:IMAGIFLY_API_KEY}），这样 Key 不会落到磁盘上。
选择你的客户端
Claude Code
Anthropic 的终端编码 Agent，一条 CLI 命令即可。
Codex
OpenAI Codex CLI，一条 CLI 命令即可。
OpenClaw
自托管的 Agent 网关，改一下它的 JSON 配置。
WorkBuddy
腾讯的 AI 办公 Agent，在设置里添加服务器。
Cursor
Anysphere 的 AI 编辑器，编辑 mcp.json。
验证连接
让 Agent 列出它的工具。连接正常时会看到上面六个 imagifly 工具。如果客户端显示服务器已连接却列不出工具，通常是请求没有通过鉴权——检查请求头是否严格写成 Authorization: Bearer imf_...。