@kanbodev/mcp 1.1.8 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +323 -323
- package/dist/index.js +1795 -1012
- package/docs/GIT_CONVENTIONS.md +139 -139
- package/docs/SETUP.md +254 -254
- package/docs/VSCODE.md +211 -211
- package/package.json +47 -47
package/docs/VSCODE.md
CHANGED
|
@@ -1,211 +1,211 @@
|
|
|
1
|
-
# Using Kanbo MCP with VS Code
|
|
2
|
-
|
|
3
|
-
Connect Kanbo to your VS Code environment and manage projects, tickets, and workflows through AI-powered conversation — without leaving your editor.
|
|
4
|
-
|
|
5
|
-
## Prerequisites
|
|
6
|
-
|
|
7
|
-
**Authenticate and register** (one-time setup):
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
npx @kanbodev/mcp login
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
This opens your browser, signs you in, stores your credentials, and **auto-registers the MCP server with VS Code** (writes to your user-level `mcp.json`).
|
|
14
|
-
|
|
15
|
-
Reload VS Code and you're ready to go.
|
|
16
|
-
|
|
17
|
-
Verify it worked:
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
npx @kanbodev/mcp whoami
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## VS Code Native MCP (v1.99+)
|
|
26
|
-
|
|
27
|
-
VS Code 1.99 and later has built-in MCP support through GitHub Copilot Chat. The `login` command auto-registers at the user level, so no manual config is needed.
|
|
28
|
-
|
|
29
|
-
### Workspace-level setup (optional)
|
|
30
|
-
|
|
31
|
-
If you prefer per-project config instead of user-level, add to `.vscode/settings.json`:
|
|
32
|
-
|
|
33
|
-
```json
|
|
34
|
-
{
|
|
35
|
-
"mcp": {
|
|
36
|
-
"servers": {
|
|
37
|
-
"kanbo": {
|
|
38
|
-
"command": "npx",
|
|
39
|
-
"args": ["@kanbodev/mcp"]
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
### Manual user-level setup
|
|
47
|
-
|
|
48
|
-
If auto-registration didn't work, add the config to your **User Settings** (JSON):
|
|
49
|
-
|
|
50
|
-
1. Open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
|
|
51
|
-
2. Select **Preferences: Open User Settings (JSON)**
|
|
52
|
-
3. Add the `mcp` block above
|
|
53
|
-
|
|
54
|
-
Or run `npx @kanbodev/mcp install` to retry auto-registration.
|
|
55
|
-
|
|
56
|
-
### Using a manual API key
|
|
57
|
-
|
|
58
|
-
If you prefer environment variables over the login flow:
|
|
59
|
-
|
|
60
|
-
```json
|
|
61
|
-
{
|
|
62
|
-
"mcp": {
|
|
63
|
-
"servers": {
|
|
64
|
-
"kanbo": {
|
|
65
|
-
"command": "npx",
|
|
66
|
-
"args": ["@kanbodev/mcp"],
|
|
67
|
-
"env": {
|
|
68
|
-
"KANBO_API_KEY": "kanbo_pat_your_token_here"
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
### Verify
|
|
77
|
-
|
|
78
|
-
1. Reload the VS Code window (`Cmd+Shift+P` → **Developer: Reload Window**)
|
|
79
|
-
2. Open Copilot Chat (`Cmd+Shift+I` / `Ctrl+Shift+I`)
|
|
80
|
-
3. Switch to **Agent** mode
|
|
81
|
-
4. You should see Kanbo tools listed under the tools icon
|
|
82
|
-
|
|
83
|
-
---
|
|
84
|
-
|
|
85
|
-
## Claude Code Extension
|
|
86
|
-
|
|
87
|
-
If you use the [Claude Code extension](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) for VS Code:
|
|
88
|
-
|
|
89
|
-
### Via CLI
|
|
90
|
-
|
|
91
|
-
Open the terminal in VS Code and run:
|
|
92
|
-
|
|
93
|
-
```bash
|
|
94
|
-
claude mcp add kanbo -- npx @kanbodev/mcp
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
This writes the config to `~/.claude.json` (global) by default. The `login` command also auto-registers in `~/.claude/settings.json`.
|
|
98
|
-
|
|
99
|
-
### Via config file
|
|
100
|
-
|
|
101
|
-
Create or edit `.mcp.json` in your project root:
|
|
102
|
-
|
|
103
|
-
```json
|
|
104
|
-
{
|
|
105
|
-
"mcpServers": {
|
|
106
|
-
"kanbo": {
|
|
107
|
-
"command": "npx",
|
|
108
|
-
"args": ["@kanbodev/mcp"]
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
}
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
Then restart Claude Code.
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## Cursor
|
|
119
|
-
|
|
120
|
-
Add to your Cursor MCP settings (Settings → MCP → Add Server):
|
|
121
|
-
|
|
122
|
-
```json
|
|
123
|
-
{
|
|
124
|
-
"mcpServers": {
|
|
125
|
-
"kanbo": {
|
|
126
|
-
"command": "npx",
|
|
127
|
-
"args": ["@kanbodev/mcp"]
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
|
-
## Windsurf
|
|
136
|
-
|
|
137
|
-
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
138
|
-
|
|
139
|
-
```json
|
|
140
|
-
{
|
|
141
|
-
"mcpServers": {
|
|
142
|
-
"kanbo": {
|
|
143
|
-
"command": "npx",
|
|
144
|
-
"args": ["@kanbodev/mcp"]
|
|
145
|
-
}
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
---
|
|
151
|
-
|
|
152
|
-
## Troubleshooting
|
|
153
|
-
|
|
154
|
-
### Server not appearing
|
|
155
|
-
|
|
156
|
-
- Make sure you've reloaded the VS Code window after adding the config
|
|
157
|
-
- Check that `npx @kanbodev/mcp` works in your terminal: `npx @kanbodev/mcp whoami`
|
|
158
|
-
- Ensure Node.js 18+ is installed: `node --version`
|
|
159
|
-
|
|
160
|
-
### "Not authenticated" error
|
|
161
|
-
|
|
162
|
-
```bash
|
|
163
|
-
npx @kanbodev/mcp login
|
|
164
|
-
```
|
|
165
|
-
|
|
166
|
-
### Tools not showing up in Copilot Chat
|
|
167
|
-
|
|
168
|
-
- Switch to **Agent** mode in the Copilot Chat panel (not Ask or Edit mode)
|
|
169
|
-
- Click the tools icon to verify Kanbo is listed
|
|
170
|
-
- Try reloading the window
|
|
171
|
-
|
|
172
|
-
### Using a specific version
|
|
173
|
-
|
|
174
|
-
Pin to a version to avoid unexpected updates:
|
|
175
|
-
|
|
176
|
-
```json
|
|
177
|
-
{
|
|
178
|
-
"command": "npx",
|
|
179
|
-
"args": ["@kanbodev/mcp@1.0.0"]
|
|
180
|
-
}
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
Or always use the latest:
|
|
184
|
-
|
|
185
|
-
```json
|
|
186
|
-
{
|
|
187
|
-
"command": "npx",
|
|
188
|
-
"args": ["@kanbodev/mcp@latest"]
|
|
189
|
-
}
|
|
190
|
-
```
|
|
191
|
-
|
|
192
|
-
### Logs
|
|
193
|
-
|
|
194
|
-
Check the MCP server output in VS Code:
|
|
195
|
-
|
|
196
|
-
1. Open Command Palette → **Output: Show Output Channel**
|
|
197
|
-
2. Select the Kanbo MCP channel from the dropdown
|
|
198
|
-
|
|
199
|
-
---
|
|
200
|
-
|
|
201
|
-
## What You Can Do
|
|
202
|
-
|
|
203
|
-
Once connected, switch to Agent mode in Copilot Chat and try:
|
|
204
|
-
|
|
205
|
-
- *"What Kanbo projects do I have?"*
|
|
206
|
-
- *"Show me my assigned tickets"*
|
|
207
|
-
- *"Create a bug ticket in the Frontend project: login button unresponsive on mobile"*
|
|
208
|
-
- *"Move PROJ-123 to In Progress"*
|
|
209
|
-
- *"What's overdue this week?"*
|
|
210
|
-
|
|
211
|
-
See the full [User Guide](../README.md#user-guide) for all available commands.
|
|
1
|
+
# Using Kanbo MCP with VS Code
|
|
2
|
+
|
|
3
|
+
Connect Kanbo to your VS Code environment and manage projects, tickets, and workflows through AI-powered conversation — without leaving your editor.
|
|
4
|
+
|
|
5
|
+
## Prerequisites
|
|
6
|
+
|
|
7
|
+
**Authenticate and register** (one-time setup):
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx @kanbodev/mcp login
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
This opens your browser, signs you in, stores your credentials, and **auto-registers the MCP server with VS Code** (writes to your user-level `mcp.json`).
|
|
14
|
+
|
|
15
|
+
Reload VS Code and you're ready to go.
|
|
16
|
+
|
|
17
|
+
Verify it worked:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npx @kanbodev/mcp whoami
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## VS Code Native MCP (v1.99+)
|
|
26
|
+
|
|
27
|
+
VS Code 1.99 and later has built-in MCP support through GitHub Copilot Chat. The `login` command auto-registers at the user level, so no manual config is needed.
|
|
28
|
+
|
|
29
|
+
### Workspace-level setup (optional)
|
|
30
|
+
|
|
31
|
+
If you prefer per-project config instead of user-level, add to `.vscode/settings.json`:
|
|
32
|
+
|
|
33
|
+
```json
|
|
34
|
+
{
|
|
35
|
+
"mcp": {
|
|
36
|
+
"servers": {
|
|
37
|
+
"kanbo": {
|
|
38
|
+
"command": "npx",
|
|
39
|
+
"args": ["@kanbodev/mcp"]
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Manual user-level setup
|
|
47
|
+
|
|
48
|
+
If auto-registration didn't work, add the config to your **User Settings** (JSON):
|
|
49
|
+
|
|
50
|
+
1. Open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
|
|
51
|
+
2. Select **Preferences: Open User Settings (JSON)**
|
|
52
|
+
3. Add the `mcp` block above
|
|
53
|
+
|
|
54
|
+
Or run `npx @kanbodev/mcp install` to retry auto-registration.
|
|
55
|
+
|
|
56
|
+
### Using a manual API key
|
|
57
|
+
|
|
58
|
+
If you prefer environment variables over the login flow:
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"mcp": {
|
|
63
|
+
"servers": {
|
|
64
|
+
"kanbo": {
|
|
65
|
+
"command": "npx",
|
|
66
|
+
"args": ["@kanbodev/mcp"],
|
|
67
|
+
"env": {
|
|
68
|
+
"KANBO_API_KEY": "kanbo_pat_your_token_here"
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Verify
|
|
77
|
+
|
|
78
|
+
1. Reload the VS Code window (`Cmd+Shift+P` → **Developer: Reload Window**)
|
|
79
|
+
2. Open Copilot Chat (`Cmd+Shift+I` / `Ctrl+Shift+I`)
|
|
80
|
+
3. Switch to **Agent** mode
|
|
81
|
+
4. You should see Kanbo tools listed under the tools icon
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Claude Code Extension
|
|
86
|
+
|
|
87
|
+
If you use the [Claude Code extension](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) for VS Code:
|
|
88
|
+
|
|
89
|
+
### Via CLI
|
|
90
|
+
|
|
91
|
+
Open the terminal in VS Code and run:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
claude mcp add kanbo -- npx @kanbodev/mcp
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
This writes the config to `~/.claude.json` (global) by default. The `login` command also auto-registers in `~/.claude/settings.json`.
|
|
98
|
+
|
|
99
|
+
### Via config file
|
|
100
|
+
|
|
101
|
+
Create or edit `.mcp.json` in your project root:
|
|
102
|
+
|
|
103
|
+
```json
|
|
104
|
+
{
|
|
105
|
+
"mcpServers": {
|
|
106
|
+
"kanbo": {
|
|
107
|
+
"command": "npx",
|
|
108
|
+
"args": ["@kanbodev/mcp"]
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Then restart Claude Code.
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## Cursor
|
|
119
|
+
|
|
120
|
+
Add to your Cursor MCP settings (Settings → MCP → Add Server):
|
|
121
|
+
|
|
122
|
+
```json
|
|
123
|
+
{
|
|
124
|
+
"mcpServers": {
|
|
125
|
+
"kanbo": {
|
|
126
|
+
"command": "npx",
|
|
127
|
+
"args": ["@kanbodev/mcp"]
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Windsurf
|
|
136
|
+
|
|
137
|
+
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
138
|
+
|
|
139
|
+
```json
|
|
140
|
+
{
|
|
141
|
+
"mcpServers": {
|
|
142
|
+
"kanbo": {
|
|
143
|
+
"command": "npx",
|
|
144
|
+
"args": ["@kanbodev/mcp"]
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Troubleshooting
|
|
153
|
+
|
|
154
|
+
### Server not appearing
|
|
155
|
+
|
|
156
|
+
- Make sure you've reloaded the VS Code window after adding the config
|
|
157
|
+
- Check that `npx @kanbodev/mcp` works in your terminal: `npx @kanbodev/mcp whoami`
|
|
158
|
+
- Ensure Node.js 18+ is installed: `node --version`
|
|
159
|
+
|
|
160
|
+
### "Not authenticated" error
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
npx @kanbodev/mcp login
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
### Tools not showing up in Copilot Chat
|
|
167
|
+
|
|
168
|
+
- Switch to **Agent** mode in the Copilot Chat panel (not Ask or Edit mode)
|
|
169
|
+
- Click the tools icon to verify Kanbo is listed
|
|
170
|
+
- Try reloading the window
|
|
171
|
+
|
|
172
|
+
### Using a specific version
|
|
173
|
+
|
|
174
|
+
Pin to a version to avoid unexpected updates:
|
|
175
|
+
|
|
176
|
+
```json
|
|
177
|
+
{
|
|
178
|
+
"command": "npx",
|
|
179
|
+
"args": ["@kanbodev/mcp@1.0.0"]
|
|
180
|
+
}
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
Or always use the latest:
|
|
184
|
+
|
|
185
|
+
```json
|
|
186
|
+
{
|
|
187
|
+
"command": "npx",
|
|
188
|
+
"args": ["@kanbodev/mcp@latest"]
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### Logs
|
|
193
|
+
|
|
194
|
+
Check the MCP server output in VS Code:
|
|
195
|
+
|
|
196
|
+
1. Open Command Palette → **Output: Show Output Channel**
|
|
197
|
+
2. Select the Kanbo MCP channel from the dropdown
|
|
198
|
+
|
|
199
|
+
---
|
|
200
|
+
|
|
201
|
+
## What You Can Do
|
|
202
|
+
|
|
203
|
+
Once connected, switch to Agent mode in Copilot Chat and try:
|
|
204
|
+
|
|
205
|
+
- *"What Kanbo projects do I have?"*
|
|
206
|
+
- *"Show me my assigned tickets"*
|
|
207
|
+
- *"Create a bug ticket in the Frontend project: login button unresponsive on mobile"*
|
|
208
|
+
- *"Move PROJ-123 to In Progress"*
|
|
209
|
+
- *"What's overdue this week?"*
|
|
210
|
+
|
|
211
|
+
See the full [User Guide](../README.md#user-guide) for all available commands.
|
package/package.json
CHANGED
|
@@ -1,47 +1,47 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@kanbodev/mcp",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "MCP (Model Context Protocol) server for Kanbo - AI-native project management",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"main": "dist/index.js",
|
|
7
|
-
"bin": {
|
|
8
|
-
"
|
|
9
|
-
},
|
|
10
|
-
"scripts": {
|
|
11
|
-
"dev": "bun run --watch src/index.ts",
|
|
12
|
-
"dev:http": "TRANSPORT=http bun run --watch src/index.ts",
|
|
13
|
-
"build": "bun build src/index.ts --outdir dist --target node --format esm",
|
|
14
|
-
"build:bun": "bun build src/index.ts --outdir dist --target bun --format esm",
|
|
15
|
-
"start": "bun run dist/index.js",
|
|
16
|
-
"start:http": "TRANSPORT=http bun run dist/index.js",
|
|
17
|
-
"typecheck": "tsc --noEmit",
|
|
18
|
-
"test": "bun test",
|
|
19
|
-
"test:watch": "bun test --watch",
|
|
20
|
-
"test:coverage": "bun test --coverage",
|
|
21
|
-
"clean": "rm -rf dist"
|
|
22
|
-
},
|
|
23
|
-
"dependencies": {
|
|
24
|
-
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
25
|
-
"elysia": "^1.0.0",
|
|
26
|
-
"open": "^11.0.0",
|
|
27
|
-
"pino": "^10.3.0"
|
|
28
|
-
},
|
|
29
|
-
"devDependencies": {
|
|
30
|
-
"@types/bun": "^1.1.0",
|
|
31
|
-
"typescript": "^5.3.0"
|
|
32
|
-
},
|
|
33
|
-
"engines": {
|
|
34
|
-
"node": ">=18.0.0"
|
|
35
|
-
},
|
|
36
|
-
"keywords": [
|
|
37
|
-
"mcp",
|
|
38
|
-
"kanbo",
|
|
39
|
-
"ai",
|
|
40
|
-
"project-management",
|
|
41
|
-
"claude",
|
|
42
|
-
"cursor"
|
|
43
|
-
],
|
|
44
|
-
"homepage": "https://kanbo.dev",
|
|
45
|
-
"author": "Kanbo",
|
|
46
|
-
"license": "MIT"
|
|
47
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "@kanbodev/mcp",
|
|
3
|
+
"version": "1.2.0",
|
|
4
|
+
"description": "MCP (Model Context Protocol) server for Kanbo - AI-native project management",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "dist/index.js",
|
|
7
|
+
"bin": {
|
|
8
|
+
"kanbo-mcp": "dist/index.js"
|
|
9
|
+
},
|
|
10
|
+
"scripts": {
|
|
11
|
+
"dev": "bun run --watch src/index.ts",
|
|
12
|
+
"dev:http": "TRANSPORT=http bun run --watch src/index.ts",
|
|
13
|
+
"build": "bun build src/index.ts --outdir dist --target node --format esm",
|
|
14
|
+
"build:bun": "bun build src/index.ts --outdir dist --target bun --format esm",
|
|
15
|
+
"start": "bun run dist/index.js",
|
|
16
|
+
"start:http": "TRANSPORT=http bun run dist/index.js",
|
|
17
|
+
"typecheck": "tsc --noEmit",
|
|
18
|
+
"test": "bun test",
|
|
19
|
+
"test:watch": "bun test --watch",
|
|
20
|
+
"test:coverage": "bun test --coverage",
|
|
21
|
+
"clean": "rm -rf dist"
|
|
22
|
+
},
|
|
23
|
+
"dependencies": {
|
|
24
|
+
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
25
|
+
"elysia": "^1.0.0",
|
|
26
|
+
"open": "^11.0.0",
|
|
27
|
+
"pino": "^10.3.0"
|
|
28
|
+
},
|
|
29
|
+
"devDependencies": {
|
|
30
|
+
"@types/bun": "^1.1.0",
|
|
31
|
+
"typescript": "^5.3.0"
|
|
32
|
+
},
|
|
33
|
+
"engines": {
|
|
34
|
+
"node": ">=18.0.0"
|
|
35
|
+
},
|
|
36
|
+
"keywords": [
|
|
37
|
+
"mcp",
|
|
38
|
+
"kanbo",
|
|
39
|
+
"ai",
|
|
40
|
+
"project-management",
|
|
41
|
+
"claude",
|
|
42
|
+
"cursor"
|
|
43
|
+
],
|
|
44
|
+
"homepage": "https://kanbo.dev",
|
|
45
|
+
"author": "Kanbo",
|
|
46
|
+
"license": "MIT"
|
|
47
|
+
}
|