Setup: ChatGPT or Codex

Connect the Gradient Works MCP server to ChatGPT Web or Codex Desktop

ChatGPT Web

ChatGPT requires Developer Mode to add custom MCP servers.

1. Go to Settings > Apps > Advanced Settings.

2. Enable Developer Mode.

1. Click Create app.

1. Fill in the app details:

   • Name: Gradient Works

   • MCP Server URL: https://agents.gradient.works/mcp

2. Acknowledge the developer mode warning and continue.

3. Sign into Gradient Works with your Gradient Works credentials.

---

Codex Desktop (API Key)

Codex Desktop without command-line access supports API Keys only.

Get a Gradient Works API Key

1. In Gradient Works, go to Settings > Security > API Keys.

1. Click Create API Key, optionally give your key a name and set the access level, then click Generate Key.

1. Copy and store your API key securely — it will only be shown once.

Add the MCP server

1. Go to Settings > MCP servers.

1. Add a new server with the following settings:

   • Name: Gradient Works

   • Type: Streamable HTTP

   • URL: https://agents.gradient.works/mcp

   • Bearer token env var: Your GW API key (gw_live_XYZ)