Skip to content
TeamShared
Docs Blog Sign in
Start free

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

TeamShared
Privacy Security Terms Prepaid credits Refunds Tax Pricing Docs Blog Sign in