Model Context Protocol (MCP)
ProConnect AI assistants like Claude, Cursor, and Windsurf to your Noverload knowledge base with the Model Context Protocol.
What is MCP?
The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources. With Noverload's MCP integration, you can:
- Give AI assistants direct access to your saved content
- Search your knowledge base using semantic search
- Reference specific saved items with full transcripts and summaries
- Explore topics and synthesize insights across your entire library
- Extract frameworks and step-by-step processes from your saved content
- Save new content directly from your AI assistant
Supported AI Assistants
Noverload's MCP server works with any MCP-compatible AI assistant:
Claude Desktop
Anthropic's official desktop app with native MCP support
Cursor
AI-powered code editor with MCP integration
Windsurf
Next-gen AI coding assistant with MCP support
Step 1: Install Node.js
Node.js is a free program that runs the MCP server on your computer. If you already have it installed, skip to Step 2.
Go to nodejs.org and click the green "Download" button. It will automatically detect your operating system (Mac, Windows, or Linux).
Open the downloaded file and follow the prompts. Click "Next" or "Continue" through each screen — the default settings are fine. No need to change anything.
After installing, restart your computer so the npx command becomes available to your AI tools.
Already have Node.js? Open Terminal (Mac) or Command Prompt (Windows) and type node --version. If you see v18 or higher, you're all set.
Step 2: Get Your Configuration
Recommended: Zero-Install Configuration
No installation needed! Just copy this configuration and replace your-token-here with your actual token:
{
"mcpServers": {
"noverload": {
"command": "npx",
"args": ["-y", "noverload-mcp@latest"],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://noverload.com\",\"readOnly\":true}"
}
}
}
}✨ Why this works: NPX automatically downloads and runs the latest version of noverload-mcp. No manual installation or updates needed!
Alternative Installation Methods
View alternative installation options →
Option 2: Global Install
npm install -g noverload-mcp{
"mcpServers": {
"noverload": {
"command": "noverload-mcp",
"args": [],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://noverload.com\",\"readOnly\":true}"
}
}
}
}Option 3: Specific Version
{
"mcpServers": {
"noverload": {
"command": "npx",
"args": ["-y", "noverload-mcp@0.5.0"],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://noverload.com\",\"readOnly\":true}"
}
}
}
}Step 3: Create Your Access Token
1
Generate Your Personal Access Token
- 1. Go to Dashboard Settings
- 2. Scroll down to the "Personal Access Tokens" section
- 3. Click "New Token" and give it a name (e.g., "Claude MCP")
- 4. Copy your token immediately — it won't be shown again
- 5. We'll also show you the ready-to-paste config for your AI tool
💡 Tip: When you create a token, we generate the complete config for you. Just copy and paste — no manual editing needed.
2
Add to Your AI Assistant
After creating your token, copy the config and paste it into your AI tool. Here's how for each tool:
Claude Desktop
- Open Claude Desktop on your computer
- Click Claude in the top menu bar, then click Settings
- Click Developer in the left sidebar
- Click Edit Config — this opens a text file
- Select all the text in that file and replace it with the config you copied
- Save the file (Ctrl+S on Windows, Cmd+S on Mac)
- Fully quit Claude Desktop and reopen it
Cursor
- Open Cursor on your computer
- Click the gear icon (Settings), then click Cursor Settings
- Type "MCP" in the search bar at the top
- Click Add new global MCP server
- Paste the config you copied into the file that opens
- Save the file and restart Cursor
Windsurf
- Open Windsurf on your computer
- Go to Settings, then MCP Configuration
- Click Add Server
- Paste the config you copied
- Save and restart Windsurf
Verify Connection
- Restart your AI assistant completely
- Look for "noverload" in the MCP tools or context menu
- Try asking: "What content have I saved in Noverload?"
✅ Success: You should see your saved content listed!
Available MCP Tools
Your AI assistant gets access to 9 tools for interacting with your saved content:
search_content
Search saved content by topic, keyword, or concept. Supports semantic, hybrid, and full-text search.
"Find my saved content about productivity"get_content_details
Get full details of a specific item — summary, key insights, tags, and optionally the full transcript or article text.
"Show me the full summary of that React video"list_saved_content
Browse your saved content with optional filters by type or status.
"What YouTube videos have I saved?"explore_topic
Synthesize insights about a topic across multiple saved sources. Finds themes, connections, and knowledge gaps.
"What have I learned about marketing?"extract_frameworks
Extract step-by-step processes and repeatable methods from your saved content.
"What frameworks exist for building habits?"batch_get_content
Fetch multiple content items by ID in one request. Use after searching to retrieve several items at once.
"Get the full text of those 3 articles"save_content
Save a new URL to Noverload directly from your AI assistant.
"Save this article: https://example.com/post"list_goals
View your goals to connect saved content with what you're working toward.
"What goals do I have set up?"list_tags
See all your tags for organizing and filtering content.
"What tags do I have?"Example Use Cases
Research Assistant
"Search my saved content about machine learning and summarize the key concepts"
Claude will search your Noverload library and synthesize information from multiple sources.
Action Item Review
"What action items have I saved related to marketing strategies?"
Retrieve and organize action items extracted from your marketing content.
Content Analysis
"Analyze the productivity videos I've saved and identify common themes"
Cross-reference multiple pieces of content to find patterns and insights.
Security & Privacy
Your data security is our priority. The MCP integration includes:
- Token-based authentication - Secure API tokens with revocation support
- Encrypted connections - All data transmitted over HTTPS
- Scoped access - Tokens only access your own content
- Audit logging - Track all API access in your dashboard
- Rate limiting - Prevent abuse and ensure fair usage
Troubleshooting
Server not appearing in Claude
Ensure your configuration file is properly formatted and saved in the correct location. Restart Claude Desktop after making changes.
npx command not found
Verify installation:
node --version and
npx --version
Authentication errors
Verify your API token is correct and hasn't been revoked. Generate a new token if needed from your dashboard settings.
No results returned
Check that you have saved and processed content in your Noverload account. Content must be fully processed to appear in search results.