Connect Codex

Add the Voxmin MCP server to the Codex CLI in config.toml, so Codex can make pictures, songs and karaoke with your Voxmin credits.

Codex

The Codex CLI (and the Codex IDE extension, which shares its config) connects to Voxmin's MCP server directly over HTTP, and signs in with your Voxmin account.

Before you start

A Voxmin account with some credits.
A recent Codex CLI.

codex mcp add voxmin --url https://api.voxmin.com/auth/mcp
codex mcp login voxmin

The first command adds Voxmin to ~/.codex/config.toml. The second opens your browser: log in to Voxmin if you are asked, check that the page names Codex, and choose Approve. Then start a new Codex session.

Voxmin lists Codex under AI Integrations → Connected apps. Sign out there stops it at once.

With a personal token instead

For a machine with no browser, Codex can read a personal token from an environment variable, so it never sits in the config file. Make one on AI Integrations; it starts with vxm_ and is shown only once.

Add the server to config.toml

Open ~/.codex/config.toml (create it if it does not exist) and add:

~/.codex/config.toml

[mcp_servers.voxmin]
url = "https://api.voxmin.com/auth/mcp"
bearer_token_env_var = "VOXMIN_TOKEN"

bearer_token_env_var names the environment variable Codex reads the token from; Codex sends it as Authorization: Bearer ….

Set your token

In the shell you start Codex from — or in your shell profile, so it is always set:

export VOXMIN_TOKEN="<your token>"

Start Codex

Start a new Codex session. MCP servers are connected when a session starts.

A project can carry its own .codex/config.toml, which Codex reads only for projects you trust. The same [mcp_servers.voxmin] table works there — and because the token stays in VOXMIN_TOKEN, the file is safe to commit.

Codex releases from before HTTP servers were fully supported only connected to local servers. If Voxmin never connects, update Codex. Very old releases needed experimental_use_rmcp_client = true at the top of config.toml to reach HTTP servers at all.

Check it works

Run codex mcp list. voxmin should be listed with its URL.
Inside Codex, /mcp shows the connected servers and their tools.
Ask: "What's my Voxmin balance?" Codex calls get_account and answers with your credits.

Troubleshooting

What you see	Why	What to do
Voxmin is listed but has no tools	`VOXMIN_TOKEN` is not set in the shell Codex started from	`test -n "$VOXMIN_TOKEN" && echo set` should print `set`; set it and start a new session
`401 Unauthorized`	The token is wrong, revoked or expired, or the account is suspended or deleted	Make a new token on AI Integrations and update `VOXMIN_TOKEN`
"Daily credit cap reached"	Today's spend through this token would pass the cap you set on it	Wait until midnight UTC, or make a token with a higher cap
"Not enough credits"	Your balance is lower than the tool's price	Top up on the Pricing page
`429 Too Many Requests`	More than 60 requests in a minute through this token	Wait a minute and try again
The request is refused	It did not pass Voxmin's content checks	Change the request. A refused picture is not charged

See the overview for every tool, its price and how billing works.

What developers say about us

From developers integrating the Voxmin API into their applications.

“비동기 작업 모델이 기존 큐와 잘 맞아서 통합 구조를 단순하게 유지할 수 있었습니다.”

정

정우진

백엔드 개발자, 서울

“작업 상태를 이용해 앱을 멈추지 않고도 명확한 진행 상황을 보여 줍니다.”

오

오서연

풀스택 개발자, 부산

“오디오 처리를 한곳으로 모으면서 클라이언트별 예외 로직이 줄었습니다.”

윤

윤도현

테크 리드, 인천

“문서를 보며 배치 처리기를 연결하기 전에 요청 형식을 검증했습니다.”

한

한지민

플랫폼 엔지니어, 대전