Quick Reference
Installation Issues
npm ERR! 404 Not Found - @testdino/mcp
npm ERR! 404 Not Found - @testdino/mcp
https://registry.npmjs.org/.command not found: testdino-mcp
command not found: testdino-mcp
bin subdirectory. On Windows, they live in the prefix directory itself:- macOS / Linux
- Windows (PowerShell)
npx:EACCES: permission denied during global install
EACCES: permission denied during global install
npx instead of a global install. It requires no special permissions.Editor Integration
Claude Code: server not registered after claude mcp add
Claude Code: server not registered after claude mcp add
testdino does not appear, re-run the add command. Pass the token through the TESTDINO_PAT environment variable, which is what the server reads:--pat flag is ignored, so the server connects but fails authentication with a “Missing TESTDINO_PAT” error. Check that your token is correct and set as the environment variable.Cursor: TestDino not showing in Settings → MCP
Cursor: TestDino not showing in Settings → MCP
- Open your config file and validate JSON syntax (trailing commas, missing brackets):
- macOS / Linux
- Windows (PowerShell)
-
Confirm the file path Cursor reads. Common locations:
- Project:
.cursor/mcp.json - macOS/Linux home:
~/.cursor/mcp.json - Windows home:
%USERPROFILE%\.cursor\mcp.json
- Project:
- Restart Cursor fully. Quit and reopen, not reload window.
- Go to Settings → Tools & MCP and check if TestDino appears.
Claude Desktop: server not detected after restart
Claude Desktop: server not detected after restart
-
Confirm config file location for your OS:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Verify
npxworks in your terminal:
- Restart Claude Desktop completely (quit from system tray/dock, reopen).
Authentication
health returns: Invalid or expired token
health returns: Invalid or expired token
Token has expired or Token has been revoked.- Go to app.testdino.com → User Settings → Access Tokens
- Check the token’s expiration date and status
- If expired or revoked, generate a new token
- Copy the new token and update your MCP config
- Restart your MCP client
- Run
healthagain
health returns: No projects found or empty project list
health returns: No projects found or empty project list
- Go to app.testdino.com → User Settings → Access Tokens
- Open the token’s ⋯ menu and select View details to see its scope
- Ensure at least one project is included
- A token cannot be edited. To add a project, generate a new token that includes it, then revoke the old one with Revoke token
health succeeds but tools return Token is not scoped to project
health succeeds but tools return Token is not scoped to project
- Confirm the
projectIdmatches a projecthealthlists. Project names are not accepted; use the project ID. - To add a project, generate a new token that includes it, then revoke the old one.
Data Lookup
list_testruns returns empty results
list_testruns returns empty results
- Remove
by_branch,by_environment, orby_authorfilters - Extend
by_time_intervaltoweeklyormonthly - Confirm you are querying the correct project
get_run_details returns: Run not found
get_run_details returns: Run not found
- The
testrun_idmay be from a different project than what the token can access - Provide the
projectIdof the project that holds the run. Project names are not accepted - Use
list_testrunsfirst to confirm the run exists and get its exact ID
debug_testcase returns no failure data
debug_testcase returns no failure data
debug_testcase tool aggregates historical execution data. If the test case has only run once or has no recorded failures, there is not enough data for root cause analysis.Run the test case across multiple runs to build a failure history before using debug_testcase.Network Errors
ECONNREFUSED or connection timeout
ECONNREFUSED or connection timeout
- Check internet connectivity:
- macOS / Linux
- Windows (PowerShell)
-
If behind a corporate firewall or VPN, ensure outbound HTTPS (port 443) to
*.testdino.comis allowed - Check the Network Endpoints page for the full list of domains to allowlist
Rate limiting errors (429)
Rate limiting errors (429)
- Lower
limitvalues - Avoid rapid sequential calls. Add short delays between queries.