Weaviate Docs MCP Server
The Weaviate Docs MCP Server brings instant access to Weaviate's documentation directly into your AI development environment. Built on the Model Context Protocol (MCP), this server integrates seamlessly with tools like Claude Desktop and Cursor, allowing you to query Weaviate's documentation without leaving your IDE.
The MCP server uses kapa.ai (which in turn uses Weaviate under the hood) as its knowledge engine, which powers the search and retrieval of Weaviate documentation. The server offers:
- Instant documentation access: Search Weaviate docs without context switching.
- Multi-source knowledge base: Queries across docs, tutorials, API references, GitHub issues and community content.
- Always up-to-date: Automatically syncs with the latest Weaviate documentation.
How to setup MCP Server
Setup steps vary depending on which AI assistant you're using.
- Cursor
- VS Code
- Claude Code
- ChatGPT Desktop
- Claude Desktop
- Other
Add the following to your .cursor/mcp.json file:
{
"mcpServers": {
"weaviate-docs": {
"type": "http",
"url": "https://weaviate-docs.mcp.kapa.ai"
}
}
}
Prerequisites: VS Code 1.102+ with GitHub Copilot enabled.
Create an mcp.json file in your workspace .vscode folder:
{
"servers": {
"weaviate-docs": {
"type": "http",
"url": "https://weaviate-docs.mcp.kapa.ai"
}
}
}
Run the following command in your terminal:
claude mcp add --transport http weaviate-docs https://weaviate-docs.mcp.kapa.ai
Then run the /mcp command in Claude Code and follow the steps in your browser to authenticate.
For more information, see the Claude Code MCP documentation.
ChatGPT Desktop supports MCP servers in developer mode:
- Open ChatGPT Desktop.
- Go to Settings > Apps > Advanced settings.
- Enable Developer mode.
- Navigate to Settings > Connectors.
- Click Create and enter:
- Name: Weaviate Docs
- URL: https://weaviate-docs.mcp.kapa.ai
For more information, see the ChatGPT Desktop MCP documentation.
Claude Desktop supports MCP servers:
- Open Claude Desktop.
- Go to Settings > Connectors.
- Click Add custom connector and enter:
- Name: Weaviate Docs
- URL: https://weaviate-docs.mcp.kapa.ai
- Click on Connect and follow the steps in your browser to authenticate.
Restart Claude Desktop for changes to take effect.
For more details, see the Claude Desktop documentation.
MCP is an open protocol supported by many clients. Use the server URL https://weaviate-docs.mcp.kapa.ai and refer to your client's documentation for setup instructions.
Most clients accept the standard MCP JSON configuration format:
{
"mcpServers": {
"weaviate-docs": {
"url": "https://weaviate-docs.mcp.kapa.ai"
}
}
}
Using the MCP Server
Once configured, you can ask context-aware questions about Weaviate from within your editor. For example:
"How do I set up a hybrid search in Weaviate?"
"What are the best practices for schema design in Weaviate?"
"Search the Weaviate docs for information about BM25 algorithm"
"What's the difference between vector and keyword search in Weaviate?"
Troubleshooting
Server not showing up
- Check that the file path is correct for your OS
- Restart the app completely
- Ensure the URL is entered correctly
- Verify the config file syntax is valid JSON
Connection errors
If you see connection errors:
-
Verify the server URL is accessible:
curl https://weaviate-docs.mcp.kapa.ai -
Check your internet connection
-
Try the MCP Inspector to debug:
npx @modelcontextprotocol/inspector
No results returned
If queries return empty results:
- Check that your question is relevant to Weaviate documentation
- Try rephrasing your query
- Verify the MCP server is properly configured (test with curl)
Rate limiting
The public Weaviate MCP server may have rate limits. If you experience issues:
- Wait a few minutes before trying again
Further resources
Questions and feedback
If you have any questions or feedback, let us know in the user forum.