> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ultra.security/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Tabs>
  <Tab title="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?"*
  </Tab>

  <Tab title="Terminal">
    ## Interactive Wizard

    Run the migration wizard:

    ```bash theme={null}
    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

    ```bash theme={null}
    # 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:

    ```bash theme={null}
    # 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:
       ```bash theme={null}
       # Run diagnostics to check everything is connected
       ultra doctor -v

       # List your imported upstream servers
       ultra servers
       ```
    4. Run `ultra dashboard` to view traces
  </Tab>
</Tabs>