Migrate Servers

Import existing MCP servers into Ultra

If you already have MCP servers configured in your AI clients (Claude Desktop, Cursor, Codex, etc.), Ultra can automatically detect and import them so all your existing tools continue to work — now with full observability.

Client

Migrate Through Your AI Client

Ask your AI client to migrate your existing MCP servers into Ultra:

• “Migrate my existing MCP servers to Ultra”
• “Import my MCP servers into Ultra”

Your client will scan for any MCP servers you already have configured, show you what it found, and import them into Ultra.

What happens during migration

1. Ultra scans your AI clients for any MCP servers you’ve already set up
2. Duplicate servers (configured in multiple clients) are merged automatically
3. Your client configs are updated to route through Ultra instead of connecting directly
4. All your existing tools continue to work exactly as before

After migration, restart your AI client for changes to take effect.

To verify everything is working, ask your client:

• “Check my Ultra connection”
• “What MCP servers do I have connected?”

Terminal

Interactive Wizard

Run the migration wizard:

ultra migrate

The wizard scans your MCP clients for configured servers, shows what it found, and lets you choose which ones to import.

Non-Interactive Mode

# Migrate all discovered servers
ultra migrate --yes

# Migrate from a specific client only
ultra migrate --from claude --yes

Preview Changes

See what would happen without making any changes:

# List discovered servers
ultra migrate --list

# Dry run — preview the Ultra config that would be generated
ultra migrate --dry-run

Flags

Flag	Short	Default	Description
--config			Path to Ultra config file
--yes	-y	false	Skip confirmation prompt
--list	-l	false	List discovered MCP servers
--dry-run		false	Preview changes without applying
--from			Migrate from specific client only (claude, cursor, codex, ona, hermes, etc.)

After Migration

1. Restart your MCP client(s) to route traffic through Ultra
2. Run ultra start to start the proxy
3. Verify the migration was successful:
   # Run diagnostics to check everything is connected
   ultra doctor -v
   
   # List your imported upstream servers
   ultra servers
   
4. Run ultra dashboard to view traces