Skip to content

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.

ClientConnect lineConfig file it writes
Claude Codeclaude mcp add --scope user brilliant -- npx -y @brilliant-hq/mcp~/.claude.json
Cursornpx -y @brilliant-hq/mcp install cursor~/.cursor/mcp.json
VS Codenpx -y @brilliant-hq/mcp install vscodemcp.json in your VS Code user folder
Codexnpx -y @brilliant-hq/mcp install codex~/.codex/config.toml
Gemini CLInpx -y @brilliant-hq/mcp install gemini~/.gemini/settings.json
Antigravitynpx -y @brilliant-hq/mcp install antigravity~/.gemini/config/mcp_config.json
Windsurfnpx -y @brilliant-hq/mcp install windsurf~/.codeium/windsurf/mcp_config.json
Zednpx -y @brilliant-hq/mcp install zedZed’s settings.json
OpenCodenpx -y @brilliant-hq/mcp install opencode~/.config/opencode/opencode.json
Ampnpx -y @brilliant-hq/mcp install amp~/.config/amp/settings.json
Claude Desktopnpx -y @brilliant-hq/mcp install claude-desktopclaude_desktop_config.json
Muse CodeSettings, MCP connections, in the desktop app~/.config/muse/settings.json
ChatGPTAdd Brilliant Design from the ChatGPT app directoryNone
ClaudeAdd https://brilliant.design/mcp/claude as a custom connectorNone

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

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.

Cursor

Cursor
npx -y @brilliant-hq/mcp install cursor

Restart Cursor to connect. Full guide: Cursor setup.

VS Code

For GitHub Copilot’s agent mode in VS Code.

VS Code
npx -y @brilliant-hq/mcp install vscode

Reload VS Code to connect. Full guide: GitHub Copilot setup.

Codex

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

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.

Gemini CLI

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

Antigravity
npx -y @brilliant-hq/mcp install antigravity

Restart Antigravity to connect. Full guide: Antigravity setup.

Windsurf

Windsurf is now Devin Desktop.

Windsurf
npx -y @brilliant-hq/mcp install windsurf

Restart Windsurf to connect. Full guide: Windsurf setup.

Zed

Zed
npx -y @brilliant-hq/mcp install zed

Restart Zed to connect.

OpenCode

OpenCode
npx -y @brilliant-hq/mcp install opencode

Restart your OpenCode session to connect.

Amp

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

Claude Desktop
npx -y @brilliant-hq/mcp install claude-desktop

Restart Claude Desktop to connect. Full guide: Claude Desktop setup.

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.

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.

Connector URL
https://brilliant.design/mcp/claude

Full guide: Claude.

Where next?