Skip to Content
Harness quickstartsClaude Desktop

Claude Desktop quickstart

Claude Desktop supports remote MCP servers with browser-based OAuth consent. AgentValet is a native OAuth 2.1 authorization server, so the app connects directly and the agent gets its own signing identity rather than a stored bearer token. There’s nothing to paste and nothing sitting on disk.

Requirements

Set up

  1. Sign in at app.agentvalet.ai and copy your owner ID from Settings.

  2. In Claude Desktop, open Settings → Connectors and add a remote MCP server with this URL:

    https://api.agentvalet.ai/mcp/v1/<owner-id>
  3. Approve the OAuth consent in your browser. AgentValet provisions the agent its own signing identity and records the connection in the audit log.

  4. Connect and scope platforms in the dashboard . The app can now call them through the governed proxy.

OAuth connections aren’t plan-gated, this works on every tier including Free.

Prefer a config file?

You can also add an agentvalet entry to claude_desktop_config.json instead of using the Connectors UI:

{ "mcpServers": { "agentvalet": { "url": "https://api.agentvalet.ai/mcp/v1/<owner-id>" } } }

Alternative: the MCPB extension

If you’d rather not connect over OAuth, the MCPB extension is the other supported path for Claude Desktop: download agentvalet-latest.mcpb, drag it into Claude Desktop’s extensions window, then register an agent through the CLI or the extension’s own registration flow and paste the resulting agent ID and key into its settings. See Install paths compared for the full comparison.

Confirm it loaded

Open Settings → Connectors (or the extensions panel, if you used MCPB) and confirm agentvalet shows as connected.

Make your first governed call

Ask Claude to call list_platforms. It should return the platforms approved for this agent, an empty list at first, and that’s fine. What matters is that the call succeeds: the connection authenticates correctly, the proxy is reachable, and the agent record is active.

From there, grant scopes for a platform you’ve connected in the dashboard  and try a real call.

Next

Last updated on