Skip to main content
Re-authenticate one configured OAuth MCP server from the terminal. This is the CLI equivalent of the ultra_reconnect tool — useful when you’re working in a terminal or your MCP client can’t surface the in-app Reconnect link.

​
Usage

The <server> must be an enabled HTTP upstream that authenticates with OAuth.

​
How It Works

  1. Resolves <server> to a configured, enabled HTTP upstream
  2. Opens your browser to sign in, and always prints the authorize URL as a headless fallback
  3. Waits for you to finish signing in (press Ctrl+C to cancel)
  4. Saves the new token to Ultra’s shared credential store
Because the CLI can’t refresh a client that is already running, restart your MCP client (or ultra start) afterward so its Ultra gateway process loads the new token.

​
Examples

ultra reconnect only applies to OAuth servers. If the server authenticates with a token or API key instead, update its credential with ultra config set-token <server> (see Authentication). Ultra returns a clear error if the server is unknown, disabled, uses stdio transport, or doesn’t use browser-based OAuth.