> ## 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 Code

> Connect Claude Code to the OnePerfectSlice remote MCP server — add the URL, authenticate with OAuth, verify, and troubleshoot.

The OnePerfectSlice MCP server is hosted — there's nothing to install. You add the URL once and authenticate through your browser.

## Connect

<Steps>
  <Step title="Add the server">
    ```bash theme={null}
    claude mcp add --transport http ops https://mcp.oneperfectslice.ai/mcp
    ```

    Add `--scope user` to make `ops` available across all your projects:

    ```bash theme={null}
    claude mcp add --transport http ops --scope user https://mcp.oneperfectslice.ai/mcp
    ```
  </Step>

  <Step title="Authenticate">
    In Claude Code, open the MCP panel:

    ```
    /mcp
    ```

    Select **ops**, choose **Authenticate**, and your browser will open. Log in to OnePerfectSlice and **select the team** whose data this connection should access. Claude Code receives the token and reconnects automatically.
  </Step>

  <Step title="Verify">
    Run `/mcp` again — `ops` should show as **connected** with 9 tools.
  </Step>
</Steps>

## Test it

In Claude Code, try:

```
Use ops 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                                                                           |
| ---------------------------- | ---------------------------------------------------------------------------------- |
| `ops` not showing in `/mcp`  | Re-run the `claude mcp add` command, then restart Claude Code                      |
| Stuck "needs authentication" | Run `/mcp`, select `ops`, and choose **Authenticate** to complete the browser flow |
| Browser flow didn't finish   | Make sure you completed login **and** team selection; then retry from `/mcp`       |
| Wrong team's data            | Reconnect from `/mcp` and select a different team during authentication            |
| Session expired              | Tokens refresh automatically; if a call fails, re-authenticate from `/mcp`         |

## Switching teams

Each connection is scoped to one team. To point `ops` at a different team, run `/mcp`, choose **ops**, re-authenticate, and select the new team.