Installation
Set up the Thunder Client MCP server in your AI tool in a few minutes. No login or API key is needed.
Requirements
- Node.js 22 or later.
- The Thunder Client extension , installed and up to date.
The MCP server installs the Thunder Client CLI automatically the first time it runs, so you don’t need to install it yourself. If tc isn’t found afterward, see Troubleshooting.
Add the MCP Server
Choose your AI tool below and follow the steps.
Claude Code
Run the following command in your terminal:
claude mcp add thunderclient -- npx -y thunderclient-mcpVerify: Restart Claude Code, then run /mcp in a session. thunderclient should be listed as connected.
Test the Connection
Once the server is connected, ask your assistant:
Check that Thunder Client is set up for my project.The assistant reports the CLI version, the data path, and your collections and environments. If anything is missing, see Troubleshooting.
Troubleshooting
| Problem | Solution |
|---|---|
tc not found | The automatic CLI install didn’t run or failed. Install it manually with npm install -g @thunderclient/cli@latest, check that tc --version works, and make sure the npm global bin directory is on your PATH. Restart your AI tool afterward. |
EACCES permission error during install | npm can’t write to its global directory. Use a Node version manager such as nvm , or change npm’s default directory , then install the CLI manually. Avoid sudo npm install. |
| Server fails to start | Run node --version and confirm it’s 22 or later. On Windows, if the server shows as disconnected, use cmd /c npx -y thunderclient-mcp as the command, for example claude mcp add thunderclient -- cmd /c npx -y thunderclient-mcp. |
No JSON output from CLI | Your CLI is older than version 2.1.0. Update it with npm install -g @thunderclient/cli@latest. |
projectDir must be an absolute path | Give the full path to your project, such as /Users/john/my-project, not a relative path like ./my-project. |
| No collections found | Ask the assistant to check your setup. Confirm that the reported data path matches where Thunder Client saves your data. If you use workspace settings, see VS Code Settings. |
{{varName}} values don’t resolve | Create an environment in Thunder Client → Environments, add the variable, and set it as active. |
| Server not listed in your AI tool | Check the configuration file for JSON syntax errors, then fully restart the AI tool. |
Next Steps
- Review the Available Tools.
- Try the Example Prompts.
Last updated on