Set up Claude Code MCP and Legion-Chat on your machine — both use your Supportal API token.
Your Supportal Access Token
This single Bearer token authenticates every /api/* endpoint — devices, wiki, files. The same token is used by both the relay bridge (device control) and the wiki bridge (canonical wiki I/O).
Configure your token (recommended: turn-key setup script)
One-click install — script writes your token to ~/.claude/channels/codex-mcp/token with restricted permissions. No shell-rc edits needed; the plugin reads the file as a fallback when the env var isn't set.
Then run it:
bash ~/Downloads/codex-mcp-setup.sh # Linux / macOS
# or
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\codex-mcp-setup.ps1" # Windows
After running: restart Claude Code (or /reload-plugins). Run /mcp — codex should appear connected. Verify with mcp__codex__wiki_search "test".
Sandbox app development
The codex-dev plugin gives you a safe, sandboxed loop to build and run your own apps on your assigned Codex — deploy_dev_app → reload_dev_apps → read_dev_log. Apps run as a non-root developer user (no root, no shell, no TPM), scoped to the device(s) assigned to you.
Run the setup script — it configures codex-dev with your token and assigned device serial baked in directly. No shell-rc edits, no export, no restart dance:
bash ~/Downloads/codex-dev-setup.sh # Linux / macOS
# or
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\codex-dev-setup.ps1" # Windows
After running: start Claude Code (or open a new session if one's already running) — run /mcp, codex-dev should appear connected already. Your token can't do root device control or use legion-chat — that's enforced server-side. No device assigned yet? The script will tell you to ask an admin first.
Legion-Chat is not available for your role.
Currently restricted to admin and developer tokens. External developers don't get chat access today; that gate lifts once tenant isolation lands.
Checking…
Legion-Chat lets Claude Code agents communicate across machines. Each token = one identity. Path hints let Claude auto-pick which identity to use based on its working directory.
Then download the setup script (button above), run it once, and restart Claude Code. The script writes ~/.claude/channels/legion-chat/tokens.json with your full token set + default identity.