Client Connection

Commands for managing MCP client connections using the gateway pattern.

Supported Clients

Client	ID	Platform	Real-time Loading
Claude Desktop	claude	macOS, Windows	No
Cursor	cursor	macOS, Windows, Linux	Yes
Windsurf	windsurf	macOS, Windows, Linux	Yes
Kiro	kiro	macOS, Windows, Linux	Yes
VS Code	vscode	macOS, Windows, Linux	Yes
Zed	zed	macOS, Windows, Linux	Yes
Claude Code	claude-code	CLI	No
Codex	codex	macOS, Windows, Linux	No
Gemini	gemini	macOS, Windows, Linux	No
Google Antigravity	antigravity	macOS, Windows, Linux	No

---

Gateway Pattern

MCP Server Manager uses a gateway pattern for client connections:

• A single mcpsm server is added to each connected client's configuration
• This server points to localhost:{port}/mcp (via supergateway or direct URL, depending on the client)
• All your configured servers are accessible through this single gateway
• When the port is changed, all connected clients are automatically updated

---

clients

List detected MCP clients and their connection status.

mcpsm clients

Output

Detected MCP Clients:

  1. Claude Desktop     ✔ Installed   Connected
  2. Cursor            ✔ Installed   Disconnected
  3. Windsurf          ✘ Not installed
  4. VS Code           ✔ Installed   Connected
  5. Zed               ✔ Installed   Disconnected
  6. Claude Code       ✘ Not installed

Status Legend:

• ✔ Connected - Client has mcpsm gateway server configured
• Disconnected - Client is installed but not connected
• ✘ Not installed - Client application not found

---

clients connect

Connect a client by adding the mcpsm gateway server to its configuration.

mcpsm clients connect <client>

Examples

# Connect Claude Desktop
mcpsm clients connect claude

# Connect Cursor
mcpsm clients connect cursor

# Connect multiple clients
mcpsm clients connect cursor
mcpsm clients connect windsurf

What Happens

1. The mcpsm gateway server is added to the client's config
2. The server proxies requests to the daemon at localhost:{port}/mcp
3. All your configured servers become accessible in that client
4. For real-time loading clients, changes appear without restart

---

clients disconnect

Disconnect a client by removing the mcpsm gateway server from its configuration.

mcpsm clients disconnect <client>

Example

# Disconnect Cursor
mcpsm clients disconnect cursor

What Happens

• The mcpsm gateway server is removed from the client's config
• The client will no longer have access to your MCP servers
• Other servers in the client's config are preserved

---

clients open

Open a client's config file in your default editor.

mcpsm clients open <client>

Examples

# Open Claude Desktop config
mcpsm clients open claude

# Open Cursor config
mcpsm clients open cursor

---

Workflow Example

1. Add your MCP servers

mcpsm add myserver
mcpsm add anotherserver

2. Connect your clients

mcpsm clients connect claude
mcpsm clients connect cursor
mcpsm clients connect windsurf

3. Use servers in clients

All your servers are now available in Claude Desktop, Cursor, Windsurf, and Zed through the mcpsm gateway.

4. Change port if needed

mcpsm port 9000

All connected clients are automatically updated with the new port!

5. Disconnect when done

mcpsm clients disconnect cursor

---

Port Changes

When you change the gateway port:

# In Settings
mcpsm settings set port 9000

# Or directly
mcpsm port 9000

Automatic Updates:

• All connected clients are automatically reconnected
• The new port is written to each client's configuration
• No manual editing required
• Real-time loading clients (Cursor, Windsurf, VS Code, Zed) see changes without restart