Skip to content

Commit af5ed51

Browse files
cursoragentmsukkari
andcommitted
docs: fix outdated Codex MCP setup instructions
- Replace broken config.toml + 'codex mcp login' primary path with 'codex mcp add sourcebot --url <URL>' which matches Settings → MCP - Add tip near Getting Started pointing users to Settings → MCP for easiest setup (one-click install cards) - Update Codex docs link to current official location - Fix API key path to use CLI flag instead of manual config.toml editing Co-authored-by: Michael Sukkarieh <msukkari@users.noreply.github.com>
1 parent c0d0df9 commit af5ed51

1 file changed

Lines changed: 17 additions & 14 deletions

File tree

‎docs/docs/features/mcp-server.mdx‎

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,10 @@ You can read more about the options in the [authorization](#authorization) secti
2727
If [anonymous access](https://docs.sourcebot.dev/docs/configuration/auth/access-settings#anonymous-access) is enabled on your Sourcebot instance, no OAuth token or API key is required. You can connect directly to the MCP endpoint without any authorization.
2828
</Note>
2929

30+
<Tip>
31+
**Fastest setup:** Open **Settings → MCP** in your Sourcebot deployment to copy the Server URL and use one-click install cards for supported clients. The examples below are useful when you need to customize the URL for self-hosted deployments or use API key authentication.
32+
</Tip>
33+
3034
<Note>
3135
The examples below add the MCP server and connect it to Sourcebot's public deployment at [app.sourcebot.dev](https://app.sourcebot.dev). Replace the URL with your own Sourcebot deployment as needed.
3236
</Note>
@@ -145,30 +149,29 @@ You can read more about the options in the [authorization](#authorization) secti
145149
</Accordion>
146150

147151
<Accordion title="Codex">
148-
[Codex MCP docs](https://developers.openai.com/codex/mcp)
149-
150-
Add the following to your `~/.codex/config.toml` file:
152+
[Codex MCP docs](https://learn.chatgpt.com/docs/extend/mcp)
151153

152154
<Tabs>
153155
<Tab title="OAuth">
154156
<LicenseKeyRequired feature="OAuth" />
155157

156-
```toml
157-
[mcp_servers.sourcebot]
158-
url = "https://app.sourcebot.dev/api/mcp"
159-
```
160-
161-
Replace `https://app.sourcebot.dev` with wherever your Sourcebot instance is hosted. Then run the following to authenticate:
158+
Run the following command:
162159

163160
```sh
164-
codex mcp login sourcebot
161+
codex mcp add sourcebot --url https://app.sourcebot.dev/api/mcp
165162
```
163+
164+
Replace `https://app.sourcebot.dev` with wherever your Sourcebot instance is hosted. Codex will automatically detect OAuth support and prompt you to authorize in your browser when you first connect.
165+
166+
<Tip>
167+
Open **Settings → MCP** in your Sourcebot deployment and click **Copy command** on the Codex card for a ready-to-run command with the correct Server URL.
168+
</Tip>
166169
</Tab>
167170
<Tab title="API Key">
168-
```toml
169-
[mcp_servers.sourcebot]
170-
url = "https://app.sourcebot.dev/api/mcp"
171-
bearer_token_env_var = "SOURCEBOT_API_KEY"
171+
Run the following command:
172+
173+
```sh
174+
codex mcp add sourcebot --url https://app.sourcebot.dev/api/mcp --bearer-token-env-var SOURCEBOT_API_KEY
172175
```
173176

174177
Replace `https://app.sourcebot.dev` with wherever your Sourcebot instance is hosted, then set your API key as an environment variable:

0 commit comments

Comments
 (0)