@project-tracker/mcp 1.0.0 → 1.0.1

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.
Files changed (2) hide show
  1. package/README.md +10 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,12 +1,14 @@
1
1
  # @project-tracker/mcp
2
2
 
3
- MCP server for [Project Tracker](https://app.project-tracker.ai). Lets [Claude Code](https://claude.com/claude-code) and other MCP-aware AI clients read and update your tracker via tool calls `list_projects`, `create_item`, `move_item`, `update_item`, etc.
3
+ MCP server for [Project Tracker](https://app.project-tracker.ai). Plugs into any MCP-aware AI client — Cursor, Claude Code, Continue, Aider, Codex, and others to let it read and update your tracker via tool calls (`list_projects`, `create_item`, `move_item`, `update_item`, etc.) instead of curl wrangling.
4
4
 
5
- If your AI client doesn't support MCP, use the [curl-prompt path](https://app.project-tracker.ai/docs/curl-prompt.md) instead — same data, different shape.
5
+ If your AI client doesn't support MCP, use the [curl path](https://app.project-tracker.ai/docs/curl-prompt.md) instead — same data, different shape.
6
6
 
7
7
  ## Install
8
8
 
9
- Add to your Claude Code MCP config (`~/.claude/mcp.json` or the equivalent UI):
9
+ Full setup guide with troubleshooting: https://app.project-tracker.ai/docs/mcp-setup.md
10
+
11
+ Short version — add to your AI client's MCP config. The location varies (Cursor: Settings → MCP; Claude Code: `~/.claude.json`; Continue: its `config.json`; others have an equivalent), but the JSON shape is the same:
10
12
 
11
13
  ```json
12
14
  {
@@ -23,11 +25,11 @@ Add to your Claude Code MCP config (`~/.claude/mcp.json` or the equivalent UI):
23
25
  }
24
26
  ```
25
27
 
26
- Restart Claude Code. The `project-tracker` server will appear in your MCP panel with its tool catalogue.
28
+ Restart your client (or reload its MCP panel). The `project-tracker` server will appear with its tool catalogue.
27
29
 
28
30
  ### Where the API key comes from
29
31
 
30
- Log in to https://app.project-tracker.ai → **Integrations** (top right) → **Generate key** → name it (e.g. `Claude Code on my laptop`) → copy the `pt_...` token. Keys are shown once; store it in a password manager.
32
+ Log in to https://app.project-tracker.ai → **Integrations** (top right) → **Generate key** → name it (e.g. `Cursor on my laptop`, `Claude Code work machine`) → copy the `pt_...` token. Keys are shown once; store it in a password manager.
31
33
 
32
34
  The key inherits your user's permissions — owner / team-member / collaborator access to each project. If a tool call returns `Permission denied: requires X on project Y`, it's not a bug, it's your project role.
33
35
 
@@ -48,7 +50,9 @@ Full schema for each tool surfaces in your MCP client. Argument shapes mirror th
48
50
 
49
51
  ## AI behaviour prompt
50
52
 
51
- Drop the contents of https://app.project-tracker.ai/docs/mcp-prompt.md into your project's `CLAUDE.md` (or equivalent system prompt) so the AI knows how to use the tools work-claiming conventions, multi-AI safety, etc. The MCP server checks the prompt version on session start and flags via `_meta.promptUpdateAvailable` if your bundled copy is stale.
53
+ Drop the contents of https://app.project-tracker.ai/docs/mcp-prompt.md into your project's system prompt — Claude Code reads `CLAUDE.md`, Cursor uses `.cursorrules` or its Rules-for-AI panel, Continue takes a system message in its config, and so on. The prompt tells the AI the conventions work-claiming, soft-claim safety, when to use `changeLog` vs `description`, etc.
54
+
55
+ The MCP server checks the prompt version on session start and flags via `_meta.promptUpdateAvailable` if your bundled copy is stale.
52
56
 
53
57
  ## Requirements
54
58
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@project-tracker/mcp",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "MCP server for Project Tracker (app.project-tracker.ai) — lets Claude Code and other MCP-aware AI clients read and update your tracker via tool calls.",
5
5
  "type": "module",
6
6
  "bin": {