@rectify-so/mcp 1.0.0 → 1.0.2

package/README.md

@@ -8,6 +8,70 @@ An MCP (Model Context Protocol) server to access Rectify project resources from
 npm i -g @rectify-so/mcp
 ```
 
+## Production Usage
+
+### Command Line
+
+```bash
+rectify-mcp --token mcp_xxx:userId
+```
+
+### IDE Configuration
+
+Copy just the top-level `rectify` block (do not wrap in `mcpServers` unless your IDE requires it):
+
+```json
+{
+  "rectify": {
+    "command": "npx",
+    "args": ["-y", "@rectify-so/mcp", "--token", "mcp_xxx:userId"]
+  }
+}
+```
+
+#### Claude Desktop
+
+Add to Claude Desktop config:
+
+**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`  
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "rectify": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@rectify-so/mcp",
+        "--token",
+        "mcp_xxx:userId",
+      ]
+    }
+  }
+}
+```
+
+#### Cursor
+
+Add to Cursor settings:
+
+```json
+{
+  "mcp.servers": {
+    "rectify": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@rectify-so/mcp",
+        "--token",
+        "mcp_xxx:userId",
+      ]
+    }
+  }
+}
+```
+
 ## Local Development
 
 ### Prerequisites
@@ -47,18 +111,12 @@ npx tsx src/cli.ts --token mcp_xxx:userId
 
 ### Testing with MCP Inspector
 
-The MCP Inspector is a tool to test your MCP server without an IDE:
+Run the server inside MCP Inspector:
 
-1. **Run with MCP Inspector:**
 ```bash
 npx @modelcontextprotocol/inspector node dist/cli.js --token mcp_xxx:userId
 ```
 
-2. **The inspector will:**
-   - Start your MCP server
-   - Open a web interface (usually at http://localhost:5173)
-   - Allow you to test resources and see responses
-
 ### Testing in IDE (Local Development)
 
 #### Windsurf Local Testing
@@ -95,7 +153,7 @@ Update Claude config (`%APPDATA%/Claude/claude_desktop_config.json` on Windows o
 
 Enable verbose logging to see detailed output:
 ```bash
-node dist/cli.js --token mcp_xxx:userId --base-url http://localhost:5000 --enable-feedback --enable-scan --verbose
+node dist/cli.js --token mcp_xxx:userId --verbose
 ```
 
 Check logs for:
@@ -107,92 +165,19 @@ Check logs for:
 ### Common Issues
 
 **Token validation fails:**
-- Ensure your backend server is running on the specified base URL
 - Verify the token format is correct: `mcp_xxx:userId`
-- Check that the `/v1/mcp/validate/:mcpKey` endpoint is accessible
+- Confirm the backend MCP endpoints are reachable
+- Check network connectivity from your environment to the API
 
 **Resources not showing:**
-- Make sure `--enable-feedback` or `--enable-scan` flags are set
-- Verify the backend API endpoints are working
-- Check authentication headers are being sent correctly
+- Ensure the MCP token has permissions for feedbacks and scan data
+- Inspect backend logs for API errors
 
 **IDE not connecting:**
 - Rebuild the project after code changes: `npm run build`
 - Restart your IDE after updating the config
 - Check IDE logs for MCP connection errors
-- Verify the absolute path to `dist/cli.js` is correct
-
-## Production Usage
-
-### Command Line
-
-```bash
-rectify-mcp --token mcp_xxx:userId
-```
-
-### IDE Configuration
-
-Copy just the top-level `rectify` block (do not wrap in `mcpServers` unless your IDE requires it):
-
-```json
-{
-  "rectify": {
-    "command": "npx",
-    "args": ["-y", "@rectify-so/mcp", "--token", "mcp_xxx:userId"]
-  }
-}
-```
-
-#### Claude Desktop
-
-Add to Claude Desktop config:
-
-**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`  
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "rectify": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@rectify-so/mcp-server",
-        "--enable-feedback",
-        "--enable-scan",
-        "--ide", "claude"
-      ],
-      "env": {
-        "RECTIFY_TOKEN": "mcp_xxx:userId"
-      }
-    }
-  }
-}
-```
-
-#### Cursor
-
-Add to Cursor settings:
-
-```json
-{
-  "mcp.servers": {
-    "rectify": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@rectify-so/mcp-server",
-        "--enable-feedback",
-        "--enable-scan",
-        "--ide", "cursor"
-      ],
-      "env": {
-        "RECTIFY_TOKEN": "mcp_xxx:userId"
-      }
-    }
-  }
-}
-```
+- Verify the absolute path to `dist/cli.js` is correct when running locally
 
 ## Options
 
@@ -201,9 +186,10 @@ Add to Cursor settings:
 ## Available Resources
 
 ### Feedback Resources
-- `rectify://{orgId}/{projectId}/feedbacks` - List feedbacks (assets excluded)
+- `rectify://{orgId}/{projectId}/feedbacks` - List feedbacks with optional filters (assets excluded)
 - `rectify://{orgId}/{projectId}/feedbacks/{id}` - Get feedback detail (bug-type includes debugDataUrl if available)
-- `rectify://{orgId}/{projectId}/feedbacks/overview` - Get feedback overview
+- `rectify://{orgId}/{projectId}/feedbacks/{id}/analyze-debug-data` - Analyze debug logs for a bug-type feedback
+- `rectify://{orgId}/{projectId}/feedbacks/overview` - Get feedback overview statistics
 
 ### Scan Job Resources (when enabled)
 - `rectify://{orgId}/{projectId}/scan/job` - Current scan job

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,EAAE,MAAgC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,EAAE,MAAgC,CAAA"}

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAW,uBAAuB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAW,uBAAuB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rectify-so/mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Rectify MCP Server for IDE integration",
   "main": "dist/index.js",
   "type": "module",
@@ -10,7 +10,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "cross-env NODE_ENV=development tsx src/cli.ts",
-    "start": "node dist/cli.js"
+    "start": "node dist/cli.js",
+    "deploy": "npm publish --access=public"
   },
   "homepage": "https://app.rectify.so",
   "dependencies": {