Windsurf Setup

Connect Windsurf’s Cascade AI to your Orchata knowledge base using MCP. Once configured, Cascade can search your documents, upload content, and manage your knowledge base directly in your coding workflow.

Prerequisites

Windsurf installed
An Orchata account

Configuration

Open Windsurf Settings

Go to Settings → Cascade → MCP Servers.Or use the command palette (Cmd+Shift+P / Ctrl+Shift+P) and search for “MCP Settings”.

Add Orchata MCP Server

Add the following configuration:

{
  "orchata": {
    "transport": {
      "type": "http",
      "url": "https://api.orchata.ai/mcp"
    }
  }
}

Verify Connection

Restart Windsurf or reload the window. Ask Cascade about available Orchata tools to verify the connection.

Alternative: Configuration File

You can also configure MCP servers via Windsurf’s settings file:

macOS / Linux
Windows

Edit ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "orchata": {
      "transport": {
        "type": "http",
        "url": "https://api.orchata.ai/mcp"
      }
    }
  }
}

Edit %USERPROFILE%\.windsurf\mcp_config.json:

{
  "mcpServers": {
    "orchata": {
      "transport": {
        "type": "http",
        "url": "https://api.orchata.ai/mcp"
      }
    }
  }
}

Using Orchata with Cascade

Once configured, interact with Orchata using natural language in Cascade:

Searching Knowledge

“Search Orchata for API authentication examples”

Cascade will use smart_query or query_spaces to find relevant content from your knowledge base.

Uploading Documentation

“Upload this file’s documentation comments to the ‘Code Docs’ space in Orchata”

Cascade can extract and upload content to your knowledge base.

Managing Your Knowledge Base

“Show me all my Orchata spaces” “Create a new space for our internal APIs”

Cascade can manage your entire Orchata organization.

Available Tools

Cascade has access to all 12 Orchata MCP tools:

Category	Tools
Spaces	`list_spaces`, `create_space`, `get_space`, `update_space`, `delete_space`
Documents	`list_documents`, `upload_document`, `get_document`, `update_document`, `delete_document`
Queries	`query_spaces`, `smart_query`

See the full MCP Tools Reference for detailed documentation on each tool.

Workspace Rules for Better Results

Add Orchata context to your workspace rules for better AI interactions. Create .windsurf/rules.md:

# Orchata Knowledge Base

This project uses Orchata for knowledge management.

## Available Spaces
- SDK Documentation: Technical docs for our SDK
- API Reference: REST API documentation
- Tutorials: Step-by-step guides

## Usage Guidelines
- Search Orchata before answering questions about our product
- Upload new documentation to the appropriate space
- Use smart_query when unsure which space to search

Local Development

For local development with the Orchata MCP server:

{
  "orchata": {
    "transport": {
      "type": "http",
      "url": "http://localhost:4748/mcp"
    }
  }
}

Troubleshooting

Tools not appearing in Cascade

Check the MCP server URL is accessible
Restart Windsurf completely
Check Windsurf’s developer console for MCP errors

Authentication failures

Try disconnecting and reconnecting
Clear your browser cache and try the OAuth flow again
Ensure you have an active Orchata account

Slow responses

Check your network connection
For large queries, try reducing the limit parameter
Consider using more specific space IDs instead of smart_query

Next Steps

MCP Tools

Learn what each tool does.

Core Concepts

Understand Spaces, Documents, and Queries.

Getting Started

MCP Server

AI Tool Setup

CLI

TypeScript SDK

Prerequisites

Configuration

Alternative: Configuration File

Using Orchata with Cascade

Searching Knowledge

Uploading Documentation

Managing Your Knowledge Base

Available Tools

Workspace Rules for Better Results

Local Development

Troubleshooting

Next Steps

MCP Tools

Core Concepts

​Prerequisites

​Configuration

​Alternative: Configuration File

​Using Orchata with Cascade

​Searching Knowledge

​Uploading Documentation

​Managing Your Knowledge Base

​Available Tools

​Workspace Rules for Better Results

​Local Development

​Troubleshooting

​Next Steps

MCP Tools

Core Concepts

Prerequisites

Configuration

Alternative: Configuration File

Using Orchata with Cascade

Searching Knowledge

Uploading Documentation

Managing Your Knowledge Base

Available Tools

Workspace Rules for Better Results

Local Development

Troubleshooting

Next Steps