Codex
Docs · Codex
Server URL: https://teamshared.com/mcp. Sign-in is OAuth with
the same emailed one-time code as the console
(teamshared.com/login; first sign-in creates your org).
Codex registers the server and logs in through the system browser.
Paste this into Codex
Add the TeamShared MCP server at https://teamshared.com/mcp to Codex (run `codex mcp add teamshared --url https://teamshared.com/mcp`), then run `codex mcp login teamshared`. If my browser is on a different device than this machine (for example I am on a phone), the sign-in ends on a 127.0.0.1 page that cannot load. In that case do not retry: tell me to copy the full 127.0.0.1 callback URL from that page and paste it here, then run `curl -sS '<that url>'` on this machine to finish the login. If that still fails, ask me for a TeamShared API key and use the key setup instead (export `TEAMSHARED_TOKEN`, and register with `--bearer-token-env-var TEAMSHARED_TOKEN`). Use OAuth sign-in (no API key). Then run the sign-in flow, tell me when to finish the emailed one-time code in the browser, and confirm by calling the `health` tool.
Codex opens the system browser for OAuth; finish the emailed code there. Signing in from a phone, or Codex runs on a remote machine? The browser ends on a 127.0.0.1 page that cannot load. Copy the command TeamShared shows (or that full URL) and run curl -sS '<url>' on the machine running Codex.
Verify
Run codex mcp list (teamshared should be listed), then ask Codex to call the health tool.
Manual ~/.codex/config.toml
For a key instead of OAuth, export TEAMSHARED_TOKEN and use bearer_token_env_var.
[mcp_servers.teamshared]
url = "https://teamshared.com/mcp"
All clients · Claude.ai & Desktop · Claude Code · Cursor · Codex · ChatGPT · VS Code / Copilot · Windsurf / Devin Desktop · Gemini CLI · Gemini · Devin · Grok Bot · OpenClaw · Hermes