# Why does my browser ask for local network access when my agent connects to Brilliant?

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

> **Short answer.** The helper your agent runs lives on your own machine, and the brilliant.design tab it opens has to reach it over 127.0.0.1, which the browser allows only after you approve a one-time local network prompt. Allow it once and the tab pairs with your agent session, over a connection that stays on your machine.

## How to pair the browser canvas with your agent

### 1. Ask your agent for a design

With no Brilliant open, the first tool call opens brilliant.design in Chrome, Edge or Firefox. Listing the tools never opens anything.

```text title="Prompt"
Design a pricing page for this app in Brilliant.
```

### 2. Allow the local network prompt

The browser asks once whether brilliant.design may reach your local network. Allow it. The tab then connects to the helper on 127.0.0.1 and pairs with your agent session.

### 3. Keep the tab open

Keep it open while the agent works: the canvas the agent edits is in that tab, and you can edit the same design by hand there.

### 4. Or use the desktop app

If the Brilliant desktop app for macOS or Windows is running, the helper connects to it and opens no browser tab, so there is no prompt.

## Common problems

| Problem | Fix |
|---|---|
| You dismissed or blocked the prompt | In your browser's site settings for brilliant.design, set local network access to Allow, then ask the agent again. |
| The tab opened in Safari | Safari cannot run the browser canvas. Open the same link in Chrome, Edge or Firefox. |
| The helper runs in a container | The helper pairs over 127.0.0.1, which a container cannot reach. Run it on your own machine. |

## Questions

### What does the permission allow?

It lets the brilliant.design tab talk to the helper on 127.0.0.1, your own machine. The helper binds only 127.0.0.1 and accepts only a tab from https://brilliant.design that holds the pairing token or an association you approved.

### Does my design go to Brilliant's servers over this connection?

No. The helper and the desktop app serve MCP on your own machine. An image generated on Brilliant AI and background removal do run on Brilliant's servers when your agent calls them.

### Does the helper send telemetry?

No. The package makes no network calls of its own: no telemetry, no analytics and no update checks. The pairing link carries attribution params that say which install path was used and nothing about you or your designs.

### Do I have to allow it every time?

No. It is a one-time prompt.

### Can I avoid the prompt altogether?

Yes. Run the Brilliant desktop app, and the helper uses it and opens no tab.

## Related

- [Use with AI agents](https://brilliant.design/docs/agents/overview)
- [Security and your data](https://brilliant.design/docs/workspace/security-and-data)
- [Why can't my coding agent see Brilliant's tools?](https://brilliant.design/learn/coding-agent-cant-see-brilliant)
- [Supported clients, with each connect line](https://brilliant.design/docs/agents/clients)

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