@kanbodev/mcp 1.1.6 → 1.1.8

package/README.md

@@ -3,7 +3,9 @@
 [![npm version](https://img.shields.io/npm/v/@kanbodev/mcp.svg)](https://www.npmjs.com/package/@kanbodev/mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-AI-native project management via [Model Context Protocol](https://modelcontextprotocol.io). Connect your AI assistant (Claude, Cursor, VS Code, Claude Code) to Kanbo and manage tickets, projects, releases, and workflows through natural conversation.
+AI-native project management via [Model Context Protocol](https://modelcontextprotocol.io). Connect your AI assistant (VS Code, Cursor, Windsurf, Claude Code, Claude Desktop) to [Kanbo](https://www.kanbo.dev/) and manage tickets, projects, releases, and workflows through natural conversation.
+
+[Try the demo](https://www.kanbo.dev/demo) | [See a live project](https://hub.kanbo.dev/dev/default)
 
 ## Quick Setup
 
@@ -15,7 +17,7 @@ That's it. This single command will:
 
 1. Open your browser to sign in and select your organization
 2. Store credentials locally at `~/.kanbo/config.json`
-3. **Auto-register the MCP server** with detected editors (VS Code, Cursor, Claude Desktop, Claude Code CLI)
+3. **Auto-register the MCP server** with detected editors (VS Code, VS Code Insiders, Cursor, Windsurf, Claude Code, Claude Desktop, Claude Code CLI)
 
 Reload your editor and start using Kanbo tools immediately.
 
@@ -29,7 +31,71 @@ npx @kanbodev/mcp install
 
 ### Manual setup
 
-If auto-registration doesn't detect your editor, add the MCP server config manually. See [docs/SETUP.md](docs/SETUP.md) for manual API key setup, per-editor config snippets, and troubleshooting. See [docs/VSCODE.md](docs/VSCODE.md) for detailed VS Code setup.
+If auto-registration doesn't detect your editor, add the config manually:
+
+**VS Code / VS Code Insiders / Cursor** — add to `mcp.json`:
+
+```json
+{
+  "servers": {
+    "kanbodev": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@kanbodev/mcp"]
+    }
+  }
+}
+```
+
+**Claude Desktop / Windsurf / Claude Code** — add to config with `mcpServers` key:
+
+```json
+{
+  "mcpServers": {
+    "kanbodev": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@kanbodev/mcp"]
+    }
+  }
+}
+```
+
+**Claude Code CLI:**
+
+```bash
+claude mcp add kanbodev -- npx @kanbodev/mcp
+```
+
+<details>
+<summary>Config file locations</summary>
+
+| Editor | Config Path |
+|--------|-------------|
+| VS Code | `~/Library/Application Support/Code/User/mcp.json` (macOS) / `%APPDATA%\Code\User\mcp.json` (Windows) |
+| VS Code Insiders | `~/Library/Application Support/Code - Insiders/User/mcp.json` (macOS) / `%APPDATA%\Code - Insiders\User\mcp.json` (Windows) |
+| Cursor | `~/.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| Claude Code | `~/.claude/settings.json` |
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) / `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
+
+</details>
+
+### Manual API key setup
+
+If you prefer environment variables over the login flow:
+
+1. Go to your Kanbo dashboard → **Settings → API Keys**
+2. Create a new key and copy the token
+3. Add `"env": { "KANBO_API_KEY": "kanbo_pat_..." }` to your editor's MCP config
+
+### Environment variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KANBO_API_KEY` | Personal Access Token (overrides config file) | from `~/.kanbo/config.json` |
+| `KANBO_API_URL` | API server URL | `https://api.kanbo.dev` |
+| `KANBO_WEB_URL` | Web app URL for login | `https://kanbo.dev` |
 
 ---
 
@@ -245,6 +311,13 @@ npx @kanbodev/mcp help     # Show help
 npx @kanbodev/mcp version  # Show version
 ```
 
+## Links
+
+- [Kanbo Website](https://www.kanbo.dev/)
+- [Interactive Demo](https://www.kanbo.dev/demo)
+- [Public Project Hub](https://hub.kanbo.dev/dev/default)
+- [npm Package](https://www.npmjs.com/package/@kanbodev/mcp)
+
 ## License
 
 MIT

package/dist/index.js

@@ -227,7 +227,7 @@ var init_constants = __esm(() => {
   };
   SERVER_INFO = {
     name: "kanbo-mcp",
-    version: "1.1.6",
+    version: "1.1.8",
     description: "MCP server for Kanbo project management"
   };
   PAT_CONFIG = {
@@ -15891,9 +15891,26 @@ function getVscodeMcpPath() {
   }
   return path3.join(os3.homedir(), ".config", "Code", "User", "mcp.json");
 }
+function getVscodeInsidersMcpPath() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    return path3.join(os3.homedir(), "Library", "Application Support", "Code - Insiders", "User", "mcp.json");
+  }
+  if (platform === "win32") {
+    const appData = process.env.APPDATA || path3.join(os3.homedir(), "AppData", "Roaming");
+    return path3.join(appData, "Code - Insiders", "User", "mcp.json");
+  }
+  return path3.join(os3.homedir(), ".config", "Code - Insiders", "User", "mcp.json");
+}
 function getCursorMcpPath() {
   return path3.join(os3.homedir(), ".cursor", "mcp.json");
 }
+function getWindsurfMcpPath() {
+  return path3.join(os3.homedir(), ".codeium", "windsurf", "mcp_config.json");
+}
+function getClaudeCodeSettingsPath() {
+  return path3.join(os3.homedir(), ".claude", "settings.json");
+}
 function getClaudeDesktopMcpPath() {
   const platform = process.platform;
   if (platform === "darwin") {
@@ -15913,8 +15930,14 @@ function registerInConfigFile(configPath, hostName, serversKey = "servers") {
     }
     let config3 = {};
     if (fs3.existsSync(configPath)) {
-      const content = fs3.readFileSync(configPath, "utf-8");
-      config3 = JSON.parse(content);
+      try {
+        const content = fs3.readFileSync(configPath, "utf-8");
+        config3 = JSON.parse(content);
+      } catch {
+        const backupPath = configPath + ".backup";
+        fs3.copyFileSync(configPath, backupPath);
+        config3 = {};
+      }
     }
     const servers = config3[serversKey] || {};
     if (servers[SERVER_NAME]) {
@@ -15969,7 +15992,10 @@ function registerWithClaudeCli() {
 function registerMcpServer() {
   const results = [];
   results.push(registerInConfigFile(getVscodeMcpPath(), "VS Code"));
+  results.push(registerInConfigFile(getVscodeInsidersMcpPath(), "VS Code Insiders"));
   results.push(registerInConfigFile(getCursorMcpPath(), "Cursor"));
+  results.push(registerInConfigFile(getWindsurfMcpPath(), "Windsurf", "mcpServers"));
+  results.push(registerInConfigFile(getClaudeCodeSettingsPath(), "Claude Code", "mcpServers"));
   results.push(registerInConfigFile(getClaudeDesktopMcpPath(), "Claude Desktop", "mcpServers"));
   results.push(registerWithClaudeCli());
   return results;
@@ -15999,8 +16025,9 @@ function printRegistrationResults(results) {
   return anySuccess;
 }
 function printManualInstructions() {
-  console.log("  To register the MCP server manually, add this to your mcp.json:");
+  console.log("  To register the MCP server manually, add this to your editor config:");
   console.log("");
+  console.log("  For VS Code / Cursor (mcp.json):");
   console.log("    {");
   console.log('      "servers": {');
   console.log('        "kanbodev": {');
@@ -16011,10 +16038,24 @@ function printManualInstructions() {
   console.log("      }");
   console.log("    }");
   console.log("");
+  console.log("  For Claude Desktop / Windsurf / Claude Code:");
+  console.log("    {");
+  console.log('      "mcpServers": {');
+  console.log('        "kanbodev": {');
+  console.log('          "type": "stdio",');
+  console.log('          "command": "npx",');
+  console.log('          "args": ["@kanbodev/mcp"]');
+  console.log("        }");
+  console.log("      }");
+  console.log("    }");
+  console.log("");
   console.log("  Config file locations:");
-  console.log(`    VS Code:        ${getVscodeMcpPath()}`);
-  console.log(`    Cursor:         ${getCursorMcpPath()}`);
-  console.log(`    Claude Desktop: ${getClaudeDesktopMcpPath()}`);
+  console.log(`    VS Code:          ${getVscodeMcpPath()}`);
+  console.log(`    VS Code Insiders: ${getVscodeInsidersMcpPath()}`);
+  console.log(`    Cursor:           ${getCursorMcpPath()}`);
+  console.log(`    Windsurf:         ${getWindsurfMcpPath()}`);
+  console.log(`    Claude Code:      ${getClaudeCodeSettingsPath()}`);
+  console.log(`    Claude Desktop:   ${getClaudeDesktopMcpPath()}`);
   console.log("");
   console.log("  Or register via Claude Code CLI:");
   console.log("    claude mcp add kanbodev -- npx @kanbodev/mcp");
@@ -16872,20 +16913,19 @@ async function install() {
   Kanbo MCP — Install
 `);
   const config3 = loadConfig();
-  if (!config3) {
-    console.log("  You are not logged in. Please authenticate first:");
-    console.log("    npx @kanbodev/mcp login");
-    console.log("");
-    console.log("  Or register the MCP server manually:");
-    console.log("");
-    printManualInstructions();
-    console.log("");
-    return;
+  if (config3) {
+    console.log(`  Logged in as ${config3.userEmail} (${config3.orgName})`);
+  } else {
+    console.log("  Not logged in yet — registering MCP server entry.");
+    console.log('  Run "npx @kanbodev/mcp login" to authenticate after install.');
   }
-  console.log(`  Logged in as ${config3.userEmail} (${config3.orgName})`);
   console.log("");
   const results = registerMcpServer();
-  printRegistrationResults(results);
+  const anySuccess = printRegistrationResults(results);
+  if (!anySuccess) {
+    console.log("");
+    printManualInstructions();
+  }
   console.log("");
 }
 var init_install = __esm(() => {

package/docs/SETUP.md

@@ -18,7 +18,7 @@ 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)
+4. **Auto-register the MCP server** with detected editors (VS Code, VS Code Insiders, Cursor, Windsurf, Claude Code, Claude Desktop, Claude Code CLI)
 
 You'll see output like:
 
@@ -129,7 +129,7 @@ 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.
+> **Note:** `npx @kanbodev/mcp login` auto-registers with VS Code, VS Code Insiders, Cursor, Windsurf, Claude Code, Claude Desktop, and Claude Code CLI. The manual configs below are only needed if auto-registration didn't detect your editor.
 
 ### Cursor
 
@@ -151,6 +151,38 @@ Add to `~/.cursor/mcp.json`:
 
 See the full [VS Code setup guide](VSCODE.md) for native MCP support (v1.99+), Claude Code extension, and Cursor/Windsurf.
 
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "kanbodev": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@kanbodev/mcp"]
+    }
+  }
+}
+```
+
+### Claude Code (VS Code Extension)
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "kanbodev": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@kanbodev/mcp"]
+    }
+  }
+}
+```
+
 ### Claude Code CLI
 
 ```bash

package/docs/VSCODE.md

@@ -94,7 +94,7 @@ Open the terminal in VS Code and run:
 claude mcp add kanbo -- npx @kanbodev/mcp
 ```
 
-This writes the config to `~/.claude.json` (global) by default.
+This writes the config to `~/.claude.json` (global) by default. The `login` command also auto-registers in `~/.claude/settings.json`.
 
 ### Via config file
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanbodev/mcp",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "MCP (Model Context Protocol) server for Kanbo - AI-native project management",
   "type": "module",
   "main": "dist/index.js",
@@ -41,6 +41,7 @@
     "claude",
     "cursor"
   ],
+  "homepage": "https://kanbo.dev",
   "author": "Kanbo",
   "license": "MIT"
 }