> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneperfectslice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Connect Claude Desktop to the OnePerfectSlice remote MCP server using a custom connector and OAuth — no config files, no API keys.

The OnePerfectSlice MCP server is hosted, so there's no config file to edit and no key to paste. You add it as a **custom connector** and sign in through your browser.

## Connect

<Steps>
  <Step title="Open connector settings">
    In Claude Desktop, go to **Settings → Connectors**.
  </Step>

  <Step title="Add a custom connector">
    Click **Add custom connector**, then enter:

    * **Name:** `OnePerfectSlice`
    * **URL:** `https://mcp.oneperfectslice.ai/mcp`

    Save the connector.
  </Step>

  <Step title="Authenticate">
    Click **Connect** on the new connector. Your browser opens to OnePerfectSlice — log in and **select the team** whose data this connection should access. Claude Desktop receives the token and connects automatically.
  </Step>

  <Step title="Verify">
    Back in **Settings → Connectors**, confirm `OnePerfectSlice` shows as **connected**.
  </Step>
</Steps>

## Test it

Start a new conversation and try:

```
Use OnePerfectSlice to list available slices
```

You should see a tool call to `list_slices` and get back a list of your team's slices.

## Troubleshooting

| Problem                    | Solution                                                               |
| -------------------------- | ---------------------------------------------------------------------- |
| Connector won't connect    | Confirm the URL is exactly `https://mcp.oneperfectslice.ai/mcp`        |
| Browser flow didn't finish | Complete login **and** team selection, then click **Connect** again    |
| Wrong team's data          | Disconnect the connector, reconnect, and select a different team       |
| Tools don't appear         | Fully quit Claude Desktop (Cmd+Q on macOS) and relaunch                |
| Session expired            | Tokens refresh automatically; if a call fails, reconnect the connector |

## Switching teams

Each connection is scoped to one team. To switch, disconnect the connector under **Settings → Connectors**, reconnect, and select the new team during sign-in.