# What port does the Brilliant MCP server use?

*How-to · by The Brilliant team · updated Nov 20, 2026 (2026-11-20)*

> **Short answer.** The Brilliant desktop app serves MCP at http://127.0.0.1:3333/mcp on your own machine while the app is open, and it falls back to 3334, then 3335, when 3333 is taken. A tool you checked in Settings, MCP connections follows the port on every start, so you set an address by hand only if you wrote the config yourself.

## 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.

```text title="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.

```text title="Claude Code"
claude mcp add --transport http --scope user brilliant http://127.0.0.1:3333/mcp
```

## Common problems

| Problem | Fix |
|---|---|
| A second copy of Brilliant is running | Each 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 refused | Brilliant is closed. The local server runs only while the app is open. |
| The row shows off although Brilliant is in the config | The 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

- [Use with AI agents](https://brilliant.design/docs/agents/overview)
- [Troubleshooting](https://brilliant.design/docs/workspace/troubleshooting)
- [Claude Code setup](https://brilliant.design/docs/agents/claude-code)
- [Why can't my coding agent see Brilliant's tools?](https://brilliant.design/learn/coding-agent-cant-see-brilliant)

[Open the editor](https://brilliant.design/playground)
