@kanbodev/mcp 1.0.4 → 1.1.0

package/docs/SETUP.md

@@ -6,9 +6,9 @@ This guide covers two ways to set up the Kanbo MCP server for use with AI assist
 
 ## Option 1: Install via npm (Recommended)
 
-The easiest way to get started. One command to authenticate, then configure your AI assistant.
+One command to authenticate and register the MCP server with your editors.
 
-### Step 1: Authenticate
+### Step 1: Login
 
 ```bash
 npx @kanbodev/mcp login
@@ -18,8 +18,9 @@ This will:
 1. Open your browser to sign in with your Kanbo account
 2. Let you select which organization to use
 3. Automatically create and store an API key
+4. **Auto-register the MCP server** with detected editors (VS Code, Cursor, Claude Desktop, Claude Code CLI)
 
-You'll see a success message when complete:
+You'll see output like:
 
 ```
   ✓ Successfully authenticated!
@@ -29,31 +30,32 @@ You'll see a success message when complete:
     API Key: kanbo_pat_a1b2...
 
   Config saved to: ~/.kanbo/config.json
+
+  MCP server registered with:
+    ✓ Registered in VS Code
+    ✓ Registered via Claude Code CLI
+
+  Reload your editor to activate the Kanbo MCP server.
 ```
 
-### Step 2: Configure Claude Desktop
+### Step 2: Reload your editor
 
-Add Kanbo to your Claude Desktop configuration:
+Reload your editor window and you're ready to go. No manual config needed.
 
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+### Re-register with new editors
 
-```json
-{
-  "mcpServers": {
-    "kanbo": {
-      "command": "npx",
-      "args": ["@kanbodev/mcp"]
-    }
-  }
-}
+If you install a new editor after logging in, run:
+
+```bash
+npx @kanbodev/mcp install
 ```
 
-That's it! Restart Claude Desktop and you can start managing your projects with AI.
+This re-detects editors and registers the MCP server where needed. It's idempotent — already-registered editors are skipped.
 
 ### Other CLI Commands
 
 ```bash
+npx @kanbodev/mcp install   # Register MCP server with detected editors
 npx @kanbodev/mcp whoami    # Check current authentication status
 npx @kanbodev/mcp logout    # Remove stored credentials
 npx @kanbodev/mcp help      # Show all available commands
@@ -127,14 +129,17 @@ This means you can:
 
 ## Using with Other AI Tools
 
+> **Note:** `npx @kanbodev/mcp login` auto-registers with VS Code, Cursor, Claude Desktop, and Claude Code CLI. The manual configs below are only needed if auto-registration didn't detect your editor.
+
 ### Cursor
 
-Add to your Cursor MCP settings:
+Add to `~/.cursor/mcp.json`:
 
 ```json
 {
-  "mcpServers": {
-    "kanbo": {
+  "servers": {
+    "kanbodev": {
+      "type": "stdio",
       "command": "npx",
       "args": ["@kanbodev/mcp"]
     }
@@ -149,7 +154,7 @@ See the full [VS Code setup guide](VSCODE.md) for native MCP support (v1.99+), C
 ### Claude Code CLI
 
 ```bash
-claude mcp add kanbo -- npx @kanbodev/mcp
+claude mcp add kanbodev -- npx @kanbodev/mcp
 ```
 
 ---
@@ -209,7 +214,8 @@ rm ~/.kanbo/config.json
 
 | Task | Command |
 |------|---------|
-| Authenticate | `npx @kanbodev/mcp login` |
+| Authenticate + register | `npx @kanbodev/mcp login` |
+| Register with editors | `npx @kanbodev/mcp install` |
 | Check status | `npx @kanbodev/mcp whoami` |
 | Logout | `npx @kanbodev/mcp logout` |
 | Start server | `npx @kanbodev/mcp` |

package/docs/VSCODE.md

@@ -4,13 +4,15 @@ Connect Kanbo to your VS Code environment and manage projects, tickets, and work
 
 ## Prerequisites
 
-**Authenticate first** (one-time setup):
+**Authenticate and register** (one-time setup):
 
 ```bash
 npx @kanbodev/mcp login
 ```
 
-This opens your browser, signs you in, and stores your credentials locally at `~/.kanbo/config.json`.
+This opens your browser, signs you in, stores your credentials, and **auto-registers the MCP server with VS Code** (writes to your user-level `mcp.json`).
+
+Reload VS Code and you're ready to go.
 
 Verify it worked:
 
@@ -22,11 +24,11 @@ npx @kanbodev/mcp whoami
 
 ## VS Code Native MCP (v1.99+)
 
-VS Code 1.99 and later has built-in MCP support through GitHub Copilot Chat. This is the simplest way to get started.
+VS Code 1.99 and later has built-in MCP support through GitHub Copilot Chat. The `login` command auto-registers at the user level, so no manual config is needed.
 
-### Workspace-level setup
+### Workspace-level setup (optional)
 
-Add to `.vscode/settings.json` in your project:
+If you prefer per-project config instead of user-level, add to `.vscode/settings.json`:
 
 ```json
 {
@@ -41,14 +43,16 @@ Add to `.vscode/settings.json` in your project:
 }
 ```
 
-### User-level setup
+### Manual user-level setup
 
-To make Kanbo available across all your projects, add the same config to your **User Settings** (JSON):
+If auto-registration didn't work, add the config to your **User Settings** (JSON):
 
 1. Open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
 2. Select **Preferences: Open User Settings (JSON)**
 3. Add the `mcp` block above
 
+Or run `npx @kanbodev/mcp install` to retry auto-registration.
+
 ### Using a manual API key
 
 If you prefer environment variables over the login flow:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanbodev/mcp",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "MCP (Model Context Protocol) server for Kanbo - AI-native project management",
   "type": "module",
   "main": "dist/index.js",