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

# MCP Overview

> Connect AI assistants to your Orchata knowledge base

The **Model Context Protocol (MCP)** is an open standard for connecting AI assistants to external data sources. Orchata's MCP server lets AI tools like Claude Desktop, Claude Code, Cursor, and Windsurf interact directly with your knowledge base.

## What is MCP?

MCP provides a standardized way for AI assistants to:

* **Discover** available tools, resources, and prompts
* **Execute** operations like searching and uploading documents
* **Access** your organization's knowledge in real-time

<Info>
  Learn more about MCP at [modelcontextprotocol.io](https://modelcontextprotocol.io).
</Info>

<Warning>
  MCP access requires a Developer or Pro plan. [View plans](/getting-started/plans) to upgrade.
</Warning>

## Why Use MCP with Orchata?

<CardGroup cols={2}>
  <Card title="Real-Time Access" icon="bolt">
    AI assistants query your live knowledge base, not stale snapshots.
  </Card>

  <Card title="No Code Required" icon="wand-magic-sparkles">
    Configure once, and your AI tools can search and update Orchata.
  </Card>

  <Card title="Full Functionality" icon="toolbox">
    12 MCP tools expose all Orchata features to AI assistants.
  </Card>

  <Card title="Secure" icon="shield-check">
    OAuth authentication with the same permissions and audit trail.
  </Card>
</CardGroup>

## Use Cases

### AI-Powered Search

Let Claude or Cursor search your documentation, codebase knowledge, or support articles:

> "Search Orchata for how to configure authentication"

The AI uses `query_spaces` to find relevant content and synthesizes an answer.

### Automated Documentation

Use AI to help maintain your knowledge base:

> "Upload this README to the SDK Documentation space"

The AI uses `upload_document` to add content directly to Orchata.

### Smart Space Discovery

AI can find the right space to search without you specifying:

> "Find information about our API rate limits"

The AI uses `smart_query` to discover relevant spaces, then searches them.

## Getting Started

<Steps>
  <Step title="Create an Account">
    Sign up at [app.orchata.ai](https://app.orchata.ai) if you haven't already.
  </Step>

  <Step title="Configure Your AI Tool">
    Add the Orchata MCP server to your AI tool and connect via OAuth.
  </Step>

  <Step title="Start Using">
    Ask your AI assistant to search, upload, or manage your Orchata knowledge base.
  </Step>
</Steps>

## MCP Server URLs

| Environment | URL                          |
| ----------- | ---------------------------- |
| Production  | `https://api.orchata.ai/mcp` |
| Development | `http://localhost:3002`      |

## Authentication

The MCP server uses OAuth for authentication. When you first connect, you'll be prompted to sign in to your Orchata account and authorize the connection.

<Note>
  The MCP server uses your account permissions. Ensure your account has the necessary access for the operations you want to perform.
</Note>

## Available Features

The Orchata MCP server exposes:

| Feature       | Count | Description                                        |
| ------------- | ----- | -------------------------------------------------- |
| **Tools**     | 12    | CRUD operations for spaces, documents, and queries |
| **Resources** | 4     | Documentation and dynamic space information        |
| **Prompts**   | 2     | Guided workflows for RAG implementation            |

## Next Steps

<CardGroup cols={2}>
  <Card title="MCP Tools" icon="wrench" href="/mcp/tools">
    Explore all 12 available MCP tools.
  </Card>

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

  <Card title="Cursor Setup" icon="https://cdn.simpleicons.org/cursor/000000/white" href="/mcp/setup/cursor">
    Configure Cursor for Orchata MCP.
  </Card>

  <Card title="Claude Desktop" icon="https://cdn.simpleicons.org/anthropic/000000/white" href="/mcp/setup/claude">
    Configure Claude Desktop for Orchata MCP.
  </Card>

  <Card title="Claude Code" icon="https://cdn.simpleicons.org/anthropic/000000/white" href="/mcp/setup/claude-code">
    Configure Claude Code for Orchata MCP.
  </Card>

  <Card title="Windsurf Setup" icon="https://cdn.simpleicons.org/windsurf/000000/white" href="/mcp/setup/windsurf">
    Configure Windsurf for Orchata MCP.
  </Card>
</CardGroup>