Skip to content

What port does the Brilliant MCP server use?

How to fix a connection after the port changed

  1. Find the live address

    Open Settings (Cmd+, on macOS, Ctrl+, on Windows) and choose MCP connections. The live endpoint is at the bottom of the page.

    Default local endpoint

    http://127.0.0.1:3333/mcp
  2. Check your tool's row

    A checked tool follows Brilliant's port on every start. If the row reads as off after a hand edit, or after a fallback to 3334 or 3335, toggle it on to rewrite the entry.

  3. Restart the tool

    Most tools load MCP servers at startup, so the new address takes effect in a new session.

  4. Or set the address by hand

    In Claude Code, add the server by its address. Replace 3333 with the port MCP connections shows.

    Claude Code

    claude mcp add --transport http --scope user brilliant http://127.0.0.1:3333/mcp

Common problems

ProblemFix
A second copy of Brilliant is runningEach instance gets its own address. The second copy leaves your config entries alone, and its row reads Another Brilliant instance owns this config until you check it there.
The connection is refusedBrilliant is closed. The local server runs only while the app is open.
The row shows off although Brilliant is in the configThe check means the config points at Brilliant's current address. Toggle it on to rewrite the entry, then restart the tool.

Questions

Can other machines reach that port?

No. The server listens on 127.0.0.1, which is your own machine only.

Does the npx helper use port 3333?

The helper looks for the desktop app on 127.0.0.1 ports 3333 to 3335 and uses it when it is running. Otherwise it pairs with a brilliant.design tab in your browser.

Do I change the port in my config after a restart?

No, if you connected through Settings, MCP connections. A checked tool follows the port on every start.

Is there an address with no port at all?

Yes. https://brilliant.design/mcp is a hosted MCP server with no install and no account. Each design comes back as a link you open in a browser.

Which address do I paste into a config by hand?

http://127.0.0.1:3333/mcp, or the port MCP connections shows. Claude Code and VS Code also need type set to http beside the url.

Related