Mu
News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.
Companion to Roblox Studio's built-in MCP: open places, guard writes, Open Cloud asset uploads.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 6/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 18/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Studio Sidecar. Follow https://mcp.popnx.com/i/gjlmotea-studio-sidecar-for-roblox-studio-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a Studio Sidecar key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Studio Sidecar for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "studio-sidecar-for-roblox-studio": { "command": "npx", "args": [ "-y", "@gjlmotea/studio-sidecar-mcp" ], "env": { "ROBLOX_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ROBLOX_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Studio Sidecar tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
SettingsDeveloperEdit Config
{
"mcpServers": {
"studio-sidecar-for-roblox-studio": {
"command": "npx",
"args": [
"-y",
"@gjlmotea/studio-sidecar-mcp"
],
"env": {
"ROBLOX_API_KEY": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Studio Sidecar and tell me what you can do for me, then show me one thing✓ If Claude says it is using Studio Sidecar or shows a Studio Sidecar tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ROBLOX_CREATOR_USER_ID Roblox user ID recorded as the creator of uploaded assetsROBLOX_UPLOAD_ROOT Folders that uploads may read from, joined with the platform path delimiter: ';' on Windows (C:\assets\models;D:\decals), ':' on macOS (/Users/you/models:/Volumes/art/decals). Uploads are refused whe…ROBLOX_STUDIO_PATH Roblox Studio executable; resolved automatically when unsetDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Studio Sidecar yet
Studio Sidecar runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Studio Sidecar
B · Others in Travel, maps & weather that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Studio Sidecar key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Studio Sidecar for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user studio-sidecar-for-roblox-studio --env ROBLOX_API_KEY=your-value -- npx -y @gjlmotea/studio-sidecar-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ROBLOX_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Studio Sidecar tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user studio-sidecar-for-roblox-studio --env ROBLOX_API_KEY=your-value -- npx -y @gjlmotea/studio-sidecar-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Studio Sidecar listed as connected
Use Studio Sidecar and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Studio Sidecar or shows a Studio Sidecar tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ROBLOX_CREATOR_USER_ID Roblox user ID recorded as the creator of uploaded assetsROBLOX_UPLOAD_ROOT Folders that uploads may read from, joined with the platform path delimiter: ';' on Windows (C:\assets\models;D:\decals), ':' on macOS (/Users/you/models:/Volumes/art/decals). Uploads are refused whe…ROBLOX_STUDIO_PATH Roblox Studio executable; resolved automatically when unsetDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Studio Sidecar key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Studio Sidecar for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "studio-sidecar-for-roblox-studio": { "command": "npx", "args": [ "-y", "@gjlmotea/studio-sidecar-mcp" ], "env": { "ROBLOX_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ROBLOX_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Studio Sidecar tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
In the Studio Sidecar settings, ROBLOX_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Studio Sidecar and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Studio Sidecar or shows a Studio Sidecar tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ROBLOX_CREATOR_USER_ID Roblox user ID recorded as the creator of uploaded assetsROBLOX_UPLOAD_ROOT Folders that uploads may read from, joined with the platform path delimiter: ';' on Windows (C:\assets\models;D:\decals), ':' on macOS (/Users/you/models:/Volumes/art/decals). Uploads are refused whe…ROBLOX_STUDIO_PATH Roblox Studio executable; resolved automatically when unsetDescriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Studio Sidecar key (create it on the maker’s site) · Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Studio Sidecar for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "studio-sidecar-for-roblox-studio": { "type": "stdio", "command": "npx", "args": [ "-y", "@gjlmotea/studio-sidecar-mcp" ], "env": { "ROBLOX_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For ROBLOX_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Studio Sidecar tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
In the Studio Sidecar settings, ROBLOX_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Studio Sidecar and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Studio Sidecar or shows a Studio Sidecar tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
ROBLOX_CREATOR_USER_ID Roblox user ID recorded as the creator of uploaded assetsROBLOX_UPLOAD_ROOT Folders that uploads may read from, joined with the platform path delimiter: ';' on Windows (C:\assets\models;D:\decals), ':' on macOS (/Users/you/models:/Volumes/art/decals). Uploads are refused whe…ROBLOX_STUDIO_PATH Roblox Studio executable; resolved automatically when unsetDescriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user studio-sidecar-for-roblox-studio --env ROBLOX_API_KEY=your-value -- npx -y @gjlmotea/studio-sidecar-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"studio-sidecar-for-roblox-studio": {
"command": "npx",
"args": [
"-y",
"@gjlmotea/studio-sidecar-mcp"
],
"env": {
"ROBLOX_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"studio-sidecar-for-roblox-studio": {
"command": "npx",
"args": [
"-y",
"@gjlmotea/studio-sidecar-mcp"
],
"env": {
"ROBLOX_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"studio-sidecar-for-roblox-studio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gjlmotea/studio-sidecar-mcp"
],
"env": {
"ROBLOX_API_KEY": "your-value"
}
}
}
}ROBLOX_API_KEY secret required envROBLOX_CREATOR_USER_ID envROBLOX_UPLOAD_ROOT envROBLOX_STUDIO_PATH envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: @gjlmotea/studio-sidecar-mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account gjlmotea, which owns the repo
Code last changed 12 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for @gjlmotea/studio-sidecar-mcp@0.1.1
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/gjlmotea-studio-sidecar-for-roblox-studio-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: ROBLOX_API_KEY
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 12 days ago, and the latest version (0.1.1) reached the registry 32 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.
Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.
Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.
Compare cash vs points on hotels, flights, and cars. Checkout supported hotels and rental cars.
Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.
| This one Studio Sidecar | Mu | Award Travel Finder | Killbottleneck | Gondola Award Travel Search | Whimsical | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | Yes | No | No |
| Add with + in Claude | No | No | No | No | No | Yes |
| Basic checks | 3/3 | 4/4 | 3/3 | 3/3 | 4/4 | 4/4 |
| License | MIT | AGPL-3.0 | MIT | MIT | MIT | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
English | 繁體中文
Studio Sidecar fills the gaps in Roblox Studio's built-in MCP server. It does not replace it.
Since 2026, Roblox Studio ships its own MCP server (StudioMCP, installed with Studio, stdio transport), and the standalone Roblox/studio-rust-mcp-server repository has been archived. The built-in server has tools that no third party can rebuild: generate_mesh, generate_material and generate_procedural_model use Roblox's cloud AI with moderation; search_asset, insert_asset and upload_image carry your signed-in inventory permissions; user_keyboard_input and user_mouse_input go through CreateVirtualInput. Replacing it would throw all of that away.
So Studio Sidecar adds only what the built-in server structurally cannot do, and leaves everything else to it:
No Studio plugin is needed. 12 tools; Windows fully verified, macOS partly (see Platform support).
| Tool | Why the built-in server cannot do it |
|---|---|
roblox_get_status | Shows whether Open Cloud is configured and which folders uploads may read from |
roblox_list_studios | The built-in server lives inside one Studio process; it cannot see other Studio processes or the StudioMCP broker/stub structure |
roblox_open_place | Opening a place that is not open yet is an operating-system job: it needs a new sibling process |
roblox_cleanup_stubs | Same reason; reports by default and only terminates stubs with apply=true, never the broker |
roblox_place_guard | The built-in multi_edit writes by path, and a wrong studio_id silently overwrites another game with no undo or warning |
roblox_luau_safe | The built-in execute_luau has no PlaceId check and silently truncates output beyond 100k characters |
roblox_extract_place | There is no tool that handles the 100k truncation boundary: chunking, sentinels and per-file byte checks are left to the caller, and getting them wrong does not raise an error |
roblox_get_asset | The built-in search_asset reports the holder as creatorId, not the author |
roblox_upload_asset | AssetService:CreateAssetAsync inside Studio currently always throws not available yet |
roblox_update_asset | CreateAssetVersionAsync is unavailable in the same way |
roblox_archive_asset | The built-in server has no Open Cloud surface |
roblox_publish_place | The built-in server has no publish tool, and StudioPublishService is locked to plugins (GetService returns nil) |
Deliberately not included: script reading and writing, scene queries, execute_luau, screen_capture, playtesting. The built-in server already has them, and a second implementation would only drift.
An MCP process can be a server and a client at the same time. Studio Sidecar starts StudioMCP as its own child process and connects to it as an MCP client, which gives it the built-in execute_luau. The chunking, sentinel and byte-check machinery is then wrapped into single tools. When the client closes normally, the child process goes away too, so this route does not leak stubs.
To start StudioMCP, Studio Sidecar uses the same launcher as Roblox's setup guide. On Windows that is %LOCALAPPDATA%\Roblox\mcp.bat, run through cmd.exe /c; when mcp.bat is missing, it falls back to the most recently modified StudioMCP.exe under %LOCALAPPDATA%\Roblox\Versions\. On macOS it uses StudioMCP inside RobloxStudio.app, in /Applications or ~/Applications.
Requirements: Roblox Studio with Enable Studio as MCP server turned on (in Studio: Assistant → … → Manage MCP Servers), and Node.js 22 or newer.
Register Studio Sidecar with your AI client. Claude Code:
claude mcp add studio-sidecar --scope user \
-e ROBLOX_API_KEY=" " \ -e ROBLOX_CREATOR_USER_ID=" " \ -e ROBLOX_UPLOAD_ROOT=" " \ -e ROBLOX_PUBLISH_PLACE_IDS=" " \ -- npx -y @gjlmotea/studio-sidecar-mcp
Clients that read an mcpServers JSON config (Claude Desktop, Cursor, Gemini CLI):
{
"mcpServers": { "studio-sidecar": { "command": "npx", "args": ["-y", "@gjlmotea/studio-sidecar-mcp"], "env": { "ROBLOX_API_KEY": " ", "ROBLOX_CREATOR_USER_ID": " ", "ROBLOX_UPLOAD_ROOT": " ", "ROBLOX_PUBLISH_PLACE_IDS": " " } } } }
VS Code uses a top-level servers key instead, and each server has a type. An input variable keeps the key out of the file: VS Code asks for it the first time the server starts and stores it securely.
{
"inputs": [ { "type": "promptString", "id": "roblox-api-key", "description": "Roblox Open Cloud API key", "password": true } ], "servers": { "studio-sidecar": { "type": "stdio", "command": "npx", "args": ["-y", "@gjlmotea/studio-sidecar-mcp"], "env": { "ROBLOX_API_KEY": "${input:roblox-api-key}", "ROBLOX_CREATOR_USER_ID": " ", "ROBLOX_UPLOAD_ROOT": " " } } } }
Where each client keeps the file:
| Client | Config file |
|---|---|
| Claude Desktop | macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json. Settings → Developer → Edit Config opens it |
| Cursor | ~/.cursor/mcp.json for every project, .cursor/mcp.json inside one project |
| Gemini CLI | ~/.gemini/settings.json (user), .gemini/settings.json (project) |
| VS Code | .vscode/mcp.json in the workspace, or the user mcp.json that the MCP: Open User Configuration command opens |
Sources: Claude Desktop, Cursor, Gemini CLI, VS Code.
All variables are optional: without the key the Open Cloud tools refuse, without ROBLOX_UPLOAD_ROOT every upload is refused, without ROBLOX_PUBLISH_PLACE_IDS every publish is refused, and the other tools work as usual. Do not put the key in any config file that is tracked by version control.
Register Studio's built-in MCP server as well; script editing, screenshots and playtesting live there. The launch command on each platform, StudioMCP on macOS and cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat on Windows, comes from Roblox's setup guide.
macOS:
claude mcp add roblox-studio --scope user -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Windows:
claude mcp add roblox-studio --scope user -- cmd.exe /c "%LOCALAPPDATA%\Roblox\mcp.bat"
In a JSON config, the macOS entry is "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP", and the Windows entry is "command": "cmd.exe" with "args": ["/c", "%LOCALAPPDATA%\\Roblox\\mcp.bat"]. Register mcp.bat rather than StudioMCP.exe on Windows: mcp.bat keeps its path, while StudioMCP.exe lives in %LOCALAPPDATA%\Roblox\Versions\version- \, a folder that changes with Studio updates.
Restart the session after registering, then call roblox_get_status and check openCloudConfigured, allowedUploadRoots and publishPlaceIds.
Desktop apps started from Finder or the Start menu often do not see your shell's PATH; if the server does not start, use the absolute path of npx (or of node when running from source).
git clone https://github.com/gjlmotea/studio-sidecar-mcp.git
cd studio-sidecar-mcp corepack pnpm install --frozen-lockfile corepack pnpm run build claude mcp add studio-sidecar --scope user -- "$(which node)" "$PWD/dist/index.js"
Register with absolute paths, as above, rather than a hand-written .mcp.json that points at the project folder. Claude Code sets CLAUDE_PROJECT_DIR in the server's environment, not in its own, so a ${CLAUDE_PROJECT_DIR} reference in the command or args of a .mcp.json entry, or of a local- or user-scope entry in ~/.claude.json, needs a default such as ${CLAUDE_PROJECT_DIR:-.}. Without a default the entry still loads, claude mcp list shows a missing-variable warning, and the unexpanded ${CLAUDE_PROJECT_DIR} text is used as is. Project-scope servers from .mcp.json also need approval: interactive sessions ask before using them, while claude -p runs, Agent SDK sessions and cloud sessions load them without asking. See the Claude Code MCP documentation.
| Variable | Purpose |
|---|---|
ROBLOX_API_KEY | Open Cloud API key (Creator Dashboard → Open Cloud → API Keys). The scopes each tool needs are listed under Open Cloud API key scopes |
ROBLOX_CREATOR_USER_ID | Creator recorded in creationContext when uploading |
ROBLOX_UPLOAD_ROOT | Folders uploads may read from. Several are allowed, joined with the platform's path delimiter: ; on Windows (C:\assets\models;D:\decals), : on macOS (/Users/you/models:/Volumes/art/decals). When unset, every upload is refused |
ROBLOX_PUBLISH_PLACE_IDS | placeIds `roblox_publish_place` may publish, separated by commas. When unset, every publish is refused |
ROBLOX_STUDIO_PATH | Studio executable; resolved automatically from the current installation when unset |
ROBLOX_UPLOAD_ROOT is a deliberate guard rail: uploading sends a local file to an external service, and for Models it cannot be undone, so the MCP client may not pick arbitrary file paths. Both the file and the allowed folders are resolved with realpath before they are compared, so a symlink inside an allowed folder cannot point the upload elsewhere. The file is opened once, checked again through that open handle (still inside an allowed folder, still the same file), and the bytes that go out are read from that handle, so swapping the path after the check changes nothing. A file with more than one hard link is refused, because a hard link inside an allowed folder can be a file from anywhere else on the same volume; upload a copy instead.
ROBLOX_PUBLISH_PLACE_IDS is the PlaceId guard on the