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

> Import existing MCP connectors into Ultra

If you already have MCP connectors configured in your agents (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="Agent">
    ## Migrate Through Your Agent

    Ask your agent to migrate your existing MCP connectors into Ultra:

    * *"Migrate my existing MCP connectors to Ultra"*
    * *"Import my MCP connectors into Ultra"*

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

    ### What happens during migration

    1. Ultra scans your agents for any MCP connectors you've already set up
    2. Duplicate connectors (configured in multiple agents) are merged automatically
    3. Your agent 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 agent** for changes to take effect.

    To verify everything is working, ask your agent:

    * *"Check my Ultra connection"*
    * *"What connectors do I have connected?"*
  </Tab>

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

    Run the migration wizard:

    ```bash theme={null}
    ultra migrate
    ```

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

    ## Non-Interactive Mode

    ```bash theme={null}
    # Migrate all discovered connectors
    ultra migrate --yes

    # Migrate from a specific agent only
    ultra migrate --from claude --yes
    ```

    ## Preview Changes

    See what would happen without making any changes:

    ```bash theme={null}
    # List discovered connectors
    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 connectors                                                        |
    | `--dry-run` |       | `false` | Preview changes without applying                                                      |
    | `--from`    |       |         | Migrate from specific agent only (`claude`, `cursor`, `codex`, `ona`, `hermes`, etc.) |

    ## After Migration

    1. **Restart your agent(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 connectors
       ultra connectors
       ```
    4. Run `ultra dashboard` to view traces
  </Tab>
</Tabs>