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

# Claude Desktop Setup

> Configure Claude Desktop to use the Orchata MCP server

Connect Claude Desktop to your Orchata knowledge base using MCP. Once configured, Claude can search your documents, upload content, and manage your knowledge base.

## Prerequisites

* [Claude Desktop](https://claude.ai/download) installed
* An Orchata account

## Quick Setup

The easiest way to connect Orchata to Claude Desktop is through the built-in Connectors feature.

<Steps>
  <Step title="Open Claude Settings">
    Open Claude Desktop and navigate to **Settings** → **Connectors**.
  </Step>

  <Step title="Add Custom Connector">
    Click **Add custom connector** and enter the following:

    * **Name:** `Orchata` (or any name you prefer)
    * **Remote MCP server URL:** `https://api.orchata.ai/mcp`

    Click **Add** to save the connector.
  </Step>

  <Step title="Connect with OAuth">
    Click **Connect** next to the Orchata connector. You'll be redirected to sign in to your Orchata account and authorize the connection.

    Once authorized, you'll be redirected back to Claude Desktop and the connector will show as **Connected**.
  </Step>
</Steps>

That's it! The Orchata tools are now available in Claude.

## Verifying the Connection

After connecting, you can verify everything is working by asking Claude:

> "What Orchata tools do you have access to?"

Claude should list the available MCP tools from Orchata.

## Using Orchata with Claude

### Example Conversations

**Searching your knowledge base:**

> You: "Search my Orchata knowledge base for information about API authentication"
>
> Claude: *uses smart\_query or query\_spaces to find relevant content*

**Uploading documents:**

> You: "Here's a new article about our pricing. Please upload it to the 'Marketing Content' space in Orchata:
>
> # Pricing Guide
>
> Our product starts at \$99/month..."
>
> Claude: *uses upload\_document to add the content*

**Managing spaces:**

> You: "Create a new Orchata space called 'Customer Support' for our support documentation"
>
> Claude: *uses create\_space to create the space*

## Available Tools

Claude has access to all 12 Orchata MCP tools:

**Space Management:**

* `list_spaces`, `create_space`, `get_space`, `update_space`, `delete_space`

**Document Management:**

* `list_documents`, `upload_document`, `get_document`, `update_document`, `delete_document`

**Querying:**

* `query_spaces`, `smart_query`

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

## Advanced Setup

If you prefer to configure the MCP server manually via the configuration file (e.g., for local development), follow these steps.

### Configuration File Setup

<Steps>
  <Step title="Locate Configuration File">
    Find or create your Claude Desktop configuration file:

    <Tabs>
      <Tab title="macOS">
        ```bash theme={null}
        ~/Library/Application Support/Claude/claude_desktop_config.json
        ```

        Or create it:

        ```bash theme={null}
        mkdir -p ~/Library/Application\ Support/Claude
        touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
        ```
      </Tab>

      <Tab title="Windows">
        ```
        %APPDATA%\Claude\claude_desktop_config.json
        ```
      </Tab>

      <Tab title="Linux">
        ```bash theme={null}
        ~/.config/Claude/claude_desktop_config.json
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Add Orchata Configuration">
    Add the Orchata MCP server to your configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "orchata": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.orchata.ai/mcp"]
        }
      }
    }
    ```

    <Note>
      The `mcp-remote` package handles OAuth authentication automatically. You'll be prompted to sign in when first connecting.
    </Note>
  </Step>

  <Step title="Restart Claude Desktop">
    Quit Claude Desktop completely and reopen it. The Orchata tools should now be available.
  </Step>
</Steps>

### Multiple MCP Servers

You can use Orchata alongside other MCP servers:

```json theme={null}
{
  "mcpServers": {
    "orchata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.orchata.ai/mcp"],
    },
    "other-server": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://other-mcp-server.com"],
    }
  }
}
```

### Local Development

For local development with the Orchata MCP server:

```json theme={null}
{
  "mcpServers": {
    "orchata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:4748/api/mcp"],
    }
  }
}
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connector not showing as Connected">
    1. Try disconnecting and reconnecting the connector
    2. Ensure you completed the OAuth authorization flow
    3. Check that you have an active Orchata account
    4. Restart Claude Desktop and try again
  </Accordion>

  <Accordion title="Claude doesn't show Orchata tools">
    1. Verify the connector shows as "Connected" in Settings → Connectors
    2. If using config file: verify it exists in the correct location and has valid JSON syntax
    3. Ensure you completely quit and reopened Claude (not just closed the window)
    4. Check Claude's logs for MCP connection 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
    4. Check that your account has access to the workspace
  </Accordion>

  <Accordion title="Finding Claude's logs">
    <Tabs>
      <Tab title="macOS">
        ```bash theme={null}
        ~/Library/Logs/Claude/
        ```
      </Tab>

      <Tab title="Windows">
        ```
        %APPDATA%\Claude\logs\
        ```
      </Tab>
    </Tabs>

    Look for MCP-related entries to diagnose connection issues.
  </Accordion>
</AccordionGroup>

## Next Steps

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

  <Card title="Resources & Prompts" icon="book-open" href="/mcp/resources">
    Explore MCP resources and prompts.
  </Card>
</CardGroup>