From 2a0e3f8ef0b8bf973997f93db51da85433258736 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 22 Oct 2026 15:41:10 +0000 Subject: [PATCH 1/2] Update MCP client connect steps Bring ChatGPT, Claude, Cursor, VS Code, Copilot Studio, and GitHub Copilot install steps in line with the current client UIs. Leave the Claude Code plugin install from #1259 unchanged. --- .../get-started/mcp-clients/client-titles.ts | 3 + .../mcp-clients/mcp-client-grid.tsx | 6 + .../docs/get-started/agent-plugin/index.mdx | 27 +++- .../docs/get-started/mcp-clients/chatgpt.mdx | 65 ++++++++ .../get-started/mcp-clients/claude-code.mdx | 2 +- .../mcp-clients/claude-desktop.mdx | 52 +----- .../mcp-clients/copilot-studio.mdx | 12 +- .../docs/get-started/mcp-clients/cursor.mdx | 13 +- .../mcp-clients/github-copilot.mdx | 153 ++++++++---------- .../docs/get-started/mcp-clients/index.mdx | 4 +- .../docs/get-started/mcp-clients/meta.json | 1 + .../mcp-clients/visual-studio-code.mdx | 27 ++-- 12 files changed, 200 insertions(+), 165 deletions(-) create mode 100644 content/docs/get-started/mcp-clients/chatgpt.mdx diff --git a/components/pages/get-started/mcp-clients/client-titles.ts b/components/pages/get-started/mcp-clients/client-titles.ts index 912d98d37..11a5c3e13 100644 --- a/components/pages/get-started/mcp-clients/client-titles.ts +++ b/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 = { + chatgpt: { + title: "ChatGPT", + }, "claude-code": { title: "Claude Code", }, diff --git a/components/pages/get-started/mcp-clients/mcp-client-grid.tsx b/components/pages/get-started/mcp-clients/mcp-client-grid.tsx index 72e149055..fb8e2b00b 100644 --- a/components/pages/get-started/mcp-clients/mcp-client-grid.tsx +++ b/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", diff --git a/content/docs/get-started/agent-plugin/index.mdx b/content/docs/get-started/agent-plugin/index.mdx index 28afef6f4..0d7bf29b6 100644 --- a/content/docs/get-started/agent-plugin/index.mdx +++ b/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 -- 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 Arcade account - 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 -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). + @@ -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. diff --git a/content/docs/get-started/mcp-clients/chatgpt.mdx b/content/docs/get-started/mcp-clients/chatgpt.mdx new file mode 100644 index 000000000..371d2df55 --- /dev/null +++ b/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"; + + + 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. + + +This page is for agent developers who connect ChatGPT on the web to an Arcade [MCP Gateway](/en/operate/governance/mcp-gateways). + + + + +Connect ChatGPT to an Arcade MCP Gateway. + + + + + +1. Create an Arcade account +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) + + + + + + + **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. + + +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). + + + +### 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/ + ``` + + 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. + + diff --git a/content/docs/get-started/mcp-clients/claude-code.mdx b/content/docs/get-started/mcp-clients/claude-code.mdx index f9618e4f5..02ba8200b 100644 --- a/content/docs/get-started/mcp-clients/claude-code.mdx +++ b/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 "" +claude mcp add --transport http arcade "" ``` ### Verify the server was added diff --git a/content/docs/get-started/mcp-clients/claude-desktop.mdx b/content/docs/get-started/mcp-clients/claude-desktop.mdx index 3729463c9..106aefe10 100644 --- a/content/docs/get-started/mcp-clients/claude-desktop.mdx +++ b/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. -### 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**. -{"Step -{"Step - -### 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. - -{"Step -{"Step +### 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`. {"Step diff --git a/content/docs/get-started/mcp-clients/copilot-studio.mdx b/content/docs/get-started/mcp-clients/copilot-studio.mdx index 5d297dd44..11c61f760 100644 --- a/content/docs/get-started/mcp-clients/copilot-studio.mdx +++ b/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** {"Step` 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 {"Step - 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. @@ -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`: diff --git a/content/docs/get-started/mcp-clients/github-copilot.mdx b/content/docs/get-started/mcp-clients/github-copilot.mdx index 61240cc81..67e105f80 100644 --- a/content/docs/get-started/mcp-clients/github-copilot.mdx +++ b/content/docs/get-started/mcp-clients/github-copilot.mdx @@ -9,18 +9,6 @@ import Image from "next/image"; export const IMAGE_SCALE_FACTOR = 2; export const JETBRAINS_START_WIDTH = 318; export const JETBRAINS_START_HEIGHT = 184; -export const VISUAL_STUDIO_STEP_1_WIDTH = 276; -export const VISUAL_STUDIO_STEP_1_HEIGHT = 120; -export const VISUAL_STUDIO_STEP_2_WIDTH = 1606; -export const VISUAL_STUDIO_STEP_2_HEIGHT = 270; -export const VISUAL_STUDIO_STEP_3_WIDTH = 674; -export const VISUAL_STUDIO_STEP_3_HEIGHT = 288; -export const VISUAL_STUDIO_STEP_4_WIDTH = 1070; -export const VISUAL_STUDIO_STEP_4_HEIGHT = 898; -export const VISUAL_STUDIO_STEP_5_WIDTH = 660; -export const VISUAL_STUDIO_STEP_5_HEIGHT = 362; -export const VISUAL_STUDIO_STEP_6_WIDTH = 1632; -export const VISUAL_STUDIO_STEP_6_HEIGHT = 360; To use Arcade's hosted gateway, [install the Arcade agent plugin](/en/get-started/agent-plugin). @@ -51,7 +39,7 @@ Connect GitHub Copilot to an Arcade MCP Gateway. ### Set up GitHub Copilot @@ -67,7 +55,7 @@ Connect GitHub Copilot to an Arcade MCP Gateway. 1. In the lower right corner, click the GitHub Copilot icon. 2. From the menu, select "Open Chat", make sure you are in Agent mode, then click the tools icon. - 3. A dialog will open with a list of tools. On the bottom left, click "+ Add More Tools..." + 3. A dialog will open with a list of tools. On the bottom left, select **Add MCP Tools**. 4. This will open the `mcp.json` file in the editor. In the `mcp.json` file, define your MCP servers. @@ -115,71 +103,12 @@ Connect GitHub Copilot to an Arcade MCP Gateway. In Visual Studio, - 1. In the upper right corner, click the GitHub Copilot icon. - - {"GitHub - - 2. On the bottom of the GitHub Copilot panel, click the tools icon (two wrenches). - - {"GitHub - - 3. A dialog will open with a list of tools. On the top right corner of this dialog, click the "+" icon to add a new tool. - - {"GitHub - - 4. This will open another dialog. Fill in the information for your MCP server. You will need to choose: - - **Destination**: The path to the MCP configuration file, if you choose "Global", the MCP gateway will be added to all solutions. If you choose "Solution", the MCP gateway will be added to the current solution only. - - **Server ID**: The ID of the MCP server you're adding, this is how it will be displayed in the list of servers. - - **Type**: For MCP gateways, you must select "HTTP". - - **URL**: The URL of the MCP gateway. - - **Headers**: The headers to pass to the MCP gateway. - - Click "Save" to add the MCP server. - - {"GitHub - - 5. Once you save the MCP server, it will be added to the list of servers. It will be disabled by default. To enable it, click the checkbox next to the server name. - - {"GitHub - - 6. Once the server is enabled, it will be available in the list of tools. If tools are not available, you may need to open the `.mcp.json` file you picked as the destination. Visual Studio will display a "Configure" and "Reconnect" buttons on top of each entry. Clicking "Reconnect" should fix any issues. - - {"GitHub + 1. In the menu bar, select **View**, then **GitHub Copilot Chat**. + 2. At the bottom of the chat panel, select **Agent**. + 3. Select the tools icon, then the plus icon in the tool picker. + 4. In **Configure MCP server**, set **Server ID** (for example, `mcp-arcade`), set **Type** to **HTTP/SSE**, and paste your MCP Gateway URL. For **Arcade Headers**, add `Authorization` and `Arcade-User-ID` under **Headers**, then select **Save**. + + The saved entry uses `requestInit` for those headers: @@ -189,9 +118,11 @@ Connect GitHub Copilot to an Arcade MCP Gateway. "servers": { "mcp-arcade": { "url": "https://api.arcade.dev/mcp/", - "headers": { - "Authorization": "Bearer {arcade_api_key}", - "Arcade-User-ID": "{arcade_user_id}" + "requestInit": { + "headers": { + "Authorization": "Bearer {arcade_api_key}", + "Arcade-User-ID": "{arcade_user_id}" + } } } } @@ -206,15 +137,65 @@ Connect GitHub Copilot to an Arcade MCP Gateway. - Coming soon... + + Use **Arcade Headers** for this setup. GitHub's Copilot docs show an OAuth sign-in only for GitHub's own MCP server. + + + 1. Select the Copilot icon in the status bar at the bottom of Eclipse. + 2. Select **Open Chat**, then **Configure Tools...**. You can also select **Edit preferences**, expand **GitHub Copilot**, and select **MCP**. + 3. Under **Server Configurations**, add the gateway and select **Apply**: + + ```json + { + "servers": { + "mcp-arcade": { + "url": "https://api.arcade.dev/mcp/", + "requestInit": { + "headers": { + "Authorization": "Bearer {arcade_api_key}", + "Arcade-User-ID": "{arcade_user_id}" + } + } + } + } + } + ``` + + Set the gateway's **Authorization** field to **Arcade Headers** in the dashboard. + - Coming soon... + + Use **Arcade Headers** for this setup. GitHub's Copilot docs show an OAuth sign-in only for GitHub's own MCP server. + + + 1. Open **GitHub Copilot for Xcode** settings. In an Xcode workspace, select **Editor → GitHub Copilot → Open GitHub Copilot for Xcode Settings**. + 2. Select the **MCP** tab, then **Edit Config**. + 3. Add the gateway: + + ```json + { + "servers": { + "mcp-arcade": { + "url": "https://api.arcade.dev/mcp/", + "requestInit": { + "headers": { + "Authorization": "Bearer {arcade_api_key}", + "Arcade-User-ID": "{arcade_user_id}" + } + } + } + } + } + ``` + + Set the gateway's **Authorization** field to **Arcade Headers** in the dashboard. + ### Try it out -1. Open the chat pane (typically command-l on MacOS) -1. Make sure you are in **Agent** mode +1. Open the chat pane. +1. Make sure you are in **Agent** mode. 1. Ask the agent to use a tool. diff --git a/content/docs/get-started/mcp-clients/index.mdx b/content/docs/get-started/mcp-clients/index.mdx index 5f25a7a05..4444b179e 100644 --- a/content/docs/get-started/mcp-clients/index.mdx +++ b/content/docs/get-started/mcp-clients/index.mdx @@ -1,14 +1,14 @@ --- title: Connect to MCP Clients sidebarTitle: Overview -description: Learn how to connect Cursor, Claude Desktop, Claude Code, VS Code, GitHub Copilot, and Copilot Studio to Arcade MCP Gateways over Streamable HTTP. +description: Learn how to connect ChatGPT, Cursor, Claude Desktop, Claude Code, VS Code, GitHub Copilot, and Copilot Studio to Arcade MCP Gateways over Streamable HTTP. --- import { MCPClientGrid } from "@/components/pages/get-started/mcp-clients/mcp-client-grid"; You can connect [Arcade MCP servers](/en/resources/integrations) to MCP-compatible clients and development environments to unlock powerful flows for your agents. -Every supported MCP client, including Cursor, Claude Desktop, Claude Code, VS Code, GitHub Copilot, and Copilot Studio, connects to an Arcade [MCP Gateway](/en/operate/governance/mcp-gateways) over the Streamable HTTP transport. The gateway decides which tools the client can call: pick from Arcade-hosted toolkits (GitHub, Linear, Gmail, Slack, Google Calendar, Notion, Jira, Confluence, and dozens more in the [integrations catalog](/en/resources/integrations)), from [remote MCP servers](/en/operate/governance/remote-mcp-servers) you registered, and from your own [custom MCP servers](/en/build/create-tools/tool-basics/build-mcp-server) hosted with [Arcade Deploy](/en/build/arcade-deploy). +Every supported MCP client, including ChatGPT, Cursor, Claude Desktop, Claude Code, VS Code, GitHub Copilot, and Copilot Studio, connects to an Arcade [MCP Gateway](/en/operate/governance/mcp-gateways) over the Streamable HTTP transport. The gateway decides which tools the client can call: pick from Arcade-hosted toolkits (GitHub, Linear, Gmail, Slack, Google Calendar, Notion, Jira, Confluence, and dozens more in the [integrations catalog](/en/resources/integrations)), from [remote MCP servers](/en/operate/governance/remote-mcp-servers) you registered, and from your own [custom MCP servers](/en/build/create-tools/tool-basics/build-mcp-server) hosted with [Arcade Deploy](/en/build/arcade-deploy). diff --git a/content/docs/get-started/mcp-clients/meta.json b/content/docs/get-started/mcp-clients/meta.json index 46d3408d7..15bd6f81e 100644 --- a/content/docs/get-started/mcp-clients/meta.json +++ b/content/docs/get-started/mcp-clients/meta.json @@ -2,6 +2,7 @@ "title": "MCP Clients", "pages": [ "index", + "chatgpt", "cursor", "claude-desktop", "claude-code", diff --git a/content/docs/get-started/mcp-clients/visual-studio-code.mdx b/content/docs/get-started/mcp-clients/visual-studio-code.mdx index 4e14afc6c..1cce1d998 100644 --- a/content/docs/get-started/mcp-clients/visual-studio-code.mdx +++ b/content/docs/get-started/mcp-clients/visual-studio-code.mdx @@ -26,28 +26,29 @@ In this guide, you'll learn how to connect Visual Studio Code to an Arcade MCP G ### Set up Visual Studio Code 3. Download and open [Visual Studio Code](https://code.visualstudio.com/download) (version 1.107.0 or higher) -4. Open the command palette and select **MCP: Add Server...** -5. Choose **HTTP** -6. Paste the URL of your MCP Gateway. -7. Give your MCP server a name, like `mcp-arcade` +4. Open the command palette and run **MCP: Add Server...** +5. Choose **HTTP (HTTP or Server-Sent Events)** +6. Paste the URL of your MCP Gateway +7. Enter a server ID, such as `mcp-arcade` +8. For a personal setup, select **Global**, then **Copilot Global** when that option appears. To share the server with a project, choose the workspace destination instead -Visual Studio Code will update your `mcp.json` file. +Visual Studio Code writes the server to `mcp.json`. ### Start the MCP Server in Visual Studio Code -8. In the `mcp.json` file or in the "Extensions" > "MCP Servers - Installed" pane, click the "Start" button next to your MCP server. -9. Visual Studio Code will prompt you to authenticate, and you may see a prompt about opening an external site: `cloud.arcade.dev`. You can safely allow both of these. -10. If you see an Arcade login screen, authenticate with your Arcade account. -11. You should see an Arcade consent screen asking you to authorize Visual Studio Code to access your Arcade account. Click "Allow" to continue. -12. You should then see a webpage from Visual Studio Code saying the sign in was successful. You may see a prompt from your browser to open a link in Visual Studio Code. You can safely allow this. +9. Run **MCP: List Servers**, select the server, and choose **Start**. You can also start it from the `mcp.json` editor, or from **Chat: Open Customizations → MCP Servers**. +10. Visual Studio Code will prompt you to authenticate, and you may see a prompt about opening an external site: `cloud.arcade.dev`. You can safely allow both of these. +11. If you see an Arcade login screen, authenticate with your Arcade account. +12. You should see an Arcade consent screen asking you to authorize Visual Studio Code to access your Arcade account. Click "Allow" to continue. +13. You should then see a webpage from Visual Studio Code saying the sign in was successful. You may see a prompt from your browser to open a link in Visual Studio Code. You can safely allow this. Your MCP Server should now be running and you can use it in Visual Studio Code. ### Try it out -13. Open your IDE's chat pane. -14. Make sure you are in **Agent** mode -15. Ask the agent to use a tool! +14. Open your IDE's chat pane. +15. Make sure you are in **Agent** mode +16. Ask the agent to use a tool! From 99a6da85f340b4889f9533a88cbb141a0e2faa7e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 22 Oct 2026 15:42:13 +0000 Subject: [PATCH 2/2] =?UTF-8?q?=F0=9F=A4=96=20Regenerate=20LLMs.txt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- public/llms.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/public/llms.txt b/public/llms.txt index ac9cd1fe6..605dd85c4 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -1,4 +1,4 @@ - + # Arcade @@ -185,6 +185,7 @@ Arcade docs serve two audiences. Start with the path that matches your goal: - [Tools](https://docs.arcade.dev/en/resources/tools): Arcade provides a comprehensive ecosystem of AI tools that enable agents to take real-world actions, offering both a catalog of thousands of pre-built integrations for popular services and the ability to create custom tools using their development framework. The page guides users on how to explore existing tools, build their own, contribute to the community, and highlights key features like built-in authentication, production-ready status, and universal compatibility with any LLM or agent framework. - [Types of Tools](https://docs.arcade.dev/en/build/create-tools/improve/types-of-tools): Arcade offers two types of tools—Optimized and Unoptimized—that work seamlessly together but differ in design approach. Optimized tools are carefully designed to match AI chat interfaces and undergo evaluation to ensure reliability, while Unoptimized tools mirror original HTTP endpoints and require more careful evaluation before production use. Both types have identical interfaces and can be used interchangeably through the Arcade Dashboard or SDK. - [Understanding `Context` and tools](https://docs.arcade.dev/en/build/create-tools/tool-basics/runtime-data-access): The `Context` class provides tools with access to both runtime capabilities and tool-specific data, such as OAuth tokens, secrets, and user information, as well as features like logging, LLM sampling, user elicitation, and progress reporting. This guide explains how to use the `Context` object that is automatically passed to tools to securely access authentication credentials and leverage runtime features during tool execution. +- [Use Arcade in ChatGPT](https://docs.arcade.dev/en/get-started/mcp-clients/chatgpt): This guide shows agent developers how to connect ChatGPT to an Arcade MCP Gateway by adding it as a custom MCP server through ChatGPT's plugins interface. After setting up an Arcade account and configuring an MCP Gateway with desired tools and authentication, users add the gateway URL to ChatGPT's custom MCP server settings and authenticate via OAuth. Once installed, users can then ask ChatGPT to execute tools from the connected gateway. - [Use Arcade in Claude Code](https://docs.arcade.dev/en/get-started/mcp-clients/claude-code): This guide shows you how to connect Claude Code to an Arcade MCP Gateway so that Claude can access tools you've configured in Arcade. You'll need an Arcade account and a pre-configured MCP Gateway, then add the gateway as a remote HTTP server in Claude Code using a simple command. - [Use Arcade in Claude Desktop](https://docs.arcade.dev/en/get-started/mcp-clients/claude-desktop): This documentation page guides users through connecting Claude Desktop to an Arcade MCP Gateway to access integrated tools and services. It provides step-by-step instructions for configuring the connection, including prerequisites like creating an Arcade account and API key, and setting up authentication through the Claude Desktop settings interface. - [Use Arcade in Cursor](https://docs.arcade.dev/en/get-started/mcp-clients/cursor): This guide explains how to connect Cursor to an Arcade MCP Gateway so that Cursor's agent can access and use tools like GitHub, Linear, Gmail, and Slack through a streamable HTTP connection. Users configure the connection in Cursor's MCP settings, then control which specific tools are available by managing the gateway's allowed tools list on the Arcade dashboard.