Skip to content
Docs / Codex

Codex

Codex connects to remote MCP servers over streamable HTTP. Point it at the hosted endpoint and give it your key through an environment variable.

Install

Add the server to ~/.codex/config.toml. Codex reads the bearer token from the variable you name, so the key never sits in the file:

~/.codex/config.tomltoml
[mcp_servers.astron]
url = "https://design.axm.lol/mcp"
bearer_token_env_var = "ASTRON_API_KEY"

Pass your key

Set ASTRON_API_KEY once in your shell profile, then start Codex from that shell:

~/.zshrc
export ASTRON_API_KEY="ast_live_…"
Shell profiles are plain text. On shared machines, load the key from your password manager instead.

Verify

Terminal
$ codex mcp list
astron  https://design.axm.lol/mcp  enabled

Updates

There is nothing to install or pin. Tools and the library are served from design.axm.lol/mcp and update without a restart; Codex picks up new tools the next time it starts.