Skip to Content
MCP ServerInstallation

Installation

Set up the Thunder Client MCP server in your AI tool in a few minutes. No login or API key is needed.

Requirements

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.

Run the following command in your terminal:

claude mcp add thunderclient -- npx -y thunderclient-mcp

Verify: 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

ProblemSolution
tc not foundThe 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 installnpm 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 startRun 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 CLIYour CLI is older than version 2.1.0. Update it with npm install -g @thunderclient/cli@latest.
projectDir must be an absolute pathGive the full path to your project, such as /Users/john/my-project, not a relative path like ./my-project.
No collections foundAsk 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 resolveCreate an environment in Thunder Client → Environments, add the variable, and set it as active.
Server not listed in your AI toolCheck the configuration file for JSON syntax errors, then fully restart the AI tool.

Next Steps

Last updated on