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

# ultra connectors

> Manage configured MCP connectors

List, add, remove, enable, and disable upstream MCP connectors.

<Note>
  `ultra servers` remains available as an alias for `ultra connectors`.
</Note>

## Usage

```bash theme={null}
ultra connectors [subcommand] [flags]
```

Running `ultra connectors` without a subcommand lists all configured connectors.

## Subcommands

### `list` (default)

List all configured connectors with status, transport info, and description.

```bash theme={null}
ultra connectors
ultra connectors list
ultra connectors ls
```

### `add`

Add a new MCP connector manually.

```bash theme={null}
ultra connectors add <name> [flags]
```

| Flag            | Short | Default | Description                                     |
| --------------- | ----- | ------- | ----------------------------------------------- |
| `--command`     |       |         | Command to execute (stdio transport)            |
| `--args`        |       |         | Command arguments (space-separated)             |
| `--url`         |       |         | Connector URL (HTTP transport)                  |
| `--description` | `-d`  |         | Connector description                           |
| `--env`         | `-e`  |         | Environment variables (`KEY=VALUE`, repeatable) |
| `--disabled`    |       | `false` | Add in disabled state                           |

```bash theme={null}
# Stdio connector
ultra connectors add filesystem \
  --command npx \
  --args "-y @modelcontextprotocol/server-filesystem /tmp"

# HTTP connector
ultra connectors add remote-api --url https://mcp.example.com/sse

# With environment variables
ultra connectors add github \
  --command npx \
  --args "-y @modelcontextprotocol/server-github" \
  --env "GITHUB_TOKEN=ghp_xxx"

# Disabled initially
ultra connectors add test-connector --command ./test-server --disabled
```

### `remove`

Remove a connector from configuration.

```bash theme={null}
ultra connectors remove <name> [flags]
```

| Flag      | Short | Default | Description              |
| --------- | ----- | ------- | ------------------------ |
| `--force` | `-f`  | `false` | Skip confirmation prompt |

Aliases: `rm`, `delete`

### `enable`

Enable a disabled connector.

```bash theme={null}
ultra connectors enable <name>
```

### `disable`

Disable a connector without removing it.

```bash theme={null}
ultra connectors disable <name>
```

<Tip>
  To re-authenticate an OAuth connector whose sign-in has expired, use the top-level [`ultra reconnect`](/cli/reconnect) command.
</Tip>

## Examples

```bash theme={null}
# List all configured connectors
ultra connectors

# Add a connector manually
ultra connectors add filesystem --command npx --args "-y @modelcontextprotocol/server-filesystem /tmp"

# Remove a connector
ultra connectors remove filesystem

# Enable/disable a connector
ultra connectors enable filesystem
ultra connectors disable filesystem
```

<Tip>
  For adding connectors from registries, use [`ultra add`](/cli/add) instead — it handles registry lookup, configuration prompts, and connection testing automatically.
</Tip>