> ## Documentation Index
> Fetch the complete documentation index at: https://help.ruddr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect ChatGPT and Codex to Ruddr

> Add Ruddr to a ChatGPT Business or Enterprise workspace, or to the Codex CLI, desktop app, and IDE extension.

**NOTE:** The Ruddr Assistant [feature](/workspace-administration/features) must be enabled in workspace settings in order for this to be available in your workspace.

OpenAI's tools reach outside services through MCP servers. Each one asks for the Ruddr server address:

```text theme={null}
https://www.ruddr.io/api/mcp
```

You are never asked for a password, an API key, or a token. Whichever tool you use, Ruddr asks you to sign in and approve the connection at the end — see [Connecting an Application](/integrations/ai-connectors-overview#connecting-an-application).

OpenAI's settings and menu labels change from time to time, so treat OpenAI's own [MCP documentation](https://learn.chatgpt.com/docs/extend/mcp) as the authority on the screens themselves — what follows is what to enter when you get there.

#### ChatGPT Business and Enterprise

In ChatGPT, Ruddr is added as a custom MCP app by a workspace admin or owner, not by individual members. Adding one requires **developer mode**, which an admin turns on in **Workspace settings > Permissions & roles**, under **Connected Data**. The admin then creates the app from **Workspace settings > Apps > Create**, gives it the Ruddr server address, runs ChatGPT's tool scan, and publishes it to the workspace. Published apps appear in members' **Apps** settings labeled **Custom**.

This is a beta feature in ChatGPT and its screens change as OpenAI iterates, so follow their current instructions in [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) for the steps themselves. Four things are worth knowing before you start:

* **Which plans.** Full MCP support, including the ability to create and update records, is available on ChatGPT Business, Enterprise, and Edu, on the web only — not on mobile. On a Pro account, developer mode connects Ruddr for reading only.
* **What to enter.** When ChatGPT asks for the MCP server endpoint, use the Ruddr server address above. Ruddr publishes its own sign-in requirements, so there is no OAuth client ID, secret, or API key for you to create. If the tool scan asks you to authorize first, that is the Ruddr approval screen.
* **What publishing does and does not do.** Making the app available to your workspace gives nobody access to Ruddr data. Each member still connects Ruddr, signs in, and approves it individually, and then sees only what their own [security role](/workspace-administration/security-roles) allows.
* **Updates are not automatic.** ChatGPT freezes the list of Ruddr tools at the moment you publish. When Ruddr adds new capabilities, an admin has to refresh the app's actions in workspace settings before members can use them.

#### Codex CLI

Add Ruddr and then sign in, from a terminal:

```bash theme={null}
codex mcp add ruddr --url https://www.ruddr.io/api/mcp
```

```bash theme={null}
codex mcp login ruddr
```

The login command sends you to Ruddr to approve the connection. If you are working over SSH or on a machine with no browser, Codex may show you a short code instead — enter it at [**www.ruddr.io/device**](http://www.ruddr.io/device), as described in [Connecting a Device or Terminal](/integrations/ai-connectors-overview#connecting-a-device-or-terminal).

To confirm the connection, run `codex mcp list`. To remove it, run `codex mcp remove ruddr`.

#### Codex Desktop App and IDE Extension

In the desktop app, open **Settings** and select **MCP servers**. In the IDE extension, open the gear menu and select **MCP servers**. From there the steps are the same:

1. Select **Add server**.
2. Enter `Ruddr` as the name, choose **Streamable HTTP**, and enter the Ruddr server address as the URL.
3. Save the server, then select **Restart** — or **Restart extension** in the IDE.
4. Ruddr appears in the server list marked as needing authentication. Click **Authenticate** and approve the connection in Ruddr.

#### What a Connected Application Can See

A connected application acts as you. It can only read and change what your [security role](/workspace-administration/security-roles) already allows, so it can never reach data you could not open yourself in Ruddr. Anything it records is attributed to you, with the application shown as the source in the entry's history.

To review or revoke a connection, use the [Connected Apps](/integrations/ai-connectors-overview#managing-your-connected-apps) page in your Ruddr profile.