@productbrain/mcp 0.0.1-beta.52 → 0.0.1-beta.5217

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/.env.mcp.example CHANGED
@@ -19,5 +19,9 @@
19
19
 
20
20
  # CONVEX_SITE_URL=https://your-deployment.convex.site
21
21
 
22
+ # PB_CONNECT_GATEWAY_URL — (CLI only) Override gateway for `pb connect` token redemption.
23
+ # Takes precedence over CONVEX_SITE_URL and the production default.
24
+ # PB_CONNECT_GATEWAY_URL=https://your-custom-gateway.example.com
25
+
22
26
  # ── Debug (optional) ──────────────────────────────────────────────────
23
27
  # MCP_DEBUG=1
package/README.md ADDED
@@ -0,0 +1,67 @@
1
+ # Product Brain MCP (`@productbrain/mcp`)
2
+
3
+ Give your AI agent your product's memory. Read the Chain, capture decisions, and write back — from Claude Code, Claude Desktop, Cursor, or any MCP client.
4
+
5
+ **Requirements:** Node 18+, and an API key from Product Brain → Settings → API Keys (starts with `pb_sk_`).
6
+
7
+ ## Install
8
+
9
+ Pre-GA, always pin the `beta` tag:
10
+
11
+ ```bash
12
+ npx -y @productbrain/mcp@beta
13
+ ```
14
+
15
+ ## Connect your client
16
+
17
+ ### Claude Code
18
+
19
+ ```bash
20
+ claude mcp add productbrain \
21
+ -e PRODUCTBRAIN_API_KEY=pb_sk_your_key_here \
22
+ -- npx -y @productbrain/mcp@beta
23
+ ```
24
+
25
+ ### Claude Desktop
26
+
27
+ `claude_desktop_config.json`:
28
+
29
+ ```jsonc
30
+ {
31
+ "mcpServers": {
32
+ "productbrain": {
33
+ "command": "npx",
34
+ "args": ["-y", "@productbrain/mcp@beta"],
35
+ "env": {
36
+ "PRODUCTBRAIN_API_KEY": "pb_sk_your_key_here"
37
+ }
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
43
+ ### Cursor
44
+
45
+ `~/.cursor/mcp.json` — same `command` / `args` / `env` block as above.
46
+
47
+ ## Configuration
48
+
49
+ | Variable | Required | Default |
50
+ |---|---|---|
51
+ | `PRODUCTBRAIN_API_KEY` | yes | — your `pb_sk_` key. Workspace, user, and scope are all derived server-side from the key. |
52
+ | `CONVEX_SITE_URL` | no | Product Brain Cloud. Point at another deployment (a `*.convex.site` URL, not `*.convex.cloud`). |
53
+ | `PRODUCTBRAIN_URL` | no | Alias for `CONVEX_SITE_URL`. |
54
+ | `MCP_DEBUG` | no | Set to `1` for verbose logs on stderr. |
55
+
56
+ See `.env.mcp.example` in this package for the annotated list.
57
+
58
+ ## What your agent gets
59
+
60
+ Tools for orientation, search, capture, entry and relation management, collections, labels, workflows, and session tracking. The agent reads what governs the work before it acts, and writes decisions and tensions back as it learns them.
61
+
62
+ Prefer the terminal? [`@productbrain/cli`](https://www.npmjs.com/package/@productbrain/cli) exposes the same Chain as `pb`.
63
+
64
+ ## Links
65
+
66
+ - Product Brain — https://work.productbrain.io
67
+ - Issues — https://github.com/synergyai-os/Product-OS/issues