Download MCPENROUZ

Q: How do I open settings after installation?

Windows: Start menu → MCPENROUZ. On Linux and macOS, run mcpenrouz manage if ~/.local/bin is in PATH. The installer also prints the full path.

Choose the installer for your system or install the app from your terminal.

The app for your system

Version 0.5.18 · No separate Node.js or Python installation needed.

Windows

Windows 10 / 11

Open the installer, then launch MCPENROUZ from the Start menu.

Download x64 ARM64 version

macOS

macOS 13.5+

Extract the ZIP and open Install MCPENROUZ.command.

Download Apple Silicon Intel version

Linux

glibc 2.28+

Download the .sh file and run sh /path/to/file.sh in your terminal.

Download x64 ARM64 version

Windows uses an LLC PENROUZ local-trust signature; a new computer may ask for confirmation. The macOS installer is not Apple-signed.

Release manifest · SHA-256 · OpenPGP

Install from your terminal

The script selects the build for your system, downloads the installer, and checks its SHA-256 before starting it.

Open Terminal and run this command to download and start the installer.

curl -fsSL --proto '=https' --tlsv1.2 https://mcp.penrouz.com/install.sh -o mcpenrouz-install.sh &&
sh mcpenrouz-install.sh

Read install.sh · Requires curl; macOS also uses unzip. A separate Node.js installation is not required.

Open PowerShell. This command downloads the script to your temporary folder and starts the installer.

& {
  Invoke-WebRequest -UseBasicParsing -Uri "https://mcp.penrouz.com/install.ps1" -OutFile "$env:TEMP\mcpenrouz-install.ps1" -ErrorAction Stop
  & "$env:TEMP\mcpenrouz-install.ps1"
}

Read install.ps1

If your PowerShell policy blocks scripts, use the Windows installer above.

If Node.js 24+ is already installed, npx downloads the current MCPENROUZ package and starts device connection.

npx --yes https://mcp.penrouz.com/downloads/mcpenrouz-latest.tgz remote

First connection: read access to your home folder. Choose another folder with --read-root. Editing, deletion, and terminal commands are off.

Confirm the device using the displayed link and PENROUZ ID. The agent then attempts to set up background operation. Wait for the startup message. If it falls back to terminal mode, keep the terminal open.

Download the Node.js package · To choose a different folder, add --read-root with its full path.

After installation

Choose folders and permissions

Open MCPENROUZ and add a project folder. Enable editing, deletion, and terminal commands when needed.

Confirm your device

Choose “Connect with PENROUZ ID”. Check the device details and confirm the code in your browser.

Connect your assistant

Open MCPENROUZ in ChatGPT or follow the guide for your AI client. Ask it to list files in an allowed folder.

Connect ChatGPT Guides for other clients

Selected folders restrict file tools. Terminal commands have your operating-system user’s permissions and are not restricted by that list.

Installation questions

Do I need Node.js or Python?

The native installer and install.sh / install.ps1 include their runtime, so neither is required. Only the npx option needs a separately installed Node.js. We recommend 24+; Node.js 22 from 22.13 is also supported.

How do I connect a server without a browser?

Run the npx remote command above. Open the confirmation address on another device and sign in with PENROUZ ID. Use the agent’s service installation for background operation.

How do I open settings after installation?

Windows: Start menu → MCPENROUZ. On Linux and macOS, run mcpenrouz manage if ~/.local/bin is in PATH. The installer also prints the full path.

Do I need to open an inbound port?

The agent connects to MCPENROUZ over outbound HTTPS. You do not need a separate inbound MCP port on your device.