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

​
Quick Setup

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

Open Claude Settings

Open Claude Desktop and navigate to Settings → Connectors.
2

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

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.
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
See the full MCP Tools Reference for detailed documentation.

​
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

1

Locate Configuration File

Find or create your Claude Desktop configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json
Or create it:
mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
2

Add Orchata Configuration

Add the Orchata MCP server to your configuration:
{
  "mcpServers": {
    "orchata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.orchata.ai/mcp"]
    }
  }
}
The mcp-remote package handles OAuth authentication automatically. You’ll be prompted to sign in when first connecting.
3

Restart Claude Desktop

Quit Claude Desktop completely and reopen it. The Orchata tools should now be available.

​
Multiple MCP Servers

You can use Orchata alongside other MCP servers: 
{
  "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: 
{
  "mcpServers": {
    "orchata": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3001/mcp"],
    }
  }
}

​
Troubleshooting

  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
  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
  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
~/Library/Logs/Claude/
Look for MCP-related entries to diagnose connection issues.

​
Next Steps

MCP Tools

Learn what each tool does.

Resources & Prompts

Explore MCP resources and prompts.