Skip to Content

Manage a server

Open any server from the MCP Servers tab to reach its detail page — where you manage its tools and connection.

Server info

The header shows the server name and its mcp.{'{'}shortName{'}'}.* namespace, with action buttons on the right. The Server Info card lists the connection at a glance:

FieldShows
URLThe server endpoint.
AuthThe authentication method.
StatusConnection (or OAuth token) status.
Last ConnectedWhen the server was last reached.
Namespacemcp.{'{'}shortName{'}'}.* — the prefix on every tool key.
ExecutionWhere the server’s tools run.
DescriptionIf set.
Last ErrorShown when the status is Error.
The MCP server detail page with the Server Info card and header actions

Manage tools

The Tools section header reads “Tools ({enabled} enabled / {total} total)” with a Search tools… box. For each tool you can:

  • Enable / disable it with the toggle.
  • Set its CategoryFunction, Data Pull, or Action.
  • Mark HIL (requires approval).
  • Click ▶ Test to run it.
The Tools section of the server detail page with per-tool toggle, category, HIL, and test
ℹ️

If the server no longer offers a tool it once had, that tool is marked Removed — “This tool is no longer available on the MCP server.” Disable or clean it up as needed.

Refresh, reconnect, edit, delete

The header actions:

  • Refresh — re-discovers the server’s tools (picks up new tools and marks removed ones).
  • Reconnect — for OAuth servers whose status is Token Expired, Reconnect Needed, or Revoked.
  • Disconnect — for OAuth servers; revokes the token (see OAuth servers).
  • Edit — opens Edit MCP Server to change the name, description, and (for non-template servers) URL, auth, and execution location. For Bearer Token and API Key, leave credential fields blank to keep the current values; for Custom Headers, provide all headers to replace the existing set. Template servers allow only name and description; OAuth2 credentials can’t be changed here.
  • Delete — permanently removes the server.
The Edit MCP Server dialog
⚠️

Deleting is permanent. The dialog warns it “will permanently remove the server and all discovered tools. Any agents using these tools will lose access. This action cannot be undone.”

Changing the Execution Location prompts a confirmation (“Change Execution Location?”) because it affects all tools from the server.

Common issues

  • A tool shows Removed — the MCP server dropped it. Refresh to sync, then disable or remove it.
  • New tools on the server aren’t showing — click Refresh to re-discover.
  • OAuth status isn’t Connected — use Reconnect (or re-add the server if revoked).
  • Editing won’t change credentials — for template/OAuth2 servers, credentials aren’t editable here; for others, leave credential fields blank to keep them or fill them to replace.