Skip to main content
Before you start, create a key and store it as described in Local AI agents. The examples assume QUIVA_API_KEY is exported in the environment Codex starts from. Codex reads MCP servers from ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Remote server

env_http_headers maps the x-api-key header to the environment variable that holds the key, so the key itself never sits in the file. Run codex mcp list to see configured servers.

Local stdio servers

Use a profile so every server shares one key store:
Add one table per server you want. See Run the servers locally for the list and requirements.

Guide Codex with AGENTS.md

Codex reads AGENTS.md from your repository (from the project root down to the folder you are working in) and from ~/.codex. A short note keeps it safe and consistent:

The quiva-config script from Codex

Codex does not load Claude Code plugins. Copy the repository’s skills/quiva-config folder somewhere Codex can read it and refer to it from AGENTS.md as above. See Skills.