URL: /docs/mcp/install/claude-desktop

---
title: Claude Desktop
description: Connect the Revised MCP server to the Claude desktop app as a custom connector, or with an API key.
---

The endpoint is `https://getrevised.com/api/mcp`.

## Custom connector (recommended)

<Steps>
  <Step title="Open the connector settings">
    Click the **+** in the chat composer, or open the **Connectors** panel from the settings menu.
  </Step>
  <Step title="Add a custom connector">
    Choose **Add custom connector** and paste `https://getrevised.com/api/mcp`. No header, no key.
  </Step>
  <Step title="Sign in">
    A browser tab opens on the Revised sign-in. Sign in and accept the consent screen. Claude stores the token and refreshes it on its own.
  </Step>
  <Step title="Verify">
    Ask: *"What plan am I on with Revised?"* — Claude should call `whoami` and report the plan, the reveals left this month and the rate limit.
  </Step>
</Steps>

The same steps work on claude.ai.

## Manual config (API key)

If you would rather use a long-lived key than OAuth, create one at [getrevised.com/account](https://getrevised.com/account) and edit the desktop app's configuration file:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "revised": {
      "url": "https://getrevised.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rvd_yourprefix_yoursecret"
      }
    }
  }
}
```

Restart the app after saving.

## Notes

- Nine tools are exposed. `reveal_domain` is the only one that can spend, and the grant is permanent — see [Tools](/docs/mcp/tools#reveal_domain).
- The reveal allowance and the hold cap are the account's, not the connector's. An assistant is bound by exactly the same limits you are.
- Holds are account-scoped: a hold taken through this connector is visible to, and releasable from, every other key and session on the account.