Imagifly 开发者文档
Agent

Codex

把 Imagifly MCP 服务器接入 OpenAI Codex CLI。

Codex

Codex 是 OpenAI 的编码 Agent。它既可以通过 Codex CLI 在你的终端里工作,也可以在能写代码、跑命令、提 PR 的云端沙箱里工作。接入 Imagifly 后,它在编码工具之外也能生成图片和视频。

添加服务器

把 Key 导出为 IMAGIFLY_API_KEY。
用 Codex CLI 注册服务器。
重启会话并检查 /mcp。
export IMAGIFLY_API_KEY="imf_your_key_here"

codex mcp add imagifly \
  --url https://imagifly.net/api/mcp \
  --bearer-token-env-var IMAGIFLY_API_KEY

Codex 在连接时从环境变量读取 token,所以 Key 不会出现在 ~/.codex/config.toml 里。

配置文件

CLI 会把下面这段配置写入 ~/.codex/config.toml:

[mcp_servers.imagifly]
url = "https://imagifly.net/api/mcp"
bearer_token_env_var = "IMAGIFLY_API_KEY"
enabled = true
startup_timeout_sec = 20
字段用途
url远程 MCP 端点。
bearer_token_env_var存放 bearer token 的环境变量。
enabled设为 false 可保留配置但停用。
startup_timeout_secCodex 启动时等待服务器的时间,默认 10 秒。
http_headers / env_http_headers静态请求头,或从环境变量读取的请求头。

Codex 没有 `--header` 参数

API Key 请用 bearer_token_env_var。如果需要额外的请求头,就在 config.toml 里以 http_headers 添加。

验证

codex mcp list

在会话中执行 /mcp 可以看到每个服务器及其工具。配置正确的 Imagifly 条目会列出六个生成工具。

试一试

Use imagifly to list the video models, then generate a 5 second clip of fog rolling over a pine forest.

Agent 会调用 list_video_models,挑一个支持 5 秒时长的模型,调用 generate_video,再轮询 get_video_generation。

本页内容