@denisixnpm/planka-mcp 2.2.0 → 2.3.1

package/README.md

@@ -2,6 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@denisixnpm/planka-mcp)](https://www.npmjs.com/package/@denisixnpm/planka-mcp)
 [![GitHub release](https://img.shields.io/github/v/release/denisix/planka-mcp)](https://github.com/denisix/planka-mcp/releases)
+[![Docker](https://img.shields.io/docker/v/denisix/planka-mcp?sort=semver&label=Docker)](https://hub.docker.com/r/denisix/planka-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 MCP server for [Planka](https://planka.app/) (real-time Kanban), tuned for AI coding agents:
@@ -10,8 +11,25 @@ No build step, no Docker required — `npx` runs the prebuilt package over stdio
 
 ## Install
 
+Two auth modes: **username/password** works on every Planka version (the server logs in
+automatically, caches the token, and silently re-logins on expiry); **API key** is Planka **v2
+only** — generate one in your Planka user settings → *API keys* (v1.26.x has no API keys; verified:
+`X-Api-Key` returns 401 there).
+
 ### Claude Code
 
+**Planka v1 (≤ 1.26.x) — username/password:**
+
+```bash
+claude mcp add planka \
+  --env PLANKA_BASE_URL=http://localhost:3000 \
+  --env PLANKA_USERNAME=your-email-or-username \
+  --env PLANKA_PASSWORD=your-password \
+  -- npx -y @denisixnpm/planka-mcp
+```
+
+**Planka v2 — API key (username/password above works too):**
+
 ```bash
 claude mcp add planka \
   --env PLANKA_BASE_URL=http://localhost:3000 \
@@ -19,7 +37,7 @@ claude mcp add planka \
   -- npx -y @denisixnpm/planka-mcp
 ```
 
-Or in `claude_desktop_config.json` / `.mcp.json`:
+Or in `claude_desktop_config.json` / `.mcp.json` (username/password form — works on both versions):
 
 ```json
 {
@@ -27,7 +45,7 @@ Or in `claude_desktop_config.json` / `.mcp.json`:
     "planka": {
       "command": "npx",
       "args": ["-y", "@denisixnpm/planka-mcp"],
-      "env": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_API_KEY": "your-api-key" }
+      "env": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_USERNAME": "your-email-or-username", "PLANKA_PASSWORD": "your-password" }
     }
   }
 }
@@ -35,6 +53,17 @@ Or in `claude_desktop_config.json` / `.mcp.json`:
 
 ### Codex (`~/.codex/config.toml`)
 
+**Planka v1 (≤ 1.26.x):**
+
+```toml
+[mcp_servers.planka]
+command = "npx"
+args = ["-y", "@denisixnpm/planka-mcp"]
+env = { PLANKA_BASE_URL = "http://localhost:3000", PLANKA_USERNAME = "your-email-or-username", PLANKA_PASSWORD = "your-password" }
+```
+
+**Planka v2 (API key):**
+
 ```toml
 [mcp_servers.planka]
 command = "npx"
@@ -44,6 +73,22 @@ env = { PLANKA_BASE_URL = "http://localhost:3000", PLANKA_API_KEY = "your-api-ke
 
 ### opencode (`opencode.json`)
 
+**Planka v1 (≤ 1.26.x):**
+
+```json
+{
+  "mcp": {
+    "planka": {
+      "type": "local",
+      "command": ["npx", "-y", "@denisixnpm/planka-mcp"],
+      "environment": { "PLANKA_BASE_URL": "http://localhost:3000", "PLANKA_USERNAME": "your-email-or-username", "PLANKA_PASSWORD": "your-password" }
+    }
+  }
+}
+```
+
+**Planka v2 (API key):**
+
 ```json
 {
   "mcp": {
@@ -63,8 +108,8 @@ Requires Node.js ≥ 22.19 (or run the same command with Bun ≥ 1.3). Debug: `n
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `PLANKA_BASE_URL` | `http://localhost:3000` | Planka instance URL |
-| `PLANKA_API_KEY` | — | API key auth (recommended; wins if both are set) |
-| `PLANKA_USERNAME` / `PLANKA_PASSWORD` | — | Login auth (alternative to API key) |
+| `PLANKA_USERNAME` / `PLANKA_PASSWORD` | — | Login auth — **all Planka versions**; token is fetched, cached, and refreshed automatically |
+| `PLANKA_API_KEY` | — | API key auth — **Planka v2 only** (user settings → API keys); wins if both are set |
 | `PLANKA_HTTP_TIMEOUT_MS` | `30000` | Per-request timeout (aborts, then retries) |
 | `PLANKA_HTTP_MAX_RETRIES` | `2` | Retries for `408`/`429`/`5xx` and network errors |
 | `PLANKA_HTTP_RETRY_BASE_DELAY_MS` | `250` | Exponential backoff base (`base * 2^attempt`) |
@@ -119,6 +164,7 @@ loopback (`MCP_HOST=0.0.0.0`) — without it, anyone who can reach the port has
 A `--healthcheck` mode is built in for orchestrators.
 
 Prefer a container? The image is published on Docker Hub:
+[`hub.docker.com/r/denisix/planka-mcp`](https://hub.docker.com/r/denisix/planka-mcp)
 
 
 ```bash

package/dist/server.js

@@ -342,7 +342,7 @@ if (!process.argv.includes("--healthcheck")) {
 function createMcpServer() {
     const server = new McpServer({
         name: "planka-mcp",
-        version: "2.2.0",
+        version: "2.3.1",
     }, {
         capabilities: {
             tools: {},

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@denisixnpm/planka-mcp",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "MCP server for Planka - Real-Time Collaborative Kanban Board",
   "main": "dist/server.js",
   "type": "module",
   "bin": {
-    "planka-mcp": "./dist/server.js"
+    "planka-mcp": "dist/server.js"
   },
   "files": [
     "dist"
@@ -36,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/denisix/planka-mcp.git"
+    "url": "git+https://github.com/denisix/planka-mcp.git"
   },
   "homepage": "https://github.com/denisix/planka-mcp#readme",
   "bugs": {