@testomatio/mcp 2.0.0-beta.8 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Testomat.io MCP Server
 
-Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor, etc.) to interact with Testomat.io Public API v2.
+Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor, OpenCode, etc.) to interact with Testomat.io Public API v2.
 
 ## Features
 
@@ -18,7 +18,7 @@ Model Context Protocol (MCP) server that enables AI assistants (Claude, Cursor,
 ### Installation
 
 ```bash
-npm install -g @testomatio/mcp
+npm install -g @testomatio/mcp@latest
 ```
 
 ### Configuration
@@ -48,17 +48,24 @@ export TESTOMATIO_BASE_URL=https://beta.testomat.io
 
 ### Cursor IDE
 
-Add to `.cursorrules` or settings.json:
+Add this config to `.cursor/mcp.json` in your project, or to `~/.cursor/mcp.json` for global access:
 
 ```json
 {
   "mcpServers": {
     "testomatio": {
-      "command": "testomatio-mcp",
-      "args": ["--token", "<TOKEN>", "--project", "<PROJECT_ID>"],
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@testomatio/mcp@latest",
+        "--token",
+        "<TOKEN>",
+        "--project",
+        "<PROJECT_ID>"
+      ],
       "env": {
-        "TESTOMATIO_PROJECT_TOKEN": "<TOKEN>",
-        "TESTOMATIO_PROJECT_ID": "<PROJECT_ID>"
+        "TESTOMATIO_BASE_URL": "https://app.testomat.io"
       }
     }
   }
@@ -67,12 +74,54 @@ Add to `.cursorrules` or settings.json:
 
 ### Claude Desktop
 
+Add this config to:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
 ```json
 {
   "mcpServers": {
     "testomatio": {
-      "command": "node",
-      "args": ["/path/to/mcp/index.js", "--token", "<TOKEN>", "--project", "<PROJECT_ID>"]
+      "command": "npx",
+      "args": [
+        "-y",
+        "@testomatio/mcp@latest",
+        "--token",
+        "<TOKEN>",
+        "--project",
+        "<PROJECT_ID>"
+      ],
+      "env": {
+        "TESTOMATIO_BASE_URL": "https://app.testomat.io"
+      }
+    }
+  }
+}
+```
+
+### OpenCode
+
+Add this config to `opencode.json` in your project root, or to `~/.config/opencode/opencode.json` for global access:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "testomat": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "@testomatio/mcp@latest",
+        "--token",
+        "<TOKEN>",
+        "--project",
+        "<PROJECT_ID>"
+      ],
+      "enabled": true,
+      "environment": {
+        "TESTOMATIO_BASE_URL": "https://app.testomat.io"
+      }
     }
   }
 }
@@ -152,6 +201,38 @@ src/
 
 *Either `TESTOMATIO_PROJECT_TOKEN` or `TESTOMATIO_API_TOKEN`
 
+## Corporate TLS Certificates
+
+If the MCP server runs behind a corporate proxy or TLS inspection, Node.js may reject Testomat.io HTTPS requests even when the same URL works in a browser. This usually means the company root certificate is trusted by the operating system, but not by Node.js.
+
+Use Node.js system CA support:
+
+```bash
+NODE_OPTIONS=--use-system-ca testomatio-mcp --token <TOKEN> --project <PROJECT_ID>
+```
+
+For MCP clients, pass `NODE_OPTIONS` in the server environment:
+
+```json
+{
+  "mcpServers": {
+    "testomatio": {
+      "command": "testomatio-mcp",
+      "args": ["--token", "<TOKEN>", "--project", "<PROJECT_ID>"],
+      "env": {
+        "NODE_OPTIONS": "--use-system-ca"
+      }
+    }
+  }
+}
+```
+
+If your Node.js version does not support `--use-system-ca`, export the corporate root certificate to a PEM file and use Node.js extra CA support:
+
+```bash
+NODE_EXTRA_CA_CERTS=/path/to/company-root-ca.pem testomatio-mcp --token <TOKEN> --project <PROJECT_ID>
+```
+
 ## Important Notes
 
 - **Run Status** - Use `runs_update` with `status_event` for transitions (finish, launch, rerun, etc.)
@@ -164,3 +245,16 @@ src/
 npm install
 npm run start -- --token <TOKEN> --project <PROJECT_ID>
 ```
+
+For local MCP development, point Claude Desktop to the checked-out entrypoint:
+
+```json
+{
+  "mcpServers": {
+    "testomatio-local": {
+      "command": "node",
+      "args": ["/path/to/mcp/index.js", "--token", "<TOKEN>", "--project", "<PROJECT_ID>"]
+    }
+  }
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testomatio/mcp",
-  "version": "2.0.0-beta.8",
+  "version": "2.0.0",
   "description": "Model Context Protocol server for Testomatio API",
   "main": "src/index.js",
   "bin": {

package/src/mcp/definitions/plans.js

@@ -63,8 +63,19 @@ export const PLANS_TOOLS = [
         "as_manual": {
           "type": "boolean"
         },
-        "test_plan": {
-          "type": "object"
+        "test_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of test IDs (8-char) to include in the plan. If omitted, all tests matching the plan kind are included."
+        },
+        "suite_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of suite IDs (8-char) to include in the plan. If omitted, all suites are considered."
         },
         "link": {
           "type": "array",
@@ -136,8 +147,19 @@ export const PLANS_TOOLS = [
         "as_manual": {
           "type": "boolean"
         },
-        "test_plan": {
-          "type": "object"
+        "test_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of test IDs (8-char) to include in the plan. If omitted, all tests matching the plan kind are included."
+        },
+        "suite_ids": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of suite IDs (8-char) to include in the plan. If omitted, all suites are considered."
         },
         "link": {
           "type": "array",

package/src/mcp/registry/payloads.js

@@ -253,7 +253,8 @@ export const payloadMethods = {
     kind,
     hidden,
     as_manual: asManual,
-    test_plan: testPlan,
+    test_ids: testIds,
+    suite_ids: suiteIds,
     link,
   } = {}) {
     return {
@@ -262,7 +263,8 @@ export const payloadMethods = {
       kind,
       hidden,
       as_manual: asManual,
-      test_plan: testPlan,
+      test_ids: testIds,
+      suite_ids: suiteIds,
       link,
     };
   },