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

# Cursor Setup

> Configure Cursor to use the Orchata MCP server

Connect Cursor to your Orchata knowledge base using MCP. Once configured, you can search, upload, and manage documents directly from your AI assistant.

## Prerequisites

* [Cursor](https://cursor.com/home) installed
* An Orchata account

## Configuration

<Steps>
  <Step title="Open Cursor Settings">
    Go to **Cursor Settings** → **Features** → **MCP Servers**.

    Or open the command palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and search for "MCP".
  </Step>

  <Step title="Add Orchata MCP Server">
    Click **Add new MCP server** and enter the following configuration:

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

  <Step title="Verify Connection">
    Restart Cursor or reload the window. The Orchata tools should now appear in your MCP tools list.
  </Step>
</Steps>

## Alternative: Configuration File

You can also configure MCP servers in Cursor's configuration file:

<Tabs>
  <Tab title="macOS / Linux">
    Edit `~/.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "orchata": {
          "url": "https://api.orchata.ai/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windows">
    Edit `%USERPROFILE%\.cursor\mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "orchata": {
          "url": "https://api.orchata.ai/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Using Orchata in Cursor

Once configured, you can interact with Orchata using natural language:

### Searching Knowledge

> "Search Orchata for how to configure authentication"

Cursor will use the `query_spaces` or `smart_query` tools to find relevant information.

### Uploading Documents

> "Upload this README to the Product Documentation space in Orchata"

Cursor will use `upload_document` to add content to your knowledge base.

### Managing Spaces

> "List all my Orchata spaces"
> "Create a new space called 'API Reference'"

Cursor can list, create, update, and archive spaces.

## Available Tools

Once connected, Cursor has access to all 12 Orchata MCP tools:

| Tool              | Description               |
| ----------------- | ------------------------- |
| `list_spaces`     | List all spaces           |
| `create_space`    | Create a new space        |
| `get_space`       | Get space details         |
| `update_space`    | Update space properties   |
| `delete_space`    | Archive a space           |
| `list_documents`  | List documents in a space |
| `upload_document` | Upload content            |
| `get_document`    | Get document details      |
| `update_document` | Update document metadata  |
| `delete_document` | Delete a document         |
| `query_spaces`    | Semantic search           |
| `smart_query`     | Discover relevant spaces  |

<Tip>
  See the full [MCP Tools Reference](/mcp/tools) for detailed documentation on each tool.
</Tip>

## Local Development

For local development with the Orchata MCP server:

```json theme={null}
{
  "mcpServers": {
    "orchata-local": {
      "url": "http://localhost:4748/mcp"
    }
  }
}
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tools not appearing">
    1. Check the MCP server URL is accessible
    2. Restart Cursor after configuration changes
    3. Check Cursor's MCP logs for errors
  </Accordion>

  <Accordion title="Authentication errors">
    1. Try disconnecting and reconnecting
    2. Clear your browser cache and try the OAuth flow again
    3. Ensure you have an active Orchata account
  </Accordion>

  <Accordion title="Connection timeouts">
    1. Check your network connection
    2. Verify the MCP server URL is correct
    3. For local development, ensure the server is running
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="MCP Tools" icon="wrench" href="/mcp/tools">
    Learn what each tool does.
  </Card>

  <Card title="Core Concepts" icon="lightbulb" href="/getting-started/concepts">
    Understand Spaces, Documents, and Queries.
  </Card>
</CardGroup>