Skip to main content
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 installed
  • An Orchata account

​
Configuration

1

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

Add Orchata MCP Server

Click Add new MCP server and enter the following configuration:
{
  "mcpServers": {
    "orchata": {
      "url": "https://api.orchata.ai/mcp"
    }
  }
}
3

Verify Connection

Restart Cursor or reload the window. The Orchata tools should now appear in your MCP tools list.

​
Alternative: Configuration File

You can also configure MCP servers in Cursor’s configuration file:
Edit ~/.cursor/mcp.json:
{
  "mcpServers": {
    "orchata": {
      "url": "https://api.orchata.ai/mcp"
    }
  }
}

​
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:
ToolDescription
list_spacesList all spaces
create_spaceCreate a new space
get_spaceGet space details
update_spaceUpdate space properties
delete_spaceArchive a space
list_documentsList documents in a space
upload_documentUpload content
get_documentGet document details
update_documentUpdate document metadata
delete_documentDelete a document
query_spacesSemantic search
smart_queryDiscover relevant spaces
See the full MCP Tools Reference for detailed documentation on each tool.

​
Local Development

For local development with the Orchata MCP server: 
{
  "mcpServers": {
    "orchata-local": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

​
Troubleshooting

  1. Check the MCP server URL is accessible
  2. Restart Cursor after configuration changes
  3. Check Cursor’s MCP logs for 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. Verify the MCP server URL is correct
  3. For local development, ensure the server is running

​
Next Steps

MCP Tools

Learn what each tool does.

Core Concepts

Understand Spaces, Documents, and Queries.