docs: extract a shared module for the agent connect snippets

The onboarding panel built the connection command inline. Move the command,
labels, and JSON config into one connect-snippets module so the upcoming docs
connect guide and the in-app onboarding draw from a single source and can never
show different instructions. Onboarding output is unchanged.

Author: guirguispierre

src/connect-snippets.ts

@@ -0,0 +1,24 @@
+// Single source of truth for how an MCP client connects to this server. Shared
+// by the /view first-run onboarding panel and the /docs connect guide so the two
+// can never drift: if they ever show different commands, that is a bug, and the
+// fix is to change it here. Verified against the real transport and auth flow:
+// /mcp speaks JSON-RPC over HTTP POST (plus SSE), implements initialize /
+// tools/list / tools/call, and advertises OAuth discovery so clients authorize
+// without a pasted token (see src/routes.ts handleMcp and README "OAuth mode").
+
+export const MCP_SERVER_LABEL = 'memoryvault';
+export const MCP_TRANSPORT_LABEL = 'HTTP (streamable)';
+export const MCP_AUTH_LABEL = 'OAuth 2.1, leave the token blank and sign in once';
+export const CLAUDE_CODE_PREFIX = 'claude mcp add --transport http ' + MCP_SERVER_LABEL;
+
+export function mcpUrlFor(origin: string): string {
+  return origin + '/mcp';
+}
+
+export function claudeCodeCommand(mcpUrl: string): string {
+  return CLAUDE_CODE_PREFIX + ' ' + mcpUrl;
+}
+
+export function mcpJsonConfig(mcpUrl: string): string {
+  return '{\n  "mcpServers": {\n    "' + MCP_SERVER_LABEL + '": {\n      "url": "' + mcpUrl + '"\n    }\n  }\n}';
+}

src/viewer/client-onboarding.ts

@@ -5,6 +5,15 @@
 // authenticated MCP path. Once a memory exists the panel collapses to a small
 // dismissible hint. Everything here uses only this brain's own origin and the
 // shared in-scope helpers (BASE, callMcpTool, loadMemories, showToast, esc).
+// The connection command/labels come from the shared connect-snippets module so
+// this panel and the /docs connect guide are guaranteed to match.
+import {
+  CLAUDE_CODE_PREFIX,
+  MCP_SERVER_LABEL,
+  MCP_TRANSPORT_LABEL,
+  MCP_AUTH_LABEL,
+} from '../connect-snippets.js';
+
 export const clientOnboarding = `
   var onboardingForceOpen = false;
   var ONBOARDING_DISMISS_KEY = 'mv_onboarding_dismissed_v1';
@@ -15,8 +24,8 @@ export const clientOnboarding = `
 
   function onboardingFullHtml() {
     var url = BASE + '/mcp';
-    var claudeCmd = 'claude mcp add --transport http memoryvault ' + url;
-    var jsonCfg = '{\\n  "mcpServers": {\\n    "memoryvault": {\\n      "url": "' + url + '"\\n    }\\n  }\\n}';
+    var claudeCmd = '${CLAUDE_CODE_PREFIX} ' + url;
+    var jsonCfg = '{\\n  "mcpServers": {\\n    "${MCP_SERVER_LABEL}": {\\n      "url": "' + url + '"\\n    }\\n  }\\n}';
     return '' +
       '<div class="ob-card">' +
         '<div class="ob-head">' +
@@ -40,8 +49,8 @@ export const clientOnboarding = `
             '<div class="ob-pane" data-pane="any" hidden>' +
               '<p class="ob-note">Add a remote MCP server with these values. This works for Codex, Cursor, and any custom client.</p>' +
               '<div class="ob-kv"><span>Server URL</span><code>' + esc(url) + '</code></div>' +
-              '<div class="ob-kv"><span>Transport</span><code>HTTP (streamable)</code></div>' +
-              '<div class="ob-kv"><span>Auth</span><code>OAuth 2.1, leave the token blank and sign in once</code></div>' +
+              '<div class="ob-kv"><span>Transport</span><code>${MCP_TRANSPORT_LABEL}</code></div>' +
+              '<div class="ob-kv"><span>Auth</span><code>${MCP_AUTH_LABEL}</code></div>' +
               '<div class="ob-row"><code class="ob-mono ob-pre">' + esc(jsonCfg) + '</code><button class="ob-copy" type="button" data-onb="copy">Copy</button></div>' +
             '</div>' +
           '</div></li>' +