You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+49-12Lines changed: 49 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -140,8 +140,8 @@ Replace `YOUR_API_KEY_HERE` with your actual API key.
140
140
**Option 1: Remote HTTP (Recommended)**
141
141
142
142
1. Open Cursor → Settings (`Cmd+,` or `Ctrl+,`)
143
-
2. Navigate to **"MCP"** in the left panel
144
-
3. Click **"Add new MCP server"**
143
+
2. Navigate to **"Tools & MCP"** in the left panel (older builds called this **"Tools & Integrations"**)
144
+
3. Click **"New MCP Server"**
145
145
4. Paste this configuration:
146
146
147
147
```json
@@ -157,7 +157,9 @@ Replace `YOUR_API_KEY_HERE` with your actual API key.
157
157
}
158
158
```
159
159
160
-
5. Save and restart Cursor
160
+
5. Save — Cursor reloads the server automatically. The entry is stored in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global).
161
+
162
+
> **Tip:** Cursor also supports a one-click install deeplink — `cursor://anysphere.cursor-deeplink/mcp/install?name=codealive&config=BASE64_CONFIG`. Only follow deeplinks from trusted sources.
161
163
162
164
**Option 2: Docker (STDIO)**
163
165
@@ -179,29 +181,64 @@ Replace `YOUR_API_KEY_HERE` with your actual API key.
179
181
</details>
180
182
181
183
<details>
182
-
<summary><b>Codex</b></summary>
184
+
<summary><b>Codex (CLI, App, IDE Extension)</b></summary>
185
+
186
+
OpenAI Codex ships in three form-factors that **share the same configuration**: the **Codex CLI**, the **Codex App** (macOS / Windows), and the **Codex IDE Extension** (VS Code `openai.chatgpt` and JetBrains 2025.3+). All three read `~/.codex/config.toml`, so one snippet covers every Codex surface. A project-level `.codex/config.toml` in the repo root is also supported for trusted projects.
183
187
184
-
OpenAI Codex CLI supports MCP via `~/.codex/config.toml`.
> **Note:** Streamable HTTP support requires `rmcp_client = true` under a `[features]` section in your Codex configuration.
212
+
> **Note:** Streamable HTTP requires `[features].rmcp_client = true`. The old top-level `experimental_use_rmcp_client = true` flag is deprecated. `bearer_token_env_var` is preferred over inline `headers = { Authorization = "Bearer …" }` because it keeps secrets out of the config file.
No `[features]` flag is needed for stdio. `env_vars` forwards values from the parent shell — safer than embedding the key in `args`.
239
+
240
+
**Codex App UI:** Settings → MCP Servers → Add Server. The UI writes the same `~/.codex/config.toml` entry. The CLI and IDE extension pick it up automatically.
0 commit comments