Skip to main content

​
Codex

Codex CLI and the IDE extension read MCP configuration from ~/.codex/config.toml. A trusted project can also provide .codex/config.toml.

​
Prerequisites

  • a SocQ API key;
  • Codex CLI or the Codex IDE extension.

​
Configure

Set SOCQ_API_KEY in the environment before starting Codex, then add:
Restart or begin a new Codex session after changing the configuration.
Keep the API key in the environment. Do not put it in the MCP URL or commit it to a project configuration.

​
Limit the tool list

To expose typed YouTube tools, use a filtered MCP URL:
See Choose MCP tools for mode selection and filtering limits.

​
Verify

Ask Codex:
The connection is working when Codex discovers the SocQ tools, calls socq_account, submits the collection, and reads the returned task with socq_get_task.

​
Add workflow guidance

Install the socq-social-research Skill for endpoint selection, cost awareness, polling, pagination, and cross-platform research guidance:
The Skill complements MCP; it does not replace the server. See Agent Skill.

​
Troubleshoot

Begin a new session after configuration changes so Codex refreshes the tool list. See Troubleshooting integrations for authentication, missing-tool, and task errors. See the official Codex config.toml reference for current MCP configuration fields.