---
title: Supported clients
seoTitle: Every MCP client that works with Brilliant
description: Every AI client that connects to Brilliant over MCP, with the exact line to connect each one: Claude Code, Cursor, VS Code, Codex, Gemini CLI, Antigravity, Windsurf, Zed, OpenCode, Amp, Claude Desktop, ChatGPT and Claude.
section: agents
order: 10
featured: false
related: agents/overview, agents/limits, /claude-code, /cursor, /codex
---

# Supported clients

Every client below connects to Brilliant over MCP. For a coding agent, one line does it: the helper writes Brilliant into the client's own config file, and your other servers stay as they are. It needs Node 20 or later and no API key. The first tool call opens brilliant.design in Chrome, Edge or Firefox and pairs with it, or uses the Brilliant desktop app when it is running. Canvas work is free and unlimited on every plan; see [MCP limits](/docs/agents/limits).

| Client | Connect line | Config file it writes |
|---|---|---|
| [Claude Code](#claude-code) | `claude mcp add --scope user brilliant -- npx -y @brilliant-hq/mcp` | `~/.claude.json` |
| [Cursor](#cursor) | `npx -y @brilliant-hq/mcp install cursor` | `~/.cursor/mcp.json` |
| [VS Code](#vs-code) | `npx -y @brilliant-hq/mcp install vscode` | mcp.json in your VS Code user folder |
| [Codex](#codex) | `npx -y @brilliant-hq/mcp install codex` | `~/.codex/config.toml` |
| [Gemini CLI](#gemini-cli) | `npx -y @brilliant-hq/mcp install gemini` | `~/.gemini/settings.json` |
| [Antigravity](#antigravity) | `npx -y @brilliant-hq/mcp install antigravity` | `~/.gemini/config/mcp_config.json` |
| [Windsurf](#windsurf) | `npx -y @brilliant-hq/mcp install windsurf` | `~/.codeium/windsurf/mcp_config.json` |
| [Zed](#zed) | `npx -y @brilliant-hq/mcp install zed` | Zed's settings.json |
| [OpenCode](#opencode) | `npx -y @brilliant-hq/mcp install opencode` | `~/.config/opencode/opencode.json` |
| [Amp](#amp) | `npx -y @brilliant-hq/mcp install amp` | `~/.config/amp/settings.json` |
| [Claude Desktop](#claude-desktop) | `npx -y @brilliant-hq/mcp install claude-desktop` | claude_desktop_config.json |
| [Muse Code](#muse-code) | Settings, MCP connections, in the desktop app | `~/.config/muse/settings.json` |
| [ChatGPT](#chatgpt) | Add Brilliant Design from the ChatGPT app directory | None |
| [Claude](#claude) | Add `https://brilliant.design/mcp/claude` as a custom connector | None |

On Windows, `~` is your user folder, `%USERPROFILE%`. Add `--dry-run` to any install line to preview the change, or `--remove` to take it out again.

## Claude Code

```text title="Claude Code"
claude mcp add --scope user brilliant -- npx -y @brilliant-hq/mcp
```

Restart Claude Code to connect. If it says brilliant already exists, you are already connected. Prefer the plugin? `claude plugin install brilliant-design --marketplace brilliant-hq/brilliant-mcp` adds the MCP server plus design skills. Full guide: [Claude Code setup](/docs/agents/claude-code).

## Cursor

```text title="Cursor"
npx -y @brilliant-hq/mcp install cursor
```

Restart Cursor to connect. Full guide: [Cursor setup](/docs/agents/cursor).

## VS Code

For GitHub Copilot's agent mode in VS Code.

```text title="VS Code"
npx -y @brilliant-hq/mcp install vscode
```

Reload VS Code to connect. Full guide: [GitHub Copilot setup](/docs/agents/copilot).

## Codex

For the Codex CLI and the ChatGPT desktop app, which read the same `~/.codex/config.toml`.

```text title="Codex"
npx -y @brilliant-hq/mcp install codex
```

Or with Codex's own command: `codex mcp add brilliant -- npx -y @brilliant-hq/mcp`. Restart your Codex session to connect. Full guide: [Codex setup](/docs/agents/codex).

## Gemini CLI

```text title="Gemini CLI"
npx -y @brilliant-hq/mcp install gemini
```

Or with Gemini CLI's own command: `gemini mcp add brilliant -- npx -y @brilliant-hq/mcp`. Restart your Gemini CLI session to connect.

## Antigravity

```text title="Antigravity"
npx -y @brilliant-hq/mcp install antigravity
```

Restart Antigravity to connect. Full guide: [Antigravity setup](/docs/agents/antigravity).

## Windsurf

Windsurf is now Devin Desktop.

```text title="Windsurf"
npx -y @brilliant-hq/mcp install windsurf
```

Restart Windsurf to connect. Full guide: [Windsurf setup](/docs/agents/windsurf).

## Zed

```text title="Zed"
npx -y @brilliant-hq/mcp install zed
```

Restart Zed to connect.

## OpenCode

```text title="OpenCode"
npx -y @brilliant-hq/mcp install opencode
```

Restart your OpenCode session to connect.

## Amp

```text title="Amp"
npx -y @brilliant-hq/mcp install amp
```

Or with Amp's own command: `amp mcp add brilliant -- npx -y @brilliant-hq/mcp`. Restart Amp to connect.

## Claude Desktop

```text title="Claude Desktop"
npx -y @brilliant-hq/mcp install claude-desktop
```

Restart Claude Desktop to connect. Full guide: [Claude Desktop setup](/docs/agents/claude-desktop).

## Muse Code

Muse Code connects to the Brilliant desktop app only. Open Settings, MCP connections, check Muse Code, then restart your muse session.

## ChatGPT

No config file. Brilliant is in the ChatGPT app directory as Brilliant Design: add it, then type @Brilliant Design or name it in your request. See [Brilliant for ChatGPT](/chatgpt).

## Claude

For Claude on the web, in the desktop app and on mobile, with no local setup. Add this URL as a custom connector and choose No sign in.

```text title="Connector URL"
https://brilliant.design/mcp/claude
```

Full guide: [Claude](/docs/agents/claude).

## Where next?

- Connect through the desktop app's checkboxes instead: [Use with AI agents](/docs/agents/overview).
- What is free and what is capped: [MCP limits](/docs/agents/limits).
- Pages for each agent: [Claude Code](/claude-code), [Cursor](/cursor), [Codex](/codex), [Gemini CLI](/gemini-cli), [VS Code](/vscode), [GitHub Copilot](/copilot), [Windsurf](/windsurf), [Antigravity](/antigravity), [Zed](/zed) and [OpenCode](/opencode).
