Skip to main content
1

Install Ultra

curl -sSL https://get.ultra.security/install.sh | sh
This auto-detects your OS and architecture, downloads the latest release from CDN, and installs the ultra binary to /usr/local/bin.
macOS .pkg installer: Download the signed and notarized .pkg from get.ultra.security/v{VERSION}/Ultra-{VERSION}-macOS.pkg and double-click to install.Custom install directory:
INSTALL_DIR=~/.local/bin curl -sSL https://get.ultra.security/install.sh | sh
See Installation for all options.
2

Run diagnostics

Verify that Ultra is installed and your system is ready:
ultra doctor
This checks your OS, detects installed MCP clients (Claude Desktop, Cursor, VS Code, Claude Code, Goose), and validates dependencies like Node.js.
3

Configure your MCP client

Run the interactive install wizard to configure your MCP client to use Ultra:
ultra install
ultra install --client claude
This configures Claude Desktop to route all MCP traffic through Ultra.
4

Add an MCP server

Search the registry and add a server:
ultra search filesystem
ultra add @modelcontextprotocol/server-filesystem
Ultra searches the official MCP Registry and npm, then adds the server to your configuration. You can also add remote servers by URL:
ultra add https://mcp.example.com/sse
5

Start the proxy

Start Ultra — your MCP client connects to Ultra, and Ultra proxies to your upstream servers:
ultra start
Ultra is now recording every MCP operation. Restart your MCP client to begin routing traffic through Ultra.
6

View traces

Open the web dashboard to see your MCP traffic:
ultra dashboard
Navigate to http://localhost:8080 to inspect traces, view audit logs, and monitor connected servers.
7

(Optional) Connect to Ultra Hub

For centralized team management, authenticate and link your gateway:
ultra login
ultra link
This syncs your traces and audit events to Ultra Hub for team-wide visibility.

What’s Next