ultra reconnect

Re-authenticate configured OAuth MCP servers from the terminal. This is the CLI equivalent of the ultra_reconnect tool. Use it when you’re working in a terminal or your MCP client can’t surface the in-app Reconnect link.

Usage

# Re-authenticate one server
ultra reconnect <server>

# Re-authenticate every server that needs it
ultra reconnect

The <server> must be an enabled HTTP upstream that authenticates with OAuth. With no server name, Ultra reconnects every enabled OAuth server whose sign-in is missing or expired. See Reconnecting every server.

Flags

Flag	Short	Default	Description
`--config`	`-c`		Path to Ultra config file

How It Works

Resolves <server> to a configured, enabled HTTP upstream
Opens your browser to sign in, and always prints the authorize URL as a headless fallback
Waits for you to finish signing in (press Ctrl+C to cancel)
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.

Reconnecting every server

Run ultra reconnect with no server name to re-authenticate everything that needs it in one pass. Ultra picks the servers to reconnect for you and skips the ones it can’t help:

Server state	Included
Sign-in missing or expired and not refreshable	Yes
Already signed in, or expired but refreshable on its own	No
Disabled, or using stdio rather than an HTTP URL	No
Authenticating with a static token or API key instead of OAuth	No

If nothing needs attention, Ultra prints Nothing to reconnect. and exits. Servers are handled one at a time, each with its own browser sign-in. While a batch is running:

Press Ctrl+C once to skip the current server and move to the next one
Press Ctrl+C twice in quick succession to stop the batch, leaving the remaining servers unattempted

A failed server doesn’t stop the run. Ultra prints the error, continues, and shows a summary at the end listing what was reconnected, skipped, failed, or never attempted. The command exits non-zero if any server was skipped, failed, or left unattempted.

Examples

# Re-authenticate an OAuth server after its sign-in expired
ultra reconnect notion

# Re-authenticate every server whose sign-in has lapsed
ultra reconnect

# Use a config file outside the default location
ultra reconnect notion --config ./ultra.yaml

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.

​Usage

​Flags

​How It Works

​Reconnecting every server

​Examples

Usage

Flags

How It Works

Reconnecting every server

Examples