​
Command Not Found

If you experience issues about npx @testsprite/testsprite-mcp@latest command not found. Please follow the solution below:
1

Check if Node.js and npm are installed

node --version
npm --version
If Node.js is not installed, install it first:
brew install node
2

Check if npx is available

npx --version
If npx is not found (should come with npm 5.2+), update npm:
npm install -g npm@latest
3

Try alternative installation methods

npm install -g @testsprite/mcp-server
testsprite-mcp --version
4

Clear npm cache if packages aren't found

npm cache clean --force
After cache cleaned, verify npx can find the package
npx --version
npx @testsprite/testsprite-mcp@latest --help
5

Check npm registry connectivity

npm ping
npm config get registry

​
Permission Errors

If you experience issues about Permission denied when installing @testsprite/testsprite-mcp globally. Please follow the solution below:
1

Choose your preferred solution method

2

Troubleshooting permission issues on macOS

If you still get permission errors, check npm ownership:
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
3

For fresh npm setup on macOS

sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin

​
Node.js Version Compatibility

If you experience issues about TestSprite MCP Server requires Node.js 22+. Please follow the solution below:
Node.js 22 is required for optimal compatibility with TestSprite MCP Server features and dependencies.
1

Check current version

node --version
If version is below 22, upgrade Node.js
2

Verify npm and npx are working

npm --version
npx --version
3

Test TestSprite MCP installation

npx @testsprite/testsprite-mcp@latest --version