Setup

Connect your first machine in four steps.

No public inbound port or exposed SSH service is required. Start with read-only access and enable additional permissions only when the workflow requires them.

1. Sign in with PENROUZ ID

Your account owns devices and AI connections. Use the same identity on every machine.

2. Run the connector

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

The command starts the MCPENROUZ Node connector and immediately displays a one-time device authorization link and code. Python is not required.

3. Approve the code in your browser

Open the displayed URL, verify the machine name and requested local policy, then approve it. Codes expire and can be used only once.

4. Add MCPENROUZ to your AI client

https://mcp.penrouz.com/mcp

Complete OAuth in the browser. The AI client receives an OAuth authorization to MCPENROUZ; the device token remains with the local agent.

Recommended: keep the first connection read-only. Add write access to a specific project before enabling broader write or shell permissions.

Useful local commands

npx --yes https://mcp.penrouz.com/downloads/mcpenrouz-latest.tgz status
npx --yes https://mcp.penrouz.com/downloads/mcpenrouz-latest.tgz restart
npx --yes https://mcp.penrouz.com/downloads/mcpenrouz-latest.tgz stop
npx --yes https://mcp.penrouz.com/downloads/mcpenrouz-latest.tgz start
npx --yes https://mcp.penrouz.com/downloads/mcpenrouz-latest.tgz uninstall