oneserver Logo
oneserver
Getting Started

Getting Started

This guide takes you from the first launch to a client that can use a server through OneServer.

Launch OneServer

Install OneServer for your platform, then open the application. See Installation for downloads and platform-specific steps.

Find Your Way Around

The left sidebar contains two lists:

  • Servers contains every MCP server you have added.
  • Clients contains supported MCP clients detected on your computer. Use the refresh button beside Clients to scan again.

The dashboard shows server and client totals, a Quick start section with known server templates and manual add buttons, and recent system events. Selecting a server, client, or Settings opens its details on the right.

Connect an MCP Client

OneServer detects supported clients such as Claude Desktop and Cline from their configuration files.

Client status tells you whether OneServer is managing that configuration:

  • Detected: OneServer found the client, but its connector is not installed.
  • Configured: The client launches os_connector and can use servers through OneServer.
  • Error: OneServer could not install or verify the connector configuration.

To connect a detected client:

  1. Select it under Clients.
  2. Review the configuration path.
  3. Click Install connector.
  4. Restart the client if it is already running.

Repeat this for each client you want OneServer to manage.

Add an MCP Server

From the dashboard, select a template or click Add stdio server or Add HTTP server. The add button beside Servers also opens a new stdio server form.

  • Use stdio for a local server that OneServer starts with a command. Add any environment variables the process needs.
  • Use HTTP for a remote MCP Streamable HTTP endpoint. Enter its full URL; OneServer starts OAuth automatically when the endpoint requires it.

Give the server a name, enter its command or URL, then click Discover. OneServer connects once and displays the tools, prompts, resources, and resource templates it finds. Discovery must succeed before a new server can be saved.

Changing the command or URL clears the previous discovery result. Discover the endpoint again, then click Add server or Save changes.

Give a Client Access

Servers are opt-in for each client:

  1. Select a configured client.
  2. Click Edit.
  3. Turn on each server the client should be able to use.
  4. Click Save changes.

The client can now reach those servers through OneServer’s connector.

Installation Usage Guide