Update MCP client connect steps

components/pages/get-started/mcp-clients/client-titles.ts

@@ -1,5 +1,8 @@
 // Display titles for the MCP client pages, keyed by page slug.
 const meta: Record<string, { title?: string }> = {
+  chatgpt: {
+    title: "ChatGPT",
+  },
   "claude-code": {
     title: "Claude Code",
   },

components/pages/get-started/mcp-clients/mcp-client-grid.tsx

@@ -4,6 +4,11 @@ import meta from "./client-titles";
 
 // MCP Client data with logos and descriptions
 const mcpClients = [
+  {
+    key: "chatgpt",
+    name: "ChatGPT",
+    description: "OpenAI's chat app with custom MCP servers",
+  },
   {
     key: "cursor",
     name: "Cursor",
@@ -36,6 +41,7 @@ const mcpClients = [
 
 // Logo mapping
 const logoSrc = {
+  chatgpt: "/images/icons/openai.png",
   cursor: "/images/icons/cursor.png",
   "claude-desktop": "/images/icons/claude.png",
   "claude-code": "/images/icons/claude.png",

content/docs/get-started/agent-plugin/index.mdx

@@ -1,7 +1,7 @@
 ---
 title: Install the Arcade agent plugin
 sidebarTitle: Install
-description: Install Arcade in Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, or Claude Desktop. Connect your agent to apps through Arcade with browser sign-in.
+description: Install Arcade in Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, ChatGPT, or Claude Desktop. Connect your agent to apps through Arcade with browser sign-in.
 ---
 
 import { SignupLink } from "@/components/analytics";
@@ -17,7 +17,7 @@ Install the Arcade agent plugin in a supported client and connect to its hosted
 
 <GuideOverview.Prerequisites>
 
-- A [supported client](/en/get-started/agent-plugin/whats-included#client-support): Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, or Claude Desktop
+- A [supported client](/en/get-started/agent-plugin/whats-included#client-support): Cursor, Claude Code, VS Code, GitHub Copilot CLI, Codex, or Claude Desktop. ChatGPT on the web uses the upload steps in the Codex tab.
 - An <SignupLink linkLocation="docs:agent-plugin-install">Arcade account</SignupLink>
 - For Claude Code, Claude Cowork, Cursor CLI, GitHub Copilot CLI, and VS Code Copilot sessions: [Node.js](https://nodejs.org/) on the host's `PATH`
 
@@ -44,7 +44,7 @@ Install the Arcade agent plugin in a supported client and connect to its hosted
 </Tabs.Tab>
 <Tabs.Tab>
 
-Use this installation for a [Codex session in the CLI or ChatGPT desktop app](https://developers.openai.com/plugins/build/plugins#enable-or-disable-a-plugin-for-a-repo).
+These commands install Arcade for Codex in the CLI. The same local install is available in a new Codex session in the ChatGPT desktop app. See [OpenAI's plugin commands](https://developers.openai.com/plugins/build/plugins).
 
 1. Add the Arcade marketplace and install the plugin:
 
@@ -53,11 +53,26 @@ Use this installation for a [Codex session in the CLI or ChatGPT desktop app](ht
    codex plugin add arcade@arcade
    ```
 
-2. Start a new Codex session in the CLI or ChatGPT desktop app.
-3. Open `/plugins` and confirm **Arcade** is installed and enabled.
+2. Start a new Codex session so the install is loaded. In the ChatGPT desktop app, start a new chat.
+3. Open `/plugins` and confirm **arcade** is installed and enabled.
 4. Connect the **arcade** MCP server and sign in to Arcade in the browser when prompted.
 5. Choose `@Arcade` or invoke `$arcade:try-arcade` to start.
 
+### Install in ChatGPT on the web
+
+Arcade is not in the public plugin directory. Upload the release package. This path needs a ChatGPT account that can upload plugins. In a managed workspace, an owner or admin uploads the plugin, and members install it from the workspace directory.
+
+1. Open [Arcade's plugin releases](https://github.com/ArcadeAI/arcade-plugin/releases).
+2. On a release that includes the ChatGPT plugin, expand **Assets** and download `arcade-chatgpt-{VERSION}.zip`. The **Source code (zip)** asset is the repository, not the plugin package. Keep the file compressed.
+3. Open [ChatGPT on the web](https://chatgpt.com). Go to **Admin console**, select the workspace, and open **Plugins**. Select **Add**, then **Upload plugin**, and choose the ZIP.
+4. Select **Install plugin** if ChatGPT asks, then connect Arcade and sign in when prompted.
+
+If **Upload plugin** is not in that menu, this account cannot upload plugins. Ask a workspace admin. Pasting the ZIP into a chat does not install it.
+
+A plugin marked **Desktop only** runs in the ChatGPT desktop app. See [Plugins in ChatGPT](https://help.openai.com/en/articles/20001256-plugins-in-chatgpt).
+
+To connect a gateway you configure, see [Use Arcade in ChatGPT](/en/get-started/mcp-clients/chatgpt).
+
 </Tabs.Tab>
 <Tabs.Tab>
 
@@ -126,7 +141,7 @@ Keep the clone inside `~/.cursor/plugins/local/`. Cursor ignores symlinks to fol
 
 Requires a [paid Claude plan](https://support.claude.com/en/articles/13837440-use-plugins-in-claude). On Team or Enterprise, your organization must allow this marketplace.
 
-1. Open **Customize → Plugins → Add → Add marketplace → Add from a repository**.
+1. Open **Customize → Plugins → Add → Add marketplace**.
 2. Paste `ArcadeAI/arcade-plugin`.
 3. Add **Arcade** from the marketplace.
 4. Open **Arcade → Connectors**, then add and connect **arcade** if it is not connected. Sign in to Arcade when prompted.

content/docs/get-started/mcp-clients/chatgpt.mdx

@@ -0,0 +1,65 @@
+---
+title: Use Arcade in ChatGPT
+sidebarTitle: ChatGPT
+description: Connect ChatGPT to an Arcade MCP Gateway by adding the gateway as a custom MCP server.
+---
+
+import { SignupLink } from "@/components/analytics";
+
+<Callout type="info">
+  To use Arcade's hosted gateway and skills, [install the Arcade agent plugin](/en/get-started/agent-plugin).
+  This guide connects ChatGPT to a gateway you configure.
+</Callout>
+
+This page is for agent developers who connect ChatGPT on the web to an Arcade [MCP Gateway](/en/operate/governance/mcp-gateways).
+
+<GuideOverview>
+<GuideOverview.Outcomes>
+
+Connect ChatGPT to an Arcade MCP Gateway.
+
+</GuideOverview.Outcomes>
+
+<GuideOverview.Prerequisites>
+
+1. Create an <SignupLink linkLocation="docs:chatgpt-client">Arcade account</SignupLink>
+2. Create an [Arcade MCP Gateway](/en/operate/governance/mcp-gateways) and select the tools you want to use
+3. Set the gateway's authorization to **Arcade Auth** or a [User Source](/en/operate/identity/user-sources)
+
+</GuideOverview.Prerequisites>
+
+</GuideOverview>
+
+<Callout type="info">
+  **Production end users with their own identities?** If your end users already sign in to Entra ID, Okta, Auth0, Clerk, or another OIDC provider, configure a [User Source](/en/operate/identity/user-sources) on your gateway. Arcade redirects each end user to your identity provider on sign-in and identifies them by an OIDC subject claim.
+</Callout>
+
+ChatGPT adds a remote MCP server from **Plugins**. Workspace permissions still apply, including who can create plugins that use MCP servers. See [Add a custom MCP server](https://developers.openai.com/api/docs/guides/custom-mcp-server).
+
+<Steps>
+
+### Add the gateway
+
+1. Open [ChatGPT on the web](https://chatgpt.com) and go to **Plugins**.
+2. Select the plus button, then **Add custom MCP server**.
+3. Enter a name and, if you want, a description.
+4. Under **Connection**, enter your MCP Gateway URL:
+
+   ```text
+   https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>
+   ```
+
+   If you self-host the Arcade Engine, use your Engine hostname in place of `api.arcade.dev`.
+5. Set authentication to **OAuth** so ChatGPT runs the gateway's browser sign-in.
+6. Review the risk warning and select **I understand and want to continue**.
+7. Select **Create as a plugin**.
+
+### Install and sign in
+
+Find the plugin in your personal plugins, or in the workspace where you created it. Select **Install plugin**. Start a new chat, type `@`, and select the plugin. Sign in to Arcade in the browser when ChatGPT asks.
+
+### Try it out
+
+Ask ChatGPT to use a tool from the gateway. Name the plugin in the request when several apps could apply.
+
+</Steps>

content/docs/get-started/mcp-clients/claude-code.mdx

@@ -36,7 +36,7 @@ Connect Claude Code to an Arcade MCP Gateway.
 Run the following to add your Arcade Gateway as a remote HTTP MCP server in Claude Code:
 
 ```bash
-claude mcp add arcade --transport http "<YOUR_ARCADE_GATEWAY_URL>"
+claude mcp add --transport http arcade "<YOUR_ARCADE_GATEWAY_URL>"
 ```
 
 ### Verify the server was added

content/docs/get-started/mcp-clients/claude-desktop.mdx

@@ -7,14 +7,6 @@ import { SignupLink } from "@/components/analytics";
 import Image from "next/image";
 
 export const IMAGE_SCALE_FACTOR = 2;
-export const STEP_1_DARK_WIDTH = 582;
-export const STEP_1_DARK_HEIGHT = 966;
-export const STEP_1_LIGHT_WIDTH = 578;
-export const STEP_1_LIGHT_HEIGHT = 960;
-export const STEP_2_DARK_WIDTH = 2388;
-export const STEP_2_DARK_HEIGHT = 1242;
-export const STEP_2_LIGHT_WIDTH = 2352;
-export const STEP_2_LIGHT_HEIGHT = 1202;
 export const STEP_3_DARK_WIDTH = 1104;
 export const STEP_3_DARK_HEIGHT = 874;
 export const STEP_3_LIGHT_WIDTH = 1094;
@@ -72,51 +64,21 @@ Connect Claude Desktop to an Arcade MCP Gateway.
 
 <Steps>
 
-### Go to your Claude Desktop setting page
+### Open connectors
 
-On the bottom left corner of Claude Desktop, click on your user avatar to open the settings menu, then click on the "Settings" button.
+In Claude Desktop or on [claude.ai](https://claude.ai), open **Customize** in the sidebar, then select **Connectors**.
 
-<Image
-  alt={"Step 1: Click on the settings icon on Claude Desktop"}
-  className="max-w-full dark:hidden mt-4"
-  src={"/images/mcp-gateway/claude-desktop/step-1-light.jpg"}
-  width={STEP_1_LIGHT_WIDTH / IMAGE_SCALE_FACTOR}
-  height={STEP_1_LIGHT_HEIGHT / IMAGE_SCALE_FACTOR}
-/>
-<Image
-  alt={"Step 1: Click on the settings icon on Claude Desktop"}
-  className="hidden max-w-full dark:block mt-4"
-  src={"/images/mcp-gateway/claude-desktop/step-1.jpg"}
-  width={STEP_1_DARK_WIDTH / IMAGE_SCALE_FACTOR}
-  height={STEP_1_DARK_HEIGHT / IMAGE_SCALE_FACTOR}
-/>
-
-### Add a Custom Connector
+On a Free, Pro, or Max plan, select **+ Add**, then **Add custom connector**.
 
-On the settings page, click on the "Connectors" tab, and then on the "Add custom Connector" button.
-
-<Image
-  alt={"Step 2: Add a custom connector"}
-  className="max-w-full dark:hidden mt-4"
-  src={"/images/mcp-gateway/claude-desktop/step-2-light.jpg"}
-  width={STEP_2_LIGHT_WIDTH / IMAGE_SCALE_FACTOR}
-  height={STEP_2_LIGHT_HEIGHT / IMAGE_SCALE_FACTOR}
-/>
-<Image
-  alt={"Step 2: Add a custom connector"}
-  className="hidden max-w-full dark:block mt-4"
-  src={"/images/mcp-gateway/claude-desktop/step-2.jpg"}
-  width={STEP_2_DARK_WIDTH / IMAGE_SCALE_FACTOR}
-  height={STEP_2_DARK_HEIGHT / IMAGE_SCALE_FACTOR}
-/>
+### Enter the gateway URL
 
-A dialog opens for a name and a URL. Enter a name for your connector and your MCP Gateway URL:
+Enter a name for your connector and your MCP Gateway URL:
 
 ```
 https://api.arcade.dev/mcp/{YOUR-GATEWAY-SLUG}
 ```
 
-If you self-host the Arcade Engine, use your Engine hostname in place of `api.arcade.dev`. Then continue.
+If you self-host the Arcade Engine, use your Engine hostname in place of `api.arcade.dev`.
 
 <Image
   alt={"Step 3: Enter a name and URL for your connector"}
@@ -238,6 +200,6 @@ In this configuration pane, you can configure which tools are available to Claud
 
 ### Try it out!
 
-You can now open a new chat within Claude Desktop. Ensure that your connector is enabled, and the ask the agent to use a tool!
+You can now open a new chat in Claude Desktop or on claude.ai. Confirm that your connector is enabled, then ask Claude to use a tool.
 
 </Steps>

content/docs/get-started/mcp-clients/copilot-studio.mdx

@@ -46,10 +46,9 @@ In [Copilot Studio](https://copilotstudio.microsoft.com/), create a new agent or
 
 ### Add a new MCP tool
 
-1. Inside your agent, click the **Tools** tab in the navigation panel
-2. Click on **Add a tool**
-3. In the Add tools panel, select **Model Context Protocol**
-4. Click on **New tool** to configure a new MCP connection
+1. On your agent's **Tools** page, select **Add a tool**
+2. Select **New tool**
+3. Select **Model Context Protocol**
 
 <Image
   alt={"Step 1: Navigate to the Tools menu in Copilot Studio"}
@@ -67,7 +66,8 @@ In the Model Context Protocol configuration dialog:
 2. Add a **Server description** to help identify the tools available
 3. Enter your Arcade MCP Gateway URL in the **Server URL** field: `https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>`
 4. Under **Authentication**, select **OAuth 2.0**
-5. Under **Type**, select **Dynamic discovery** to authorize the MCP gateway automatically using OAuth
+5. Under **Type**, select **Dynamic discovery**
+6. Select **Create**, then **Next**, and create the connection when Copilot Studio asks
 
 <Image
   alt={"Step 2: Configure MCP Gateway with OAuth 2.0 and Dynamic Discovery"}
@@ -79,7 +79,7 @@ In the Model Context Protocol configuration dialog:
 
 ### Complete the authorization flow
 
-After saving the gateway configuration, you'll be redirected to the Arcade authorization page. Review the permissions requested and click **Allow** to authorize Copilot Studio to access your MCP resources.
+Arcade opens an authorization page. Review the permissions and select **Allow**.
 
 <Image
   alt={"Step 3: Authorize Copilot Studio to access your Arcade account"}

content/docs/get-started/mcp-clients/cursor.mdx

@@ -31,9 +31,10 @@ Connect Cursor to an Arcade MCP Gateway.
 </GuideOverview>
 
 <Callout type="info">
-  Cursor currently does not refresh the MCP OAuth tokens automatically. To set a
-  persistent connection between Cursor and your MCP Gateway, you should set the
-  `Authorization` field to "Arcade Headers" in the dashboard.
+  Cursor renews an expired MCP access token when the server issued a refresh
+  token. If the connection still drops after the token expires, set the
+  gateway's **Authorization** field to **Arcade Headers** and pass the headers
+  below.
 </Callout>
 
 <Callout type="info">
@@ -42,10 +43,10 @@ Connect Cursor to an Arcade MCP Gateway.
 
 ### Set up Cursor
 
-1. Open the Command Palette (`Cmd + Shift + P` on macOS, `Ctrl + Shift + P` on Windows/Linux) and select **Open MCP Settings**
-1. Click on the "New MCP Server" button
+1. Open **Customize** in the sidebar, then select **MCPs**.
+2. Select **Add New MCP Server**. Choose the HTTP transport, paste your MCP Gateway URL, and name the server. Cursor writes the entry in `mcp.json`.
 
-Cursor will open the MCP settings file, and you can add a new entry to the `mcpServers` object:
+You can also edit the file directly. Use `~/.cursor/mcp.json` for every project, or `.cursor/mcp.json` in one project. Add an entry to `mcpServers`:
 
 <Tabs items={["Arcade Auth", "Arcade Headers"]} storageKey="preferredMCPAuthMode">
 <Tabs.Tab>