Skip to content

Commit f2b40d1

Browse files
committed
docs(mcp): correct trust fingerprint, store path, and auth UX
W1/W2: trust fingerprint covers sorted env key names (never values) with http-when-url-else-stdio type defaulting; store is ~/.corbits/trust/<repo-hash>.json keyed by first 32 hex of SHA-256 of the realpath-canonicalized root. W3: first-run auth is the mcp ! prompt-box mark plus Enter in /mcp opening the URL and auto-copying the link. W4/M1 intentionally skipped per spot-check: no root PLUGINS.md exists, and the briefed slug rule matches session/project-key.ts, not mcp/auth-store.ts.
1 parent 9f37404 commit f2b40d1

1 file changed

Lines changed: 10 additions & 6 deletions

File tree

‎docs/MCP.md‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,11 @@ disabled or overridden by a custom `exa` MCP server. Other Exa MCP tools, such a
7272
**Project trust:** When `mcpServers` comes from **local** `.corbits/settings.json`,
7373
Corbits Code does **not** spawn or connect until each server is trusted for this
7474
project. Trust is stored as a fingerprint of `{ name, type, command, args, url }`
75-
in `~/.corbits/trust/<cwd-hash>.json` (outside the repo). The TUI prompts on
75+
plus the sorted `env` key names — never values, so adding a new injected
76+
variable invalidates a prior grant. `type` defaults to `http` when `url` is set,
77+
else `stdio`. The store lives in `~/.corbits/trust/<repo-hash>.json` (outside the
78+
repo), where `<repo-hash>` is the first 32 hex characters of the SHA-256 of the
79+
realpath-canonicalized project root. The TUI prompts on
7680
first connect (trust-on-first-use). Headless runs without a trust callback
7781
**fail closed** — untrusted local servers are not connected.
7882

@@ -186,11 +190,11 @@ Because only `url` is set, `type` defaults to `http`.
186190
### Authorization on first run
187191

188192
The first time Corbits Code connects to an http server that requires auth, the TUI
189-
shows an authorization prompt listing the server and its authorize URL:
190-
191-
- The URL is rendered as a clickable hyperlink (`open in browser`) in terminals
192-
that support OSC 8.
193-
- Press **Alt+C** to copy the URL for pasting into a browser instead.
193+
marks the prompt box `mcp !` and lists the server as needing auth in `/mcp`.
194+
Focus the server in `/mcp` and press **Enter** to authorize: the authorize URL
195+
opens in the browser and the link is copied to the clipboard automatically (the
196+
copy covers SSH sessions, where the browser taking the redirect is often not
197+
this machine).
194198

195199
Complete the consent flow in the browser. A loopback callback server catches the
196200
redirect and exchanges the authorization code for tokens automatically — the

0 commit comments

Comments
 (0)