mcp-zenskar 1.0.5 → 1.0.8

package/README.md

@@ -32,6 +32,8 @@ Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/
 }
 ```
 
+> You can omit one or both environment variables from the config, but the server will error until Claude supplies them in a tool call. Keeping them in the env block prevents repeated credential prompts.
+
 ### For Other AI Applications
 
 Install globally:
@@ -56,6 +58,8 @@ This MCP server requires two authentication parameters for every request:
 1. **Organization ID**: Available in your Zenskar dashboard settings
 2. **API Token**: Generate from Zenskar dashboard → Settings → API Keys
 
+At runtime the server looks for these values in the tool invocation first, then falls back to the `ZENSKAR_ORGANIZATION` and `ZENSKAR_AUTH_TOKEN` environment variables. Tokens that look like JWTs are sent as `Authorization: Bearer ...`; everything else is sent as an `x-api-key` header automatically.
+
 ## Usage
 
 ### In Claude Desktop
@@ -114,6 +118,31 @@ npm install
 npm start
 ```
 
+### Developing Locally Without Publishing
+
+If you want Claude Desktop to use a local checkout instead of the npm package:
+
+```bash
+# Install dependencies once
+npm install
+
+# Optional: install the local build globally
+npm install -g .
+```
+
+Then either point Claude to the globally-installed binary (usually `$(npm bin -g)/mcp-zenskar`) or call the repo copy directly:
+
+```json
+{
+  "command": "node",
+  "args": ["/absolute/path/to/mcp-zenskar/src/server.js"],
+  "env": {
+    "ZENSKAR_ORGANIZATION": "your-org-id",
+    "ZENSKAR_AUTH_TOKEN": "your-token"
+  }
+}
+```
+
 ## Configuration
 
 The server uses `src/mcp-config.json` to define available tools and API endpoints. This file contains the complete mapping of MCP tools to Zenskar API operations.
@@ -126,4 +155,4 @@ MIT
 
 For issues and support:
 - GitHub Issues: https://github.com/zenskar/mcp-zenskar/issues
-- Zenskar Documentation: https://docs.zenskar.com
+- Zenskar Documentation: https://docs.zenskar.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-zenskar",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "Model Context Protocol (MCP) server for Zenskar API - customer management, invoicing, and billing operations",
   "type": "module",
   "main": "src/server.js",
@@ -39,4 +39,4 @@
     "url": "https://github.com/zenskar/mcp-zenskar/issues"
   },
   "homepage": "https://github.com/zenskar/mcp-zenskar#readme"
-}
+}