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.
| Client | Connect line | Config file it writes |
|---|---|---|
| Claude Code | claude mcp add -- | ~/.claude.json |
| Cursor | npx - | ~/. |
| VS Code | npx - | mcp. |
| Codex | npx - | ~/. |
| Gemini CLI | npx - | ~/. |
| Antigravity | npx - | ~/. |
| Windsurf | npx - | ~/. |
| Zed | npx - | Zed’s settings. |
| OpenCode | npx - | ~/. |
| Amp | npx - | ~/. |
| Claude Desktop | npx - | claude_desktop_config. |
| Muse Code | Settings, MCP connections, in the desktop app | ~/. |
| ChatGPT | Add Brilliant Design from the ChatGPT app directory | None |
| Claude | Add https:// 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
claude mcp add --scope user brilliant -- npx -y @brilliant-hq/mcpRestart Claude Code to connect. If it says brilliant already exists, you are already connected. Prefer the plugin? claude plugin install brilliant- adds the MCP server plus design skills. Full guide: Claude Code setup.
Cursor
npx -y @brilliant-hq/mcp install cursorRestart Cursor to connect. Full guide: Cursor setup.
VS Code
For GitHub Copilot’s agent mode in VS Code.
npx -y @brilliant-hq/mcp install vscodeReload VS Code to connect. Full guide: GitHub Copilot setup.
Codex
For the Codex CLI and the ChatGPT desktop app, which read the same ~/..
npx -y @brilliant-hq/mcp install codexOr with Codex’s own command: codex mcp add brilliant --. Restart your Codex session to connect. Full guide: Codex setup.
Gemini CLI
npx -y @brilliant-hq/mcp install geminiOr with Gemini CLI’s own command: gemini mcp add brilliant --. Restart your Gemini CLI session to connect.
Antigravity
npx -y @brilliant-hq/mcp install antigravityRestart Antigravity to connect. Full guide: Antigravity setup.
Windsurf
Windsurf is now Devin Desktop.
npx -y @brilliant-hq/mcp install windsurfRestart Windsurf to connect. Full guide: Windsurf setup.
Zed
npx -y @brilliant-hq/mcp install zedRestart Zed to connect.
OpenCode
npx -y @brilliant-hq/mcp install opencodeRestart your OpenCode session to connect.
Amp
npx -y @brilliant-hq/mcp install ampOr with Amp’s own command: amp mcp add brilliant --. Restart Amp to connect.
Claude Desktop
npx -y @brilliant-hq/mcp install claude-desktopRestart 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.
https://brilliant.design/mcp/claudeFull guide: Claude.
Where next?
Connect through the desktop app’s checkboxes instead: Use with AI agents.
What is free and what is capped: MCP limits.
Pages for each agent: Claude Code, Cursor, Codex, Gemini CLI, VS Code, GitHub Copilot, Windsurf, Antigravity, Zed and OpenCode.