huly-mcp-sdk 0.5.2 → 0.5.4

package/README.md

@@ -53,8 +53,6 @@ Connects **Claude Desktop** (and any [MCP](https://modelcontextprotocol.io)-comp
 
 ## Quick Start
 
-### 1. Install via npx (easiest)
-
 ```bash
 npx huly-mcp-sdk setup
 ```
@@ -63,9 +61,23 @@ This runs the interactive setup wizard — sends a one-time code to your email (
 
 **Your workspace slug** is the part of your Huly URL after the domain: `huly.app/`**`myteam`** → slug is `myteam`.
 
-### 2. Configure Claude Desktop
+---
+
+## Compatible Clients
 
-Add this to your Claude Desktop config:
+The same MCP server works across all major AI coding tools. Pick your client.
+
+> **Auth note:** All config examples below use `HULY_TOKEN`. If you have issues with token expiry, use email + password instead — just replace the `env` block with:
+> ```json
+> "HULY_EMAIL": "your@email.com",
+> "HULY_PASSWORD": "yourpassword",
+> "HULY_WORKSPACE": "your-workspace-slug"
+> ```
+> See [Manual Auth](#manual-auth) for details on both options.
+
+---
+
+### Claude Desktop
 
 - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
@@ -77,7 +89,7 @@ Add this to your Claude Desktop config:
       "command": "npx",
       "args": ["huly-mcp-sdk"],
       "env": {
-        "HULY_TOKEN": "paste-token-here",
+        "HULY_TOKEN": "your-token",
         "HULY_WORKSPACE": "your-workspace-slug"
       }
     }
@@ -87,12 +99,175 @@ Add this to your Claude Desktop config:
 
 Restart Claude Desktop after saving.
 
-> **Alternative (clone & build):**
+---
+
+### Claude Code (CLI)
+
+```bash
+claude mcp add huly -e HULY_TOKEN=your-token -e HULY_WORKSPACE=your-slug -- npx huly-mcp-sdk
+```
+
+Or scope it to a single project only:
+
+```bash
+claude mcp add huly --scope project -e HULY_TOKEN=your-token -e HULY_WORKSPACE=your-slug -- npx huly-mcp-sdk
+```
+
+Verify it's connected: `claude mcp list`
+
+---
+
+### Cursor
+
+Create or edit `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "huly": {
+      "command": "npx",
+      "args": ["huly-mcp-sdk"],
+      "env": {
+        "HULY_TOKEN": "your-token",
+        "HULY_WORKSPACE": "your-workspace-slug"
+      }
+    }
+  }
+}
+```
+
+Restart Cursor. The tools appear in the Agent panel under MCP.
+
+---
+
+### Windsurf (Codeium)
+
+Create or edit `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "huly": {
+      "command": "npx",
+      "args": ["huly-mcp-sdk"],
+      "env": {
+        "HULY_TOKEN": "your-token",
+        "HULY_WORKSPACE": "your-workspace-slug"
+      }
+    }
+  }
+}
+```
+
+Restart Windsurf. MCP tools are available to the Cascade AI panel.
+
+---
+
+### VS Code — Cline extension
+
+1. Install the [Cline extension](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev)
+2. Open Cline settings → **MCP Servers** → **Edit MCP Settings**
+3. Add:
+
+```json
+{
+  "huly": {
+    "command": "npx",
+    "args": ["huly-mcp-sdk"],
+    "env": {
+      "HULY_TOKEN": "your-token",
+      "HULY_WORKSPACE": "your-workspace-slug"
+    }
+  }
+}
+```
+
+---
+
+### VS Code — Continue extension
+
+1. Install the [Continue extension](https://marketplace.visualstudio.com/items?itemName=Continue.continue)
+2. Edit `~/.continue/config.json` and add to the `mcpServers` array:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "huly",
+      "command": "npx",
+      "args": ["huly-mcp-sdk"],
+      "env": {
+        "HULY_TOKEN": "your-token",
+        "HULY_WORKSPACE": "your-workspace-slug"
+      }
+    }
+  ]
+}
+```
+
+---
+
+### Zed
+
+Edit `~/.config/zed/settings.json` and add a `context_servers` entry:
+
+```json
+{
+  "context_servers": {
+    "huly": {
+      "command": {
+        "path": "npx",
+        "args": ["huly-mcp-sdk"],
+        "env": {
+          "HULY_TOKEN": "your-token",
+          "HULY_WORKSPACE": "your-workspace-slug"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+### OpenAI Codex CLI
+
+Edit `~/.codex/config.json` and add to `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "huly": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["huly-mcp-sdk"],
+      "env": {
+        "HULY_TOKEN": "your-token",
+        "HULY_WORKSPACE": "your-workspace-slug"
+      }
+    }
+  }
+}
+```
+
+---
+
+### Any other MCP-compatible client
+
+The server uses standard **stdio transport**. If your tool supports MCP, the config pattern is always the same:
+
+- **command:** `npx`
+- **args:** `["huly-mcp-sdk"]`
+- **env:** `HULY_TOKEN` + `HULY_WORKSPACE`
+
+Consult your tool's MCP documentation for the exact config file location.
+
+> **Alternative (avoid npx cold-start):** Clone and build once, then point directly at the compiled binary:
 > ```bash
 > git clone https://github.com/varaprasadreddy9676/huly-mcp.git
 > cd huly-mcp && npm install && npm run build
 > ```
-> Then use `"command": "node", "args": ["/absolute/path/to/huly-mcp/dist/index.js"]` in your config.
+> Replace `"command": "npx", "args": ["huly-mcp-sdk"]` with `"command": "node", "args": ["/absolute/path/to/huly-mcp/dist/index.js"]` in any config above.
 
 ---
 
@@ -212,29 +387,29 @@ Required column: `title`. Optional: `priority` (Urgent/High/Medium/Low), `status
 
 ## Manual Auth
 
-Create a `.env` file in the project root:
+Create a `.env` file in the project root (or pass via `env` in your client config):
 
-**Option A — Token (recommended for all account types):**
+**Option A — Email + password (recommended):**
+
+Works if you have a password set on your Huly account (Profile → Security → Change password).
 
 ```bash
+HULY_EMAIL=your@email.com
+HULY_PASSWORD=yourpassword
 HULY_WORKSPACE=your-workspace-slug
-HULY_TOKEN=your-token-here
 ```
 
-To get a token: go to [huly.app](https://huly.app) → open browser DevTools → Application → Local Storage → `https://huly.app` → copy the `token` value.
-
-> Tokens expire after some time. If you get an auth error, run `npx huly-mcp-sdk setup` again or refresh the token from DevTools.
-
-**Option B — Email + password:**
-
-Only works if you have a password set on your account (Profile → Security → Change password).
+**Option B — Token:**
 
 ```bash
-HULY_EMAIL=your@email.com
-HULY_PASSWORD=yourpassword
 HULY_WORKSPACE=your-workspace-slug
+HULY_TOKEN=your-token-here
 ```
 
+To get a token: go to [huly.app](https://huly.app) → open browser DevTools → Application → Local Storage → `https://huly.app` → copy the `token` value.
+
+> Tokens expire after some time. If you get an auth error, switch to email + password auth or refresh the token from DevTools.
+
 **Self-hosted Huly:**
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "huly-mcp-sdk",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "MCP server for Huly — connect Claude Desktop to your Huly workspace via the native WebSocket SDK",
   "keywords": [
     "huly",