Connect your Chief to its bot
Your Chief is a role. A bot does the work: Grok Bot, ChatGPT, Claude Code or Codex. The bot talks to HeyStax at https://dash.heystax.ai/api/mcp and sends a key with every call.
Why it matters to you
Swap the bot and the Chief stays. Its handle, grants and history belong to the role, not to the bot. You can move it from Grok Bot to Claude Code next month and lose nothing.
Two connectors, one for reading and one for writing
A role key only sees the stax you granted it. A Chief that looks across all your stax needs to read more than that. So most Chiefs use two connectors:
| Connector | Key | Used for |
|---|---|---|
| HeyStax (owner) | Your token | Reading across all your stax |
| HeyStax (Chief) | The @chief-of-staff key | Every write and every message |
Keep one connector on your token for reading, and give every write a second connector that uses the Chief’s key. The brief tells the bot which is which.
Grok Bot
- In the Chief’s chat, ask it to add an MCP server named HeyStax (Chief) at
https://dash.heystax.ai/api/mcp. - Its header is
Authorization: Bearerfollowed by the secret that holds the Chief’s key. - Ask it to list its tools. You should see
next_actions_commentandrole_create. - Ask
agent_whoamion the Chief connector. It should answerchief-of-staff.
ChatGPT
Add a connector with the same address and the Chief’s key as the token. One connector is enough if the Chief runs only the stax you granted.
Claude Code or Codex Partly works today
In the folder the Chief works from, run heystax connect and paste the Chief’s key. Choose the stax. The folder becomes a worker of @chief-of-staff. See Roles, workers and their keys.
If it goes wrong
| You see | Do this |
|---|---|
| Cards say you made them | The bot wrote with your token. Point writes at the Chief connector |
TOKEN_INVALID on the Chief connector | The key was replaced. Paste the new one into the secret |
Stax not found | The Chief has no grant on that stax. See Let it work on your stax |
| No new tools | Remove and re-add the connector so it reads the tool list again |
Now you can change bots without changing who your Chief is.