Skip to main content
Connect Claude Code to your Orchata knowledge base using MCP. Once configured, Claude Code can search your documents, upload content, and manage your knowledge base directly from your terminal.

​
Prerequisites

​
Quick Setup

Add the Orchata MCP server to Claude Code with a single command: 
claude mcp add --transport http orchata https://api.orchata.ai/mcp --header "Oai-Api-Key: YOUR_API_KEY_HERE"
That’s it! Claude Code will authenticate using the API key you provided.

​
Verifying the Connection

After adding the server, verify it’s configured correctly: 
claude mcp list
You should see orchata in the list of configured MCP servers and it should say “Connected” next to it.

​
Using Orchata with Claude Code

​
Example Commands

Searching your knowledge base: 
claude "Search my Orchata knowledge base for information about API authentication"
Uploading documents: 
claude "Upload this README to the 'SDK Documentation' space in Orchata" < README.md
Managing spaces: 
claude "List all my Orchata spaces"
claude "Create a new Orchata space called 'Customer Support' for our support documentation"

​
Interactive Mode

In interactive mode, you can have conversations with Claude Code that leverage your Orchata knowledge base: 
claude
Then ask:
“What do we have documented about authentication in Orchata?”
Claude Code will use the smart_query or query_spaces tools to find relevant content.

​
Available Tools

Claude Code 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 Configuration

​
View MCP Server Details

claude mcp get orchata

​
Remove the Server

claude mcp remove orchata

​
Local Development

For local development with the Orchata MCP server: 
claude mcp add orchata-local http://localhost:3001/mcp

​
Troubleshooting

  1. Verify you ran claude mcp add successfully
  2. Check for typos in the server URL
  3. Run claude mcp list to see all configured servers
  1. Ensure you have an active Orchata account
  2. Try removing and re-adding the server: claude mcp remove orchata && claude mcp add orchata https://api.orchata.ai/mcp
  3. Clear any cached credentials and re-authenticate
  1. Verify the server URL is correct
  2. Check your network connection
  3. Ensure the Orchata API is accessible from your machine
  4. Try running a simple command like claude "List my Orchata spaces"

​
Next Steps

MCP Tools

Learn what each tool does.

Resources & Prompts

Explore MCP resources and prompts.