@habitusnet/bc365 2.2.3 → 2.2.5

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.2.5] — 2026-02-20
+
+### Changed
+- README: documents `--scope` flag with reference table and examples for `onboard` and `switch`
+
+## [2.2.4] — 2026-02-20
+
+### Fixed
+- `bc365 onboard --help` now shows `--scope` instead of the removed `--output` flag
+- `bc365 switch` now re-registers MCP servers via `claude mcp add-json -s <scope>` instead of writing `.mcp.json`; accepts the same `--scope` option as `onboard`
+
 ## [2.2.3] — 2026-02-20
 
 ### Changed

package/README.md

@@ -44,7 +44,20 @@ npx @habitusnet/bc365 onboard
    - **`bc-data`** — query and update BC data via OData (customers, items, orders, G/L entries)
    - **`bc-admin`** — manage environments, apps, feature flags, and sessions
 
-Servers are registered at local scope (`.claude/settings.local.json`, gitignored and per-user). Run with `--scope project` to write a shared `.mcp.json` instead.
+Servers are registered at local scope (`.claude/settings.local.json`, gitignored and per-user). Pass `--scope` to override:
+
+| Scope | Stored in | Use when |
+|-------|-----------|----------|
+| `local` (default) | `.claude/settings.local.json` | Per-user, gitignored — recommended |
+| `user` | `~/.claude.json` | All projects for this user |
+| `project` | `.mcp.json` | Shared team config, committed to git |
+
+```bash
+bc365 onboard                        # local scope (default)
+bc365 onboard --scope project        # writes .mcp.json
+bc365 switch habitusnet-prod         # re-register saved profile at local scope
+bc365 switch habitusnet-prod --scope user  # re-register at user scope
+```
 
 ## Claude Code Skills
 
@@ -68,9 +81,9 @@ Skills are also bundled in this package under `skills/` for offline use.
 
 | Command | Description |
 |---------|-------------|
-| `bc365 onboard [--scope local\|project]` | Discover and register MCP servers |
+| `bc365 onboard [-s local\|user\|project]` | Discover and register MCP servers |
+| `bc365 switch <profile> [-s local\|user\|project]` | Re-register servers from a saved profile |
 | `bc365 profiles` | List saved profiles |
-| `bc365 switch <profile>` | Switch to a saved profile |
 | `bc365 check` | Check latest npm versions of bc365 packages |
 
 ## Multi-Tenant Usage

package/lib/cli.js

@@ -17,13 +17,13 @@ program
 
 program
   .command('onboard')
-  .description('Auto-discover tenant/environment/company and write .mcp.json')
+  .description('Auto-discover tenant/environment/company and register MCP servers with Claude Code')
   .option('-t, --tenant-id <id>', 'Azure AD tenant ID (skip Graph lookup)')
-  .option('-o, --output <path>', 'Output path for .mcp.json', '.mcp.json')
+  .option('-s, --scope <scope>', 'Configuration scope: local, user, or project (default: local)', 'local')
   .option('-p, --profile <name>', 'Profile name to save (default: tenantId/envName)')
   .action(async (opts) => {
     try {
-      await onboard({ tenantId: opts.tenantId, output: opts.output, profileName: opts.profile });
+      await onboard({ tenantId: opts.tenantId, scope: opts.scope, profileName: opts.profile });
     } catch (err) {
       console.error(chalk.red(`✗ ${err.message}`));
       process.exit(1);
@@ -32,8 +32,8 @@ program
 
 program
   .command('switch <profile>')
-  .description('Switch active profile (writes .mcp.json from saved profile)')
-  .option('-o, --output <path>', 'Output path', '.mcp.json')
+  .description('Switch active profile (re-registers MCP servers from saved profile)')
+  .option('-s, --scope <scope>', 'Configuration scope: local, user, or project (default: local)', 'local')
   .action(async (profileName, opts) => {
     try {
       const profile = await loadProfile(profileName);
@@ -41,11 +41,15 @@ program
         console.error(chalk.red(`✗ Profile '${profileName}' not found. Run 'bc365 onboard' first.`));
         process.exit(1);
       }
-      const { writeFile } = await import('node:fs/promises');
+      const { execFile: _execFile } = await import('node:child_process');
+      const { promisify } = await import('node:util');
+      const execFile = promisify(_execFile);
       const { buildMcpConfig } = await import('./onboard.js');
       const config = buildMcpConfig(profile);
-      await writeFile(opts.output, JSON.stringify(config, null, 2), 'utf8');
-      console.log(chalk.green(`✓ Switched to profile '${profileName}'`));
+      for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
+        await execFile('claude', ['mcp', 'add-json', '-s', opts.scope, name, JSON.stringify(serverConfig)]);
+      }
+      console.log(chalk.green(`✓ Switched to profile '${profileName}' (scope: ${opts.scope})`));
     } catch (err) {
       console.error(chalk.red(`✗ ${err.message}`));
       process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@habitusnet/bc365",
-  "version": "2.2.3",
+  "version": "2.2.5",
   "description": "Smart onboarding CLI and MCP config manager for Business Central",
   "type": "module",
   "bin": {