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

# Ports (Hosts)

> Connect to AI development tools and sync your server fleet.

The **Ports** page lets you connect Harbor to your AI development tools and sync your MCP server fleet to each one.

## Supported Hosts

| Host           | Config File                                                       | Status    |
| -------------- | ----------------------------------------------------------------- | --------- |
| Claude Code    | `~/.claude.json`                                                  | Supported |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | Supported |
| Codex          | `~/.codex/config.toml`                                            | Supported |
| VS Code        | `.vscode/mcp.json`                                                | Supported |
| Cursor         | `~/.cursor/mcp.json`                                              | Supported |

## Linking a Host

1. Find the host in the list
2. Click **Link** to connect it
3. Harbor will detect the host's config file location automatically

## Automatic Syncing

Once linked, Harbor **automatically syncs** your fleet to hosts whenever you:

* Dock or undock a server
* Toggle a server on/off
* Link or unlink a host

You can also manually trigger a sync:

* **Signal** (per host) — Sync only to that specific host
* **Signal All** — Sync to every linked host at once

## How Syncing Works

When Harbor syncs to a host, it:

1. Reads the host's existing config file
2. Merges your enabled servers into the config
3. Resolves any `vault:` references to actual values from your OS keychain
4. Writes the updated config back

<Note>
  Harbor never overwrites your existing host configuration. It only adds or updates servers that Harbor manages, leaving your manually-configured servers untouched.
</Note>