Using OneServer | oneserver Docs

OneServer keeps server configuration, client access, and operational events in one desktop interface.

Manage Servers

Added servers appear together under Servers in the left sidebar. Select one to see its transport, endpoint, timestamps, and last discovered capabilities.

Add or Edit a Server

Use a template in Quick start, choose Add stdio server or Add HTTP server, or use the add button beside Servers. Local stdio servers need a command and optional environment variables. Remote Streamable HTTP servers need an endpoint URL.

To edit an existing server, select it and click Edit. Changing its command or URL clears the stored discovery result so stale capabilities cannot be saved against a new endpoint.

Discover Capabilities

Click Discover in the server form. OneServer connects to the configured endpoint and reads its tools, prompts, resources, and resource templates. Remote OAuth is started automatically when required.

Discovery must find at least one capability before a new server can be saved. Run it again after changing an endpoint or whenever you want to refresh the stored capability list.

Remove a Server

Select the server, click Remove, and confirm. OneServer also removes that server’s client associations.

Manage Clients

OneServer scans known configuration paths for supported MCP clients. Use the refresh button beside Clients to scan again.

Select a client to see its status and configuration path:

Detected means OneServer found the client but has not installed its connector.
Configured means the client is routed through OneServer.
Error means connector installation or verification failed.

Use Install connector or Uninstall connector from the client details. Restart a running client after changing its connector configuration.

Control Server Access

Select a client, click Edit, choose the servers it can access, and click Save changes. Associations are staged in the edit form and saved together.

You can also rename a detected client in this form. Removing a client entry does not uninstall the client application or delete its configuration file; uninstall the connector first if OneServer is currently managing it.

Monitor Activity

The dashboard’s Recent activity panel combines events from the desktop app, gateway, connector, and configured servers. Open an event to inspect its source, type, timestamp, and payload. Use Load more to retrieve older events or Refresh to update the list immediately.