From 2f23c7c5a2bee97c703d39e21f09689f22de8388 Mon Sep 17 00:00:00 2001 From: Joe Danziger Date: Tue, 6 Oct 2026 15:18:28 -0400 Subject: [PATCH] =?UTF-8?q?docs:=20remote=20access=20=E2=80=94=20other=20a?= =?UTF-8?q?pps,=20phone,=20Fleet=20setup,=20Allow-quickly=20note?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Claude-Session: https://claude.ai/code/session_0145uCzuUjLpe6rbH4WTf43Z --- docs/guides/remote-access.mdx | 38 +++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/docs/guides/remote-access.mdx b/docs/guides/remote-access.mdx index 1e5d61c..32e3cc5 100644 --- a/docs/guides/remote-access.mdx +++ b/docs/guides/remote-access.mdx @@ -58,22 +58,56 @@ brainkit does not run the sign-in. An identity edge in front of it does, and bra - If the sign-in page says **Invalid nonce**, it just waited too long. Click **Connect** - again. + If the sign-in page says **Invalid nonce**, the **Allow** page waited too long. Click + **Connect** again and click **Allow** straight away. +On the Claude phone app the connector appears by itself once it has been added on the web. +Open it, tap **Connect**, and sign in the same way. + Claude remembers a connector's tool list from when it was first connected. If you connected before saving notes was available, **Disconnect** and **Connect** the connector once and `brain_capture` will appear. +## Connect other apps + +Any app that supports remote MCP servers with sign-in can use the same address. Claude on the +web and phone is the one we have tested end to end. The others follow each app's own +documentation, and their menus change, so treat these as the shape of the steps. + +| App | How to add it | +|---|---| +| **Claude Code** | `claude mcp add --transport http brain
`, then `/mcp` → **brain** → **Authenticate**. | +| **Cursor** | Add `{"mcpServers": {"brain": {"url": "
"}}}` to `~/.cursor/mcp.json`, then click **Needs login**. | +| **VS Code** | In `.vscode/mcp.json`: `{"servers": {"brain": {"type": "http", "url": "
"}}}`, then **Start**. | +| **ChatGPT** | Turn on developer mode under **Settings → Connectors → Advanced** (plan-dependent), add a connector with the address and choose OAuth. | + +Every app opens the same sign-in page. Apps that need a fixed client ID instead of +registering themselves are not supported by the setup above. + +If the brain files are on the same computer as the app, `brain mcp` over stdio needs no +address and no sign-in (see [`brain mcp`](/reference/cli#brain-mcp)). It has the six read +tools only; saving notes needs the remote address. + ## What Claude can do The same six read tools as `brain mcp` (`brain_search`, `brain_read`, `brain_links`, `brain_graph`, `brain_recent`, `brain_facts`), plus **`brain_capture`**, which saves a note into your Inbox. Claude cannot edit or delete existing notes this way. +## With Fleet + +[Fleet](/guides/reference-deployment) does every step in "Set it up by hand" for you. On a +company's page, **Remote MCP → Set up** creates the tunnel, the Cloudflare Access application +and its policies, the per-person services, the route table and the cron change, then checks +each service's health. Running it again changes nothing that is already right. When someone +joins or leaves, Fleet updates the allowed emails, the route table and that person's service +in the same pass. **Disable** removes it all again. + +The address is `https://mcp-./mcp`. + ## Set it up by hand If you run brainkit without Fleet, here is every piece. You need a Cloudflare account with