Skip to main content
NOTE: The Ruddr Assistant feature 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:
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. OpenAI’s settings and menu labels change from time to time, so treat OpenAI’s own MCP documentation 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 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 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:
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, as described in 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 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 page in your Ruddr profile.