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

# Connect your IDE

> Use sureops documentation via MCP in Cursor, VS Code, and other AI-assisted IDEs

The sureops documentation is available as an MCP (Model Context Protocol) server, hosted by Mintlify. This lets AI-assisted IDEs like Cursor and VS Code (with Copilot) query the sureops docs as context while you write integrations, runbooks, or configuration.

***

## Get your MCP endpoint URL

The MCP endpoint URL is specific to the sureops documentation project. You can find it in two places:

* **sureops dashboard** — navigate to **Settings → Integrations → MCP** to see the docs MCP URL for your organization
* **Mintlify project admin** — if you have access to the Mintlify admin panel for the sureops docs project, the URL is listed under **Admin → MCP**

The URL looks like:

```
[your-project-mcp-url]
```

Copy the full URL — you'll need it for the IDE configuration below.

***

## Cursor

Add the sureops MCP server to your Cursor configuration:

<Steps>
  <Step title="Open or create .cursor/mcp.json">
    In your project root (or your global Cursor config), open or create `.cursor/mcp.json`.
  </Step>

  <Step title="Add the sureops server">
    ```json theme={null}
    {
      "mcpServers": {
        "sureops-docs": {
          "url": "[your-project-mcp-url]"
        }
      }
    }
    ```

    Replace `[your-project-mcp-url]` with the URL from **Settings → Integrations → MCP** in your sureops dashboard.
  </Step>

  <Step title="Reload Cursor">
    Open the command palette (`Cmd/Ctrl + Shift + P`) and run **Reload Window** (or restart Cursor). The `sureops-docs` server will appear in your MCP tools list.
  </Step>
</Steps>

Once connected, Cursor's AI will be able to query sureops documentation when you ask questions like "what does the diagnosis stage do" or "how do I configure a budget limit."

***

## VS Code (GitHub Copilot)

GitHub Copilot in VS Code supports MCP servers via the `.vscode/mcp.json` configuration file (available in Copilot agent mode):

<Steps>
  <Step title="Open or create .vscode/mcp.json">
    In your project root, open or create `.vscode/mcp.json`.
  </Step>

  <Step title="Add the sureops server">
    ```json theme={null}
    {
      "servers": {
        "sureops-docs": {
          "type": "http",
          "url": "[your-project-mcp-url]"
        }
      }
    }
    ```
  </Step>

  <Step title="Open Copilot Chat in agent mode">
    In the Copilot Chat panel, switch to **Agent** mode. The sureops docs MCP server will be available as a tool for Copilot to query.
  </Step>
</Steps>

***

## Other MCP-compatible clients

Any client that supports the Model Context Protocol can connect to the sureops docs server by pointing it at your MCP endpoint URL. The server uses standard MCP transport — refer to your client's documentation for how to add a custom HTTP MCP server.

***

## Programmatic access

Beyond MCP, sureops documentation is accessible in several text-friendly formats:

### llms.txt

The docs site exposes an `/llms.txt` file at the root — a compact, LLM-friendly index of the documentation structure and key content. Load it as context in any LLM session:

```
https://docs.sureops.ai/llms.txt
```

### Per-page Markdown

Every documentation page is available as plain Markdown by appending `.md` to the URL. For example:

```
https://docs.sureops.ai/next/getting-started/core-concepts-lifecycle.md
```

Use this to fetch specific pages programmatically — for scripts, CI checks, or custom RAG pipelines that need sureops documentation as a source.

***

## Troubleshooting

**The MCP server isn't appearing in Cursor/VS Code**

1. Confirm the URL in your config file is correct and has no trailing slash
2. Check that your IDE is running a version that supports remote MCP servers (Cursor 0.44+, VS Code with Copilot agent mode)
3. Reload the window or restart the IDE after saving the config file

**I get an authentication error**

Some MCP configurations require an API key or Bearer token. If the sureops docs MCP URL requires authentication, add it to your config:

```json theme={null}
{
  "mcpServers": {
    "sureops-docs": {
      "url": "[your-project-mcp-url]",
      "headers": {
        "Authorization": "Bearer [your-token]"
      }
    }
  }
}
```

Check **Settings → Integrations → MCP** in your sureops dashboard for the correct authentication details for your endpoint.

***

## Related

* [Give feedback](/next/reference/give-feedback) — request features or report issues with the MCP integration