Codex

Codex CLI 和 IDE 扩展从 ~/.codex/config.toml 读取 MCP 配置。可信项目也可以提供 .codex/config.toml。

前置条件

启动 Codex 前，在环境中设置 SOCQ_API_KEY，然后添加：

[mcp_servers.socq]
url = "https://api.socq.ai/mcp"
bearer_token_env_var = "SOCQ_API_KEY"
tool_timeout_sec = 45

更改配置后重新启动或开始新的 Codex 会话。

将 API 密钥保留在环境中。不要将其放在 MCP URL 中或将其提交到项目配置中。

要只加载 YouTube 的类型化工具（Typed tools），请使用带过滤条件的 MCP URL：

[mcp_servers.socq_youtube]
url = "https://api.socq.ai/mcp?platforms=youtube"
bearer_token_env_var = "SOCQ_API_KEY"
tool_timeout_sec = 45

有关模式选择和过滤限制，请参阅选择 MCP 工具。

向 Codex 提问：

请使用 SocQ 检查我的账户，然后采集这个 YouTube 视频最新的 20 条评论。
等待任务完成后，以表格形式返回结果：
https://www.youtube.com/watch?v=VIDEO_ID

当 Codex 发现 SocQ 工具、调用 socq_account、提交采集并使用 socq_get_task 读取返回的任务时，连接正在工作。

安装 socq-social-research Skill，让 Codex 学会选择 API、理解计费规则、轮询任务、翻页读取结果并开展跨平台调研：

npx skills add SocQAPI/socq-devtools

该技能与 MCP 相辅相成；它不会取代服务器。参见Agent Skill。

配置更改后开始新会话，以便 Codex 刷新工具列表。有关身份验证、缺少工具和任务错误，请参阅集成故障排除。有关当前 MCP 配置字段，请参阅官方 Codex config.toml 参考。