Skip to main content

​
MCP Server Not Connecting

Check that your API key is correct in the configuration file.Steps:
  1. Go to Deepcon Dashboard
  2. Copy your API key
  3. Update your IDE’s MCP configuration
  4. Restart your IDE
Common mistakes:
  • Extra spaces before/after the key
  • Missing or incorrect quotes in JSON
  • Using an expired or revoked key
Ensure Node.js 19+ is installed and accessible.
# Check Node.js version
node --version

# Should return v19.0.0 or higher
If Node.js is not installed or outdated:
# Using nvm
nvm install 20
nvm use 20
Configuration changes require a full restart.Claude Desktop:
  • macOS: Cmd + Q to quit completely
  • Windows: Close from system tray
  • Then relaunch the app
Cursor/Windsurf:
  • Close all windows
  • Quit the application
  • Relaunch
Claude Code:
# Restart your terminal session or
source ~/.bashrc  # or ~/.zshrc
Look for error messages in your IDE’s logs.Claude Desktop:
  • macOS: ~/Library/Logs/Claude/
  • Windows: %APPDATA%\Claude\logs\
Cursor:
  • Open Developer Tools: Cmd/Ctrl + Shift + I
  • Check Console tab
Claude Code:
claude --verbose

​
No Search Results

If search_documentation returns no results, follow these troubleshooting steps:

​
Check Registry

Ensure you’re using the correct registry: 
{
  sdk_name: "react",
  registry: "npm"  // ✓ Correct
}

​
Broaden Your Pattern

Your regex might be too restrictive:

Too Restrictive

function\s+authenticateUser\(\)
May not match variations

Better

authenticate|auth
Matches more variations

​
Adjust Semantic Query

Try a more general or differently-worded query: 
semantic_queries: [
  "How to implement OAuth2 authentication with JWT tokens?"
]

​
API Key Authentication Failed

1

Verify Key is Active

Check your dashboard to ensure the key hasn’t been revoked
2

Check Key Format

Ensure no extra characters or spaces:
"DEEPCON_API_KEY": "dc_1234567890abcdef"  // ✓ Correct
"DEEPCON_API_KEY": " dc_123..."           // ✗ Extra space
3

Regenerate Key

If issues persist, generate a new API key:
  1. Go to dashboard
  2. Revoke old key
  3. Generate new key
  4. Update configuration
  5. Restart IDE
4

Check Account Status

Verify your account is active and not suspended

​
Configuration File Not Found

​
Claude Desktop

  • macOS
  • Windows
Configuration file location:
~/Library/Application Support/Claude/claude_desktop_config.json
If missing, create the directory:
mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

​
Cursor

Create the config directory if missing: 
# Project-level
mkdir -p .cursor
touch .cursor/mcp.json

# Global
mkdir -p ~/.cursor
touch ~/.cursor/mcp.json

​
Windsurf

Create the config directory if missing: 
# Project-level
mkdir -p .windsurf
touch .windsurf/mcp_config.json

# Global
mkdir -p ~/.windsurf
touch ~/.windsurf/mcp_config.json

​
Tools Not Showing in IDE

1

Verify Configuration

Check that the mcpServers configuration is properly formatted:
{
  "mcpServers": {
    "deepcon": {
      "command": "npx",
      "args": ["-y", "deepcon-mcp"],
      "env": {
        "DEEPCON_API_KEY": "your-key"
      }
    }
  }
}
2

Check Connection Indicator

Look for MCP connection status in your IDE:
  • Claude Desktop: Bottom-right corner (🔌 icon)
  • Cursor: Status bar
  • Claude Code: Run claude mcp list
3

Verify NPX Access

Ensure npx can access the package:
npx -y deepcon-mcp --version
4

Check Logs

Review IDE logs for specific error messages about the MCP server

​
Package Not Available

If a package you need isn’t available:
Request Package AdditionWe’re constantly adding new packages. To request a package:
  1. Email support@deepcon.ai
  2. Include:
    • Package name
    • Registry (npm/pip)
    • Why you need it
  3. We’ll prioritize based on demand

​
JSON Syntax Errors

Common JSON configuration mistakes: 
{
  "mcpServers": {
    "deepcon": {},
  }
}
Validate your JSON:
  • Use jsonlint.com
  • Or use jq command: cat config.json | jq .

​
Still Having Issues?

Email Support

Contact our support team

Check Documentation

Review the full documentation

Best Practices

Learn optimization techniques

Examples

See working examples