> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Connect Codex to SocQ MCP, verify a collection, and optionally add the Agent Skill.

# Codex

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

## Configure remote MCP

Set `SOCQ_API_KEY` in the environment before starting Codex, then add:

```toml theme={"system"}
[mcp_servers.socq]
url = "https://api.socq.ai/mcp"
bearer_token_env_var = "SOCQ_API_KEY"
tool_timeout_sec = 45
```

For typed YouTube tools:

```toml theme={"system"}
[mcp_servers.socq_youtube]
url = "https://api.socq.ai/mcp?platforms=youtube"
bearer_token_env_var = "SOCQ_API_KEY"
tool_timeout_sec = 45
```

Codex supports `url` for Streamable HTTP MCP servers and `bearer_token_env_var` for environment-backed bearer authentication. Restart or begin a new Codex session after changing the configuration.

## Verify

Ask Codex:

```text theme={"system"}
Use SocQ to check my account, then collect the latest 20 comments from this
YouTube video. Wait for the task and return the results as a table:
https://www.youtube.com/watch?v=VIDEO_ID
```

The connection is working when Codex can call `socq_account`, submit the collection, and read the returned task with `socq_get_task`.

## Add workflow guidance

Install the `socq-social-research` Skill to add endpoint selection, billing, polling, pagination, and cross-platform research guidance:

```bash theme={"system"}
npx skills add socq-ai/socq-devtools
```

The Skill complements MCP; it does not replace the server. See [Agent Skill](/integrations/skill).

See the official Codex [`config.toml` reference](https://learn.chatgpt.com/docs/config-file/config-reference#configtoml) for current MCP configuration fields.