@zaai-dev/mcp 0.6.1 → 0.6.2
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 +26 -0
- package/dist/bin/http.js +1 -1
- package/dist/bin/stdio.js +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -77,6 +77,32 @@ ZAAI_HTTP_PORT=3001 \
|
|
|
77
77
|
|
|
78
78
|
**Single-tenant in v1.5** — one process serves one workspace token. Run one process per token if you need multi-tenant, or wait for v2 which adds per-request token binding. Most "I want HTTP" use cases are single-tenant anyway.
|
|
79
79
|
|
|
80
|
+
## Verify it's working
|
|
81
|
+
|
|
82
|
+
Three checks, cheapest first — climb until one fails and that's your problem:
|
|
83
|
+
|
|
84
|
+
1. **`health`** — no token, no network, no credits. Confirms the server process launched and speaks MCP. It's the first thing to click in the MCP Inspector; from an agent, ask *"call the zaai-dev health tool"*. Returns `{ ok, version, node, uptimeSeconds }`.
|
|
85
|
+
2. **`whoami`** — needs your token, still free. The first call that reaches the workspace: it returns your `userId`, `orgId`, project scope, and credit balance. If this works, your token is valid and you're fully connected. Ask *"call whoami"*.
|
|
86
|
+
3. **`list_captures`** — needs token **and** real data (costs 1 credit). Returns your newest captures; if ids come back, the whole pipeline works end to end.
|
|
87
|
+
|
|
88
|
+
Reading the result:
|
|
89
|
+
|
|
90
|
+
- `health` works but `whoami` returns **`Unauthorized`** → the token is wrong/revoked, or you pasted an **extension** token (`zaai_ext_*`) instead of an **MCP** one (`zaai_mcp_*`). Mint a fresh `mcp` token at [/dev/settings/tokens](https://zaaidev.com/dev/settings/tokens) and restart your client.
|
|
91
|
+
- `health` itself doesn't run → the server never booted. Almost always a missing/blank `ZAAI_API_TOKEN` in your client config (the process fails fast on startup). Check the env block, then restart.
|
|
92
|
+
|
|
93
|
+
No client handy? Smoke-test the stdio binary straight from a terminal — initialize and call `health` over JSON-RPC (any non-empty `zaai_mcp_*` value gets you past the boot check, since `health` never hits the network):
|
|
94
|
+
|
|
95
|
+
```sh
|
|
96
|
+
printf '%s\n' \
|
|
97
|
+
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}' \
|
|
98
|
+
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
|
|
99
|
+
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"health","arguments":{}}}' \
|
|
100
|
+
| ZAAI_API_TOKEN=zaai_mcp_smoke npx -y @zaai-dev/mcp
|
|
101
|
+
# → {"ok":true,"version":"0.6.1", ...}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
See [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) for the full first-install checklist.
|
|
105
|
+
|
|
80
106
|
## Tools
|
|
81
107
|
|
|
82
108
|
All tools except `health` need a valid token. All tools except `health` and `whoami` charge credits per successful call (your workspace plan determines the monthly grant — see [pricing](https://zaaidev.com/dev/pricing)).
|
package/dist/bin/http.js
CHANGED
|
@@ -12,7 +12,7 @@ import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js
|
|
|
12
12
|
import { z } from "zod";
|
|
13
13
|
|
|
14
14
|
// src/version.ts
|
|
15
|
-
var PKG_VERSION = true ? "0.6.
|
|
15
|
+
var PKG_VERSION = true ? "0.6.2" : "0.0.0-dev";
|
|
16
16
|
|
|
17
17
|
// src/tools/health.ts
|
|
18
18
|
var healthInputSchema = z.object({});
|
package/dist/bin/stdio.js
CHANGED
|
@@ -10,7 +10,7 @@ import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js
|
|
|
10
10
|
import { z } from "zod";
|
|
11
11
|
|
|
12
12
|
// src/version.ts
|
|
13
|
-
var PKG_VERSION = true ? "0.6.
|
|
13
|
+
var PKG_VERSION = true ? "0.6.2" : "0.0.0-dev";
|
|
14
14
|
|
|
15
15
|
// src/tools/health.ts
|
|
16
16
|
var healthInputSchema = z.object({});
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zaai-dev/mcp",
|
|
3
3
|
"mcpName": "io.github.POLONIBOI/zaai-dev-mcp",
|
|
4
|
-
"version": "0.6.
|
|
4
|
+
"version": "0.6.2",
|
|
5
5
|
"description": "Zaai Dev MCP server — exposes your captures, brand brief, and design docs to MCP-compatible AI tools.",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"license": "MIT",
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
"captures"
|
|
25
25
|
],
|
|
26
26
|
"bin": {
|
|
27
|
+
"mcp": "./dist/bin/stdio.js",
|
|
27
28
|
"zaai-dev-mcp": "./dist/bin/stdio.js",
|
|
28
29
|
"zaai-dev-mcp-http": "./dist/bin/http.js"
|
|
29
30
|
},
|