MCP Setup Guide

What is MCP?

Model Context Protocol (MCP) lets AI tools like Claude and Cursor call external services directly. With QVN's MCP integration, you can ask your AI assistant to generate social notes from a Substack URL without leaving your editor.

Prerequisites

You need a QVN account with an active API key. Generate one from Settings → API Keys. The key looks like qvn_xxxxxxxxxxxxxxxx.

Configure Claude Desktop

Add QVN to your Claude Desktop MCP config file at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "quick-viral-notes": {
      "command": "npx",
      "args": ["-y", "@quickviralnotes/mcp"],
      "env": {
        "QVN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Configure Cursor

In Cursor settings, go to Features → MCP Servers and add a new server with the same config. Restart Cursor after saving.

Usage

Once connected, ask your AI: 'Generate viral notes from this Substack article: [URL]'. QVN will process the article and return generated notes inline in your conversation.

Troubleshooting

If the MCP server doesn't appear, check that your API key is valid and the JSON config is properly formatted. API keys expire if unused for 90 days — regenerate from Settings if needed.