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

# Cursor

> Connect Cursor to the OnePerfectSlice remote MCP server with OAuth — add the URL in MCP settings.

Cursor connects to the hosted OnePerfectSlice server over HTTP and signs in with OAuth. Nothing to install.

## Connect

<Steps>
  <Step title="Open MCP settings">
    In Cursor, open **Settings → Tools & Integrations** (the MCP section) and choose **Add custom MCP / New MCP server**. This opens the `mcp.json` config — global at `~/.cursor/mcp.json`, or per-project at `.cursor/mcp.json`.
  </Step>

  <Step title="Add the server">
    Add the OnePerfectSlice URL. A remote server needs only `url` — no `type` or `transport` field:

    ```json theme={null}
    {
      "mcpServers": {
        "ops": {
          "url": "https://mcp.oneperfectslice.ai/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Authenticate">
    Cursor detects that the server requires OAuth and shows a **Sign in / Authenticate** prompt for `ops`. Click it, log in to OnePerfectSlice, and **select the team** whose data this connection should access.
  </Step>

  <Step title="Verify">
    In **Settings → MCP**, confirm `ops` is enabled and its tools are listed.
  </Step>
</Steps>

## Test it

In Cursor's chat (Agent mode), try:

```
Use ops to list available slices
```

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

## Troubleshooting

| Problem              | Solution                                                                    |
| -------------------- | --------------------------------------------------------------------------- |
| `ops` shows no tools | Click **Authenticate** next to `ops` in Settings → MCP and complete sign-in |
| Authentication loops | Confirm the URL is exactly `https://mcp.oneperfectslice.ai/mcp`, then retry |
| Wrong team's data    | Remove `ops` from `mcp.json`, re-add it, and select a different team        |
| Tools not used       | Make sure you're in Agent mode and `ops` is enabled                         |

## Switching teams

Each connection is scoped to one team. To switch, remove and re-add the `ops` entry, then select the new team during sign-in.