Get Started

MCP Connection

Fix MCP server connection problems with Claude Desktop, Cursor, Windsurf, and Continue. Debug configuration and connectivity issues.

The Problem

Your AI tool cannot connect to Memoria's MCP server or doesn't see the available tools.

Common Causes

  • Invalid JSON in configuration file
  • Wrong file path in config
  • AI tool not restarted after config change
  • Memoria not installed globally

Solutions

Validate JSON Configuration

Ensure your configuration file has valid JSON syntax. Use a JSON validator to check for missing commas, brackets, or quotes.

{
  "mcpServers": {
    "memoria": {
      "command": "npx",
      "args": ["@byronwade/memoria"]
    }
  }
}

Restart Your AI Tool

Completely quit and reopen your AI tool (Claude Desktop, Cursor, etc.) after making configuration changes.

Check Tool Availability

Ask your AI assistant: 'What MCP tools do you have available?' to verify the connection.

Enable Verbose Logging

Run Memoria with verbose logging to see connection details.

npx @byronwade/memoria --verbose
MCP Connection | Memoria Troubleshooting | Memoria