Claude Desktop[01]

MCP in Claude Desktop

Add Onto as a custom connector: paste one URL and sign in with your Onto account. No key to paste, nothing to install.

Install steps

[02]
Open Connectors

In Claude Desktop: Settings → Connectors → Add custom connector.

Paste the URL

Name it Onto and paste:

Connector URL[url]
https://api.buildonto.dev/mcp
Connect and approve

Click Connect. Claude opens Onto's sign-in — sign in with your Onto account and approve. No account yet? The free tier is 1,000 credits a month.

Run it locally instead

[03]

The local server (@ontosdk/mcp, Node 20+) runs on your machine and uses an API key instead of a sign-in. Get a key at app.buildonto.dev/read/keys — the server exits straight away without ONTO_API_KEY. In Claude Desktop, open Settings → Developer → Edit Config and add:

claude_desktop_config.json[json]
claude_desktop_config.json
{
  "mcpServers": {
    "onto": {
      "command": "npx",
      "args": ["-y", "@ontosdk/mcp@latest"],
      "env": {
        "ONTO_API_KEY": "onto_sk_live_YOUR_KEY"
      }
    }
  }
}

Then fully quit and reopen Claude. On macOS the close button only hides the window — Cmd+Q quits. On Windows, quit from the system tray.

OS · Path
macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Claude Desktop vs Claude Code

[04]

Two different Anthropic products, same vendor. Claude Desktop is the macOS / Windows desktop app (chat UI); Claude Code is the CLI / IDE extension. Both connect to Onto by URL, in different places:

Product · How to add an MCP server
Claude Desktop

Settings → Connectors → Add custom connector, paste the URL

Claude Code

claude mcp add --scope user --transport http onto https://api.buildonto.dev/mcp

Verify

[05]

Open a new chat and check the tools menu in the input area. Onto should list all six tools: read_url, read_and_score, score_url, extract_data, map_site, and batch.