Command Not Found If you experience issues about npx @testsprite/testsprite-mcp@latest command not found
Check if Node.js and npm are installed
node --version npm --version If Node.js is not installed, install it first: Homebrew (macOS)
Direct Download
Check if npx is available
If npx is not found (should come with npm 5.2+), update npm: npm install -g npm@latest
Try alternative installation methods
npm install -g @testsprite/mcp-server testsprite-mcp --version npm exec @testsprite/testsprite-mcp@latest
Clear npm cache if packages aren't found
After cache cleaned, verify npx can find the package npx --version npx @testsprite/testsprite-mcp@latest --help
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:
Choose your preferred solution method
Setup npm permissions mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc # or ~/.bashrc for bash source ~/.zshrc # or source ~/.bashrc
Install Latest Version npm install -g @testsprite/testsprite-mcp@latest
Verify Installation This automatically uses the latest version without permission issues: npx @testsprite/testsprite-mcp@latest --version Not recommended due to security risks
sudo npm install -g @testsprite/testsprite-mcp@latest Install nvm for clean permissions: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash nvm install node # Installs latest Node.js with proper permissions npm install -g @testsprite/testsprite-mcp@latest
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}
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.
Check current version
If version is below 22, upgrade Node.js nvm (Recommended)
Homebrew (macOS)
Direct Download
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.zshrc # or source ~/.bashrc nvm install 22 nvm use 22 nvm alias default 22 node --version After upgrading, verify installation: brew uninstall node # Remove old version if needed brew install node@22 brew link node@22 --force Visit Node.js Official Site and download Node.js 22 LTS Follow the installer instructions for your operating system.
Verify npm and npx are working
npm --version npx --version
Test TestSprite MCP installation
npx @testsprite/testsprite-mcp@latest --version 
