Setup Guide

Get mcpr connected to mcpr Cloud in four steps. The setup command handles authentication, project/server selection, token generation, and mcpr.toml for you.

Prerequisites

An MCP server running locally (e.g., http://localhost:9000/mcp)
A terminal with curl available

1. Install mcpr

curl -fsSL https://mcpr.app/install.sh | sh

mcpr version

Docker and build-from-source options: Installation.

2. Run setup

mcpr proxy setup

This prompts you through:

Email login to mcpr Cloud (6-digit code, no password)
MCP server URL and listen port
Project and server (pick existing or create new)
Tunnel endpoint (optional — for testing with remote AI clients)
Token generation
Writes mcpr.toml to the current directory

If an mcpr.toml already exists, setup reuses its values as defaults.

3. Start the proxy

mcpr proxy run mcpr.toml

The proxy routes MCP traffic, captures events, and syncs to Cloud. If you enabled tunneling, the public HTTPS URL prints in the terminal.

4. Verify

Open your server in cloud.mcpr.app. The Overview tab shows connection status, the captured MCP schema, and recent activity.

Send a few requests through the proxy (MCP client, Studio, or the tunnel URL) and check the Logs tab to confirm events are flowing.

Observe locally

Every request lands in the local SQLite store at ~/.mcpr/store.db. Inspect it directly with sqlite3, or run:

mcpr store stats               # db size, row counts, oldest/newest events
mcpr store vacuum --before 7d  # delete records older than 7 days

For dashboards, charts, and search, use the cloud project you connected in step 2.

What you get

Component	What it does
mcpr proxy	Routes MCP traffic, captures events, exposes tunnel
Cloud project	Groups servers and tokens
Project token	Authenticates proxy → Cloud
Server dashboard	Logs, tool metrics, sessions, schema
Tunnel URL	Public HTTPS endpoint for remote AI clients

Manual setup (dashboard flow)

If you’d rather click through the dashboard instead of running mcpr proxy setup:

Sign in at cloud.mcpr.app with your email (passwordless login link).
Create Project — enter a name; slug auto-generates.
In the project, find Project Tokens → Generate project token. Copy it immediately (shown once).
Servers tab → Create Server — enter a name; slug auto-generates.

Create mcpr.toml in your working directory:

mcp = "http://localhost:9000/mcp"

[cloud]
token  = "mcpr_xxxxxxxx"
server = "dev"

Start the proxy: mcpr proxy run mcpr.toml.

To add a stable tunnel subdomain, open the server’s Tunnel Domains tab and claim a subdomain (e.g., my-app.tunnel.mcpr.app).

Next steps

Configuration — full mcpr.toml reference
CLI — proxy and query commands
Cloud Overview — what the dashboard provides
Tunnels — exposing your local MCP server to remote AI clients
Studio — debug your MCP server in the browser