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

# Codex

> Connect Codex to Dreamtune MCP and install scoped workflow skills.

<img src="https://mintcdn.com/dreamtune/alDlJCy5wJhi5BBd/images/agents/codex.svg?fit=max&auto=format&n=alDlJCy5wJhi5BBd&q=85&s=6bb488c6a79fcc361651ec08ff3549fd" alt="Codex official logo" width="48" height="48" data-path="images/agents/codex.svg" />

## Before you connect

Create a Dreamtune workspace API key with only the permissions you need.
Hosted HTTP setup needs no Dreamtune package installation. Local stdio setup
requires Node.js 22.20 or later and the published CLI.

## Configure

Merge this server entry into \~/.codex/config.toml (or trusted project .codex/config.toml). Preserve any other servers or settings.

```toml theme={null}
[mcp_servers.dreamtune]
url = "https://mcp.dreamtunelabs.com/mcp"
env_http_headers = { "X-Dreamtune-API-Key" = "DREAMTUNE_API_KEY" }
```

Set DREAMTUNE\_API\_KEY in the environment that launches Codex. The value on the right is an environment-variable name, not the key itself. Use codex mcp list or /mcp to inspect status.

## Verify the connection

Restart the client after changing settings or its environment. Open its MCP
server/tool status view and check that Dreamtune tools are listed. Ask it:

> Use Dreamtune to read model request limits. Do not execute a model, tool or GPU.

Confirm model\_limits returns limits before authorizing paid work. Then inspect a
catalog schema and use one explicitly approved operation. Keep client approval
controls enabled. Never put the key in a chat message, URL or repository.

## Add workflow instructions

Install the [Dreamtune skills](/connect/skills-install) into the skills directory
supported by your client, or copy the platform skill into a user instruction
workflow. A skill guides the agent; MCP provides execution. Neither grants extra
key permissions. See [troubleshooting](/errors) for 401, missing scopes, timeouts
and key/environment problems.

Configuration verified against [the official client documentation](https://developers.openai.com/codex/mcp).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.