@habitusnet/bc365 2.2.1 → 2.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +30 -1
  2. package/README.md +50 -7
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -2,7 +2,36 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
- ## [2.0.0] — Unreleased
5
+ ## [2.2.3] — 2026-02-20
6
+
7
+ ### Changed
8
+ - CHANGELOG backfilled for all v2.x releases
9
+
10
+ ## [2.2.2] — 2026-02-20
11
+
12
+ ### Changed
13
+ - README rewritten to reflect v2.2 — documents `claude mcp add-json` registration, skills bundle, `--scope` option, and MCP server table
14
+
15
+ ## [2.2.1] — 2026-02-20
16
+
17
+ ### Changed
18
+ - `bc365 onboard` skill sync: bundled `skills/bc-query/SKILL.md` now includes `$expand` pattern for sales/purchase order lines and invoice lines
19
+
20
+ ## [2.2.0] — 2026-02-20
21
+
22
+ ### Changed
23
+ - `bc365 onboard` now registers MCP servers via `claude mcp add-json -s local` instead of writing `.mcp.json`; servers land in `.claude/settings.local.json` (gitignored, per-user) and appear in `claude mcp list`
24
+ - New `scope` option (default: `'local'`); pass `scope: 'project'` to restore the old `.mcp.json` behaviour
25
+ - CI: `npm audit` now scoped to production dependencies (`--omit=dev`) to ignore test-tool advisories
26
+
27
+ ## [2.1.0] — 2026-02-20
28
+
29
+ ### Added
30
+ - Claude Code skill bundle: `skills/bc-query`, `skills/bc-admin`, `skills/bc-diagnose` bundled in the npm package
31
+ - `bc365 onboard` prints install hint: `claude plugin install habitusnet/bc365-skills`
32
+ - Companion plugin repo `habitusnet/bc365-skills` with sync CI (auto-opens PR on this repo when skills change)
33
+
34
+ ## [2.0.0] — 2026-02-20
6
35
 
7
36
  ### Added
8
37
  - `bc365 onboard` CLI: auto-discovers tenant, environments, companies via Entra ID device code flow, writes `.mcp.json`
package/README.md CHANGED
@@ -1,18 +1,23 @@
1
1
  # bc365 — MCP Config Manager for Business Central
2
2
 
3
- `@habitusnet/bc365` is a CLI that auto-discovers your Microsoft Dynamics 365 Business Central environments and writes `.mcp.json` for use with Claude / MCP-compatible AI tools.
3
+ `@habitusnet/bc365` is a CLI that connects Claude Code to Microsoft Dynamics 365 Business Central — auto-discovering your environments, registering MCP servers, and installing BC-aware Claude skills.
4
4
 
5
- ## v2 — Smart Onboarding
6
-
7
- Instead of manually editing `.mcp.json`, use the CLI:
5
+ ## Quick Start
8
6
 
9
7
  ```bash
10
8
  npx @habitusnet/bc365 onboard
11
9
  ```
12
10
 
13
- Sign in with your Microsoft account. The CLI discovers your tenant, environments, and companies automatically, checks your BC permissions, and writes `.mcp.json`.
11
+ Sign in with your Microsoft account. The CLI discovers your tenant, environments, and companies automatically, checks your BC permissions, and registers both MCP servers with Claude Code.
12
+
13
+ Then install the Claude Code skill bundle:
14
+
15
+ ```bash
16
+ claude plugin install habitusnet/bc365-skills
17
+ ```
14
18
 
15
19
  **Prerequisites:**
20
+ - Claude Code installed (`npm install -g @anthropic-ai/claude-code`)
16
21
  - Microsoft 365 / Azure AD account with access to Business Central
17
22
  - Business Central environment with `D365 BUS FULL ACCESS` permission set
18
23
 
@@ -30,11 +35,40 @@ Or use without installing:
30
35
  npx @habitusnet/bc365 onboard
31
36
  ```
32
37
 
38
+ ## What `bc365 onboard` Does
39
+
40
+ 1. Opens a Microsoft device code login in your browser
41
+ 2. Discovers your BC environments and companies
42
+ 3. Checks your permission sets
43
+ 4. Registers two MCP servers with Claude Code (`claude mcp add-json -s local`):
44
+ - **`bc-data`** — query and update BC data via OData (customers, items, orders, G/L entries)
45
+ - **`bc-admin`** — manage environments, apps, feature flags, and sessions
46
+
47
+ 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.
48
+
49
+ ## Claude Code Skills
50
+
51
+ After onboarding, install the companion skill bundle:
52
+
53
+ ```bash
54
+ claude plugin install habitusnet/bc365-skills
55
+ ```
56
+
57
+ This gives Claude three skills:
58
+
59
+ | Skill | Description |
60
+ |-------|-------------|
61
+ | `bc-query` | Query and update BC data — OData filters, expand for line items, pagination |
62
+ | `bc-admin` | Manage environments, apps, feature flags, sessions |
63
+ | `bc-diagnose` | Interpret BC HTTP/OData errors and suggest fixes |
64
+
65
+ Skills are also bundled in this package under `skills/` for offline use.
66
+
33
67
  ## Commands
34
68
 
35
69
  | Command | Description |
36
- |---|---|
37
- | `bc365 onboard` | Auto-discover tenant, environments, companies; write `.mcp.json` |
70
+ |---------|-------------|
71
+ | `bc365 onboard [--scope local\|project]` | Discover and register MCP servers |
38
72
  | `bc365 profiles` | List saved profiles |
39
73
  | `bc365 switch <profile>` | Switch to a saved profile |
40
74
  | `bc365 check` | Check latest npm versions of bc365 packages |
@@ -43,6 +77,15 @@ npx @habitusnet/bc365 onboard
43
77
 
44
78
  For agencies managing multiple clients, see [SETUP.md](SETUP.md#multi-tenant-usage-agencies).
45
79
 
80
+ ## MCP Servers
81
+
82
+ | Server | Package | Purpose |
83
+ |--------|---------|---------|
84
+ | `bc-data` | [`@habitusnet/mcp-business-central`](https://github.com/habitusnet/mcp-business-central) | OData read/write on BC entities |
85
+ | `bc-admin` | [`habitusnet/d365bc-admin-mcp`](https://github.com/habitusnet/d365bc-admin-mcp) | BC Admin Center API |
86
+
87
+ Both are vendored mirrors with daily upstream sync and security scanning.
88
+
46
89
  ## License
47
90
 
48
91
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@habitusnet/bc365",
3
- "version": "2.2.1",
3
+ "version": "2.2.3",
4
4
  "description": "Smart onboarding CLI and MCP config manager for Business Central",
5
5
  "type": "module",
6
6
  "bin": {