- The Studio command-line tool (
sustudio). It works with Studio from a terminal. Every Studio module’s actions are commands, and each action answers in JSON. - The Studio connector for Claude (
sustudio-mcp). It lets Claude use one Studio module’s actions for you.
npx, which comes with Node.js.
Before you start
You need:- Node.js 24 or newer. Check with
node --version. - A Studio account.
- Your Studio address. Use the address you sign in to Studio at in your browser. For example:
https://studio.us.sensorup.com.
There is no default Studio address. Replace
<your Studio address> in every command below with your own.Pick your system
Follow the tab for your system from top to bottom.- macOS
- Linux
- Windows
1
Open Terminal and check Node.js
v24 or higher. If it does not, install the current Node.js from nodejs.org.2
Sign in to the command-line tool
npx asks Ok to proceed? (y). Answer y. See Sign in for what happens next.3
Run a first command
"session": "active". If it shows expired, run any command: the tool renews the sign-in by itself for up to 8 hours.4
Add the connector to Claude Code, or to Claude Desktop
For Claude Code, run:For Claude Desktop, open
~/Library/Application Support/Claude/claude_desktop_config.json and add the entry shown in Claude Desktop. Then restart Claude Desktop.The command-line tool
Run the tool withnpx:
Sign in with the command-line tool
You sign in once:npx @sensorup/sustudio logout.
If you run a command before you have given the tool an address, it stops and names the sign-in command to run.
The Studio connector for Claude
The connector serves one Studio module. To use several modules, add one entry for each. For example, addassets and datasets as two entries.
Each entry carries your Studio address.
Claude Code
One command adds the connector for all your projects:cmd /c in front of npx:
sustudio-datasets and datasets.
Claude Desktop
Add an entry to themcpServers section of Claude Desktop’s settings file:
npx through cmd:
Quit Claude Desktop completely and start it again after you edit the file.
Sign in from Claude
You do not need a terminal for this step. In Claude, ask it to sign you in to Studio. Claude shows a link and a one-time code. Open the link in the browser where you are signed in to Studio, check that the code matches, and approve it. You stay signed in for up to 8 hours, also when the connector restarts. After that, ask Claude to sign you in again.Claude on the web cannot run a connector on your computer. Use Claude Code or Claude Desktop.
If something goes wrong
”no Studio address is configured”
The tool or connector does not know which Studio to talk to. Fix it in one of two ways:- Add
--base-url <your Studio address>to the connector’s entry in your Claude settings. Then start the connector again. - Run the sign-in command:
npx @sensorup/sustudio login --base-url <your Studio address>.
The connector’s address differs from the saved one
The message says the address in the connector’s entry differs from the address the saved profile uses. Fix it in one of two ways:- Change the address in the connector’s entry to the address the message names.
- Give the connector a different profile name. Set
SUSTUDIO_PROFILEin the entry to a new name. In Claude Desktop, add it under"env"in the entry. In Claude Code, add--env SUSTUDIO_PROFILE=<a new name>to theclaude mcp addcommand, right after the entry name.
Node.js is too old
Ifnode --version shows a version below 24, install the current Node.js from nodejs.org. Then open a new terminal and run the command again.
Where your settings live
The tools keep your saved Studio address and sign-in in~/.config/sustudio/. On Windows, this is the .config\sustudio folder in your user folder.