Skip to main content
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

​
Configuration

1

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”.
2

Add Orchata MCP Server

Add the following configuration:
{
  "orchata": {
    "transport": {
      "type": "http",
      "url": "https://api.orchata.ai/mcp"
    }
  }
}
3

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:
Edit ~/.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:
CategoryTools
Spaceslist_spaces, create_space, get_space, update_space, delete_space
Documentslist_documents, upload_document, get_document, update_document, delete_document
Queriesquery_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:3001/mcp"
    }
  }
}

​
Troubleshooting

  1. Check the MCP server URL is accessible
  2. Restart Windsurf completely
  3. Check Windsurf’s developer console for MCP 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
  1. Check your network connection
  2. For large queries, try reducing the limit parameter
  3. 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.