API keys
In Astro, an API key is an agent token: a key you give an AI agent such as Claude Code, Codex or Hermes so it can work in Astro as you. You never need a key from OpenAI, Google or any other AI company. Astro's own AI runs on Astro's keys.
Make a token
- Open Settings, then Connect agents, in the Astro app, or open Account on the Astro website.
- Press Create token and give it a name, such as Codex on my laptop.
- Copy the token. It starts with
astro_and is shown only once.
Use a token
Give the token to the agent as a bearer token on Astro's MCP address:
| Where your projects are | Address |
|---|---|
| On this computer, with the Astro app open | http://127.0.0.1:41417/api/cut/mcp |
| In the cloud | https://astro-cut.vercel.app/mcp |
The step-by-step guides are in Connect Claude Code and Connect Codex and Hermes. The Connect buttons on the Agents page do all of this for you.
See and stop a token
The Agents page lists every token with when it was made, when it was last used and how many calls it made. Revoke stops the agent that holds it at once.
Work an agent does through a token is counted under your account. See Astro credits and usage.
Keeping tokens safe
- Never paste a token into a chat message, a project title or a file you share.
- Make one token for each agent, so you can stop one without touching the others.
- If a token was shown to someone else, revoke it and make a new one.