Skip to content

reflect new Clients management location #176

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 11, 2025
Merged

reflect new Clients management location #176

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 28 additions & 17 deletions docs/toolhive/guides-ui/client-configuration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,42 +7,53 @@ import ClientIntro from '../_partials/_client-config-intro.mdx';

<ClientIntro term='Connect' />

## Manage client connections
## Manage clients

ToolHive automatically discovers supported AI clients that are installed on your
system. These are displayed on the **Clients** page. This discovery is dynamic:
if you install a new client, ToolHive automatically updates the list.
ToolHive automatically discovers supported AI clients installed on your system.
To choose which clients ToolHive configures, open the **MCP Servers** page and
click **Manage Clients**. This opens a dialog that lists detected clients with
on/off toggles. Discovery is dynamic: if you install a new client, ToolHive
updates the list.

### Connect a client

To connect a client to ToolHive, toggle the switch under the client's name.
To connect a client to ToolHive:

When you connect a client, ToolHive automatically configures it to use your
currently running MCP servers. Any new servers you start are also added.
1. Go to **MCP Servers** and click **Manage Clients**.
2. Turn on the toggle for the client you want to connect.
3. Click **Save** to apply your changes.

When you stop or remove an MCP server, ToolHive updates the client's
configuration to remove the server.
When you connect a client and save, ToolHive configures it to use your running
MCP servers. Any new servers you start are also added automatically. When you
stop or remove an MCP server, ToolHive updates the client's configuration to
remove the server.

### Disconnect a client

When you disconnect a client, ToolHive removes all MCP server configurations
from the client. The client will no longer be able to use any ToolHive-managed
MCP servers.
To disconnect, open **Manage Clients**, turn off the client's toggle, then click
**Save**. ToolHive removes the MCP server configurations from that client. The
client can no longer use ToolHive-managed MCP servers.

### Save your changes

Changes you make in **Manage Clients** are not applied until you click **Save**.
If you close the dialog or click **Cancel** without saving, your toggle changes
are discarded.

## Why don't I see my client?

If you don't see your client listed, ToolHive might not support it, or its
configuration file might not be in a location ToolHive recognizes.
If you don't see your client in **Manage Clients**, ToolHive might not support
it, or its configuration file might not be in a location ToolHive recognizes.

For a list of supported clients and how ToolHive detects them, see the
[client compatibility reference](../reference/client-compatibility.mdx).

## Why do I still see a client I uninstalled?

Many clients leave behind configuration files even after you uninstall them.
ToolHive detects these files and continues to show the client in the UI. If you
want to remove the client from ToolHive, delete its configuration files
manually.
ToolHive detects these files and continues to show the client in the **Manage
Clients** dialog. If you want to remove the client from ToolHive, delete its
configuration files manually.

## Manual client configuration

Expand Down