@validate.qa/mcp 1.0.0 → 1.1.0

package/README.md

@@ -3,15 +3,23 @@
 MCP server for Validate.QA.
 
 This package lets AI IDEs like Claude Code and Cursor connect directly to your
-Validate.QA workspace over stdio. Your AI can create, edit, run, and heal tests
+Validate.QA workspace over **stdio**. Your AI can create, edit, run, and heal tests
 from inside the editor while Validate.QA handles execution, scheduling, and
 reporting on the platform side.
 
+**Chat apps (Claude Desktop, Grok, Grok Bot)** do not use this package. Paste the
+hosted connector URL `{API}/mcp` from Project Settings → MCP (OAuth; no PAT).
+Operator runbook: [docs/MCP-CONNECTORS.md](../../docs/MCP-CONNECTORS.md).
+
+**MCP Army (free forever).** This package works on the MCP Army plan with your own AI. Tools that use
+Validate.QA's AI (such as `heal_test`) return a `PLAN_FEATURE_LOCKED` error until the workspace upgrades to Solo Dev.
+Limits and the full list: [docs/MCP-ARMY.md](../../docs/MCP-ARMY.md).
+
 ## Requirements
 
 - Node.js 18+
 - A Validate.QA API URL
-- A `pat_...` personal access token
+- A `pat_...` personal access token (runner tokens `urt_` / `rt_` are rejected on `/api/mcp`)
 - A Validate.QA project ID
 
 ## Quick Start
@@ -133,7 +141,9 @@ This can create or update:
 
 ## More Docs
 
-- Full MCP guide:
+- Full MCP guide (stdio + tool reference):
   [docs/MCP.md](https://github.com/Validate-QA/validate.qa/blob/main/docs/MCP.md)
+- Remote connectors / OAuth / directory submission:
+  [docs/MCP-CONNECTORS.md](https://github.com/Validate-QA/validate.qa/blob/main/docs/MCP-CONNECTORS.md)
 - Package source:
   [packages/mcp-server](https://github.com/Validate-QA/validate.qa/tree/main/packages/mcp-server)

package/bin.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// CommonJS wrapper for Windows compatibility — npx can't run ESM bin files on Windows
+// CommonJS wrapper for Windows compatibility - npx can't run ESM bin files on Windows
 const { resolve } = require('path');
 const { execFileSync } = require('child_process');
 const entry = resolve(__dirname, 'dist', 'index.js');