@@ -7,42 +7,53 @@ import ClientIntro from '../_partials/_client-config-intro.mdx';
77
88<ClientIntro term = ' Connect' />
99
10- ## Manage client connections
10+ ## Manage clients
1111
12- ToolHive automatically discovers supported AI clients that are installed on your
13- system. These are displayed on the ** Clients** page. This discovery is dynamic:
14- if you install a new client, ToolHive automatically updates the list.
12+ ToolHive automatically discovers supported AI clients installed on your system.
13+ To choose which clients ToolHive configures, open the ** MCP Servers** page and
14+ click ** Manage Clients** . This opens a dialog that lists detected clients with
15+ on/off toggles. Discovery is dynamic: if you install a new client, ToolHive
16+ updates the list.
1517
1618### Connect a client
1719
18- To connect a client to ToolHive, toggle the switch under the client's name.
20+ To connect a client to ToolHive:
1921
20- When you connect a client, ToolHive automatically configures it to use your
21- currently running MCP servers. Any new servers you start are also added.
22+ 1 . Go to ** MCP Servers** and click ** Manage Clients** .
23+ 2 . Turn on the toggle for the client you want to connect.
24+ 3 . Click ** Save** to apply your changes.
2225
23- When you stop or remove an MCP server, ToolHive updates the client's
24- configuration to remove the server.
26+ When you connect a client and save, ToolHive configures it to use your running
27+ MCP servers. Any new servers you start are also added automatically. When you
28+ stop or remove an MCP server, ToolHive updates the client's configuration to
29+ remove the server.
2530
2631### Disconnect a client
2732
28- When you disconnect a client, ToolHive removes all MCP server configurations
29- from the client. The client will no longer be able to use any ToolHive-managed
30- MCP servers.
33+ To disconnect, open ** Manage Clients** , turn off the client's toggle, then click
34+ ** Save** . ToolHive removes the MCP server configurations from that client. The
35+ client can no longer use ToolHive-managed MCP servers.
36+
37+ ### Save your changes
38+
39+ Changes you make in ** Manage Clients** are not applied until you click ** Save** .
40+ If you close the dialog or click ** Cancel** without saving, your toggle changes
41+ are discarded.
3142
3243## Why don't I see my client?
3344
34- If you don't see your client listed , ToolHive might not support it, or its
35- configuration file might not be in a location ToolHive recognizes.
45+ If you don't see your client in ** Manage Clients ** , ToolHive might not support
46+ it, or its configuration file might not be in a location ToolHive recognizes.
3647
3748For a list of supported clients and how ToolHive detects them, see the
3849[ client compatibility reference] ( ../reference/client-compatibility.mdx ) .
3950
4051## Why do I still see a client I uninstalled?
4152
4253Many clients leave behind configuration files even after you uninstall them.
43- ToolHive detects these files and continues to show the client in the UI. If you
44- want to remove the client from ToolHive, delete its configuration files
45- manually.
54+ ToolHive detects these files and continues to show the client in the ** Manage
55+ Clients ** dialog. If you want to remove the client from ToolHive, delete its
56+ configuration files manually.
4657
4758## Manual client configuration
4859
0 commit comments