diff --git a/Kanboard.md b/Kanboard.md index abb7015..630d754 100644 --- a/Kanboard.md +++ b/Kanboard.md @@ -1,7 +1,8 @@ # Kanboard Kanban task boards. Tasks can be assigned to **Claude**, which fetches, works, -comments and moves cards like a regular team member via the `agap-mcp` server. +comments and moves cards like a regular team member via the dedicated +**`kanboard-mcp`** server. ## Service @@ -34,27 +35,40 @@ curl -s -u "jsonrpc:$KANBOARD_TOKEN" http://localhost:4800/jsonrpc.php \ - Assign a card to `claude` (in the UI or `kanboard_assign_task`) and it shows up in `kanboard_my_tasks`. -## agap-mcp integration +## kanboard-mcp integration -Implemented in `agap-mcp` (`src/kanboard.js`, registered in `src/server.js`). -Authenticates with the app-wide `KANBOARD_TOKEN`; writes (comments, tasks, -subtasks) are authored as `claude` via `user_id`. Env: `KANBOARD_URL`, -`KANBOARD_BOT_USER=claude`. +The `kanboard_*` tools run in a **dedicated standalone MCP server** (split out of +the shared `agap-mcp` on 2026-07-06, which had grown overloaded). Lives in the +`alvis/kanboard` repo at `mcp/`; container `kanboard-mcp` on **port 3103**, +registered in `~/.claude.json` as server **`kanboard`** (tools appear as +`mcp__kanboard__kanboard_*`). Authenticates with the app-wide `KANBOARD_TOKEN` +(read straight from `mcp/.env`); writes are authored as `claude` via `user_id`. +Env: `PORT`, `KANBOARD_URL`, `KANBOARD_TOKEN`, `KANBOARD_BOT_USER=claude`. -Tools (`mcp__agap__kanboard_*`): +```bash +cd /home/alvis/kanboard/mcp && docker compose up -d --build # (with proxy vars unset) +curl -s http://localhost:3103/health # {"status":"ok","tools":23} +``` + +Tools (`mcp__kanboard__kanboard_*`): | Tool | Purpose | |------|---------| | `list_projects` / `get_project` | projects; columns + swimlanes | | `list_tasks` / `my_tasks` | tasks in a project / assigned to claude (all projects) | -| `get_task` | task + subtasks + comments | +| `get_task` | task + subtasks + comments + tags | | `search_tasks` | Kanboard query syntax (`assignee:`, `status:`, `due:`) | | `list_users` / `project_activity` | monitor users / activity stream | -| `create_task` / `update_task` | create / edit | +| `create_task` / `update_task` | create / edit (incl. `score` complexity) | | `move_task` / `change_task_status` | move column / open-close | | `assign_task` | (re)assign to a user | -| `add_comment` | comment as claude | +| `add_comment` / `remove_comment` | comment as claude / delete | | `create_subtask` / `update_subtask` | track execution steps (0 todo/1 wip/2 done) | -| `remove_task` / `remove_comment` | delete (irreversible) | +| `get_task_tags` / `set_task_tags` | read/add/remove tags (e.g. `blocked`) | +| `add_task_link` / `get_task_links` / `remove_task_link` | task dependencies ("is blocked by" / "blocks") | +| `remove_task` | delete a task (irreversible) | Deleting whole projects is intentionally not exposed. + +> The orchestration ruleset (how Claude dispatches board tasks to sub-agents) and +> the full service/provenance notes live in `alvis/kanboard` → `CLAUDE.md`.