From 6594f412f94d5828d9017be5fa4e10901d4bd14a Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues <44656907+Rodriguespn@users.noreply.github.com> Date: Mon, 10 Aug 2026 08:09:17 +0100 Subject: [PATCH] docs: add Warp as a supported MCP client (#48838) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds [Warp](https://www.warp.dev/) as a supported client in the Supabase MCP docs. Because [Warp speaks the native remote (Streamable HTTP) transport](https://docs.warp.dev/agents/capabilities/mcp/), the standard config connects to the hosted server directly, no `mcp-remote` proxy needed: ```json { "mcpServers": { "supabase": { "url": "https://mcp.supabase.com/mcp" } } } ``` The MCP client list is data-driven, so this single addition surfaces in the docs MCP panel, the generated markdown, and Studio's Connect panel. Concretely: registers the `warp` client (config file `~/.warp/.mcp.json`, docs link) under the IDE group, adds setup instructions (auto-load + Settings → AI → MCP Servers, automatic OAuth), and adds the official Warp logo in light and dark variants. ## What is Warp? Warp is an agentic development environment built from the terminal: a Rust-based, GPU-accelerated app that runs coding agents (Claude Code, Codex, Gemini) directly in the terminal. It has first-class MCP support with native remote (Streamable HTTP / SSE) transport and automatic OAuth (no PAT required). ## Why add support for the Supabase MCP server? Warp is a mainstream, widely-adopted client ([warpdotdev/warp](https://github.com/warpdotdev/warp) has 64k+ ⭐ on GitHub) that natively supports MCP. Documenting it lets Warp users connect the hosted Supabase MCP server with a copy-paste config, matching the coverage we already provide for Cursor, VS Code, Windsurf, and others. ## How to test 1. Run the docs app (`pnpm dev:docs`) and open the MCP guide (`apps/docs/content/guides/ai-tools/mcp.mdx`). Warp appears under **IDE** with its logo (verify both light and dark themes) and the config snippet. 2. In Warp, add the shown config to `~/.warp/.mcp.json` (or **Settings → Agents → MCP Servers → + Add**). Warp auto-spawns the `supabase` server. 4. Click **Start** on the `supabase` server → complete the Supabase OAuth in the browser → the Supabase tools load. image Verified end-to-end on Warp v0.2026.07.29 (macOS): the config auto-loads and connects over Warp's native remote transport, and the OAuth flow completes without a PAT. Refs [AI-1031](https://linear.app/supabase/issue/AI-1031/docs-add-warp-as-a-supported-mcp-client) ## Summary by CodeRabbit * **New Features** * Added Warp as a supported MCP client. * Added setup guidance for connecting remote MCP servers in Warp, including OAuth authentication and secure credential storage. * Added light and dark Warp icons to the client selection interface. --------- Co-authored-by: Claude Opus 4.8 (1M context) --- .../src/McpUrlBuilder/assets/warp-icon-dark.svg | 3 +++ .../src/McpUrlBuilder/assets/warp-icon.svg | 3 +++ .../src/McpUrlBuilder/clients.data.ts | 13 ++++++++++++- .../McpUrlBuilder/clients.instructions.md.tsx | 16 ++++++++++++++++ .../src/McpUrlBuilder/utils/mcpIconAssets.ts | 3 +++ 5 files changed, 37 insertions(+), 1 deletion(-) create mode 100644 packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon-dark.svg create mode 100644 packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon.svg diff --git a/packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon-dark.svg b/packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon-dark.svg new file mode 100644 index 00000000000..9799154c284 --- /dev/null +++ b/packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon-dark.svg @@ -0,0 +1,3 @@ + + + diff --git a/packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon.svg b/packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon.svg new file mode 100644 index 00000000000..ea1212cbc64 --- /dev/null +++ b/packages/ui-patterns/src/McpUrlBuilder/assets/warp-icon.svg @@ -0,0 +1,3 @@ + + + diff --git a/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts b/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts index f1bfecd348a..92e1378a46b 100644 --- a/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts +++ b/packages/ui-patterns/src/McpUrlBuilder/clients.data.ts @@ -240,6 +240,17 @@ export const MCP_CLIENT_DATA: McpClientData[] = [ } }, }, + { + key: 'warp', + label: 'Warp', + icon: 'warp', + hasDistinctDarkIcon: true, + configFile: '~/.warp/.mcp.json', + externalDocsUrl: 'https://docs.warp.dev/agents/capabilities/mcp', + // No transformConfig: Warp natively supports remote MCP servers and accepts + // the standard `mcpServers` config, so the base `{ mcpServers: { supabase: { url } } }` + // shape works both in `~/.warp/.mcp.json` and when pasted into Warp's "+ Add" input. + }, { key: 'goose', label: 'Goose', @@ -394,7 +405,7 @@ export const MCP_CLIENT_GROUPS = [ }, { heading: 'IDE', - keys: ['cursor', 'vscode', 'antigravity', 'kiro', 'windsurf', 'kimi'], + keys: ['cursor', 'vscode', 'antigravity', 'kiro', 'windsurf', 'kimi', 'warp'], }, ] as const diff --git a/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx b/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx index 670b09ceade..4b03205e608 100644 --- a/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx +++ b/packages/ui-patterns/src/McpUrlBuilder/clients.instructions.md.tsx @@ -203,6 +203,22 @@ export const MCP_CLIENT_INSTRUCTIONS: Record = { ), }, + warp: { + alternate: () => ( + <> + + Warp supports remote MCP servers natively, so no local proxy is needed. You can also add + the server from the UI: open the MCP servers page (Settings >{' '} + Agents > MCP Servers, or search for MCP in the + command palette), click + Add, and paste the same JSON. + + + After adding the server, Warp opens a browser window to complete the Supabase OAuth flow + and stores the credentials securely on your device. + + + ), + }, goose: { primary: ({ url }) => ( <> diff --git a/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts b/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts index cb27dd3fd29..38d5738a32a 100644 --- a/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts +++ b/packages/ui-patterns/src/McpUrlBuilder/utils/mcpIconAssets.ts @@ -21,6 +21,8 @@ import opencodeIcon from '../assets/opencode-icon.svg' import perplexityDarkIcon from '../assets/perplexity-icon-dark.svg' import perplexityIcon from '../assets/perplexity-icon.svg' import vscodeIcon from '../assets/vscode-icon.svg' +import warpDarkIcon from '../assets/warp-icon-dark.svg' +import warpIcon from '../assets/warp-icon.svg' import windsurfDarkIcon from '../assets/windsurf-icon-dark.svg' import windsurfIcon from '../assets/windsurf-icon.svg' @@ -45,6 +47,7 @@ const MCP_CLIENT_ICON_ASSETS = { opencode: { light: opencodeIcon, dark: opencodeDarkIcon }, perplexity: { light: perplexityIcon, dark: perplexityDarkIcon }, vscode: { light: vscodeIcon, dark: vscodeIcon }, + warp: { light: warpIcon, dark: warpDarkIcon }, windsurf: { light: windsurfIcon, dark: windsurfDarkIcon }, } satisfies Record