Skip to content

Commit 091fc41

Browse files
authored
reflect new Clients management location (#176)
fixes #170
1 parent 7de1b3b commit 091fc41

File tree

1 file changed

+28
-17
lines changed

1 file changed

+28
-17
lines changed

docs/toolhive/guides-ui/client-configuration.mdx

Lines changed: 28 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -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

3748
For 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

4253
Many 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

Comments
 (0)