Skip to main content

Connecting to Cursor

Integrate your Reeva MCP servers with Cursor IDE for AI-powered development.

Prerequisites​

  • ✅ Reeva account with at least one server
  • ✅ Server API key (generated in dashboard)
  • ✅ Cursor IDE installed (latest version)

Step-by-Step Setup​

1. Get Your Server Configuration​

  1. Log into Reeva Dashboard
  2. Navigate to Servers
  3. Select the server you want to connect
  4. Click the "MCP Config" tab
  5. Click "Copy Configuration"

Your configuration looks like:

{
  "mcpServers": {
    "my-server-name": {
      "url": "https://api.joinreeva.com/mcp/server_xxxxx",
      "apiKey": "mcpk_xxxxxxxxxxxxxxxxx"
    }
  }
}

2. Open Cursor MCP Settings​

Option A: Via Settings UI

  1. Open Cursor
  2. Press Cmd+, (Mac) or Ctrl+, (Windows/Linux) to open Settings
  3. Search for "MCP" in the settings search bar
  4. Click on "Features" → "MCP"

Option B: Via Command Palette

  1. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
  2. Type "MCP Settings"
  3. Select "Preferences: Open MCP Settings"

3. Add Your Server​

In the MCP settings panel:

  1. Click "Edit Config" or "Add MCP Server"

  2. Paste your Reeva configuration

  3. Alternatively, manually add:

    • Server Name: Choose a descriptive name (e.g., "my-research-server")
    • Server URL: https://api.joinreeva.com/mcp/server_YOUR_SERVER_ID
    • API Key: mcpk_your_api_key_here

  4. Click "Save"

4. Restart Cursor​

For changes to take effect:

  1. Close Cursor completely
  2. Reopen Cursor

Alternatively:

  • Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
  • Type "Reload Window"
  • Press Enter

5. Verify Connection​

Check MCP Panel:

  1. Open Cursor's MCP panel (usually in the sidebar)
  2. Look for your server name
  3. Status should show "Connected" or a green indicator

Test in Chat:

  1. Open a new chat with Cursor AI (Cmd+L or Ctrl+L)
  2. Ask a question that requires your tools: 
    Search the web for "latest React 19 features"
  3. Watch the AI automatically use your tool
  4. Results will appear in the chat

6. Verify Tool Availability​

To see which tools are available:

# In Cursor terminal
# The AI should have access to your custom tools

Or ask the AI directly:

What tools do you have access to?

Configuration Examples​

Basic Configuration​

{
  "mcpServers": {
    "reeva-research": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "apiKey": "mcpk_def456"
    }
  }
}

Multiple Servers​

{
  "mcpServers": {
    "reeva-research": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "apiKey": "mcpk_def456"
    },
    "reeva-productivity": {
      "url": "https://api.joinreeva.com/mcp/server_xyz789",
      "apiKey": "mcpk_ghi012"
    }
  }
}

With Custom Names​

Use descriptive names that indicate what the server does:

{
  "mcpServers": {
    "web-scraping": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "apiKey": "mcpk_def456"
    },
    "notion-jira": {
      "url": "https://api.joinreeva.com/mcp/server_xyz789",
      "apiKey": "mcpk_ghi012"
    }
  }
}

Usage Tips​

When to Use Your Tools​

The AI will automatically decide when to use your tools based on context. You can also explicitly request:

Use my web search tool to find...
Scrape https://example.com using Firecrawl
Search my Notion workspace for...

Tool Selection​

If you have multiple similar tools, be specific:

Use the "My Company Notion" tool to search for project docs

Debugging Prompts​

If tools aren't working, try:

List all available MCP tools
Show me the parameters for the google_search tool
Try calling my web search tool with query "test"

Troubleshooting​

Server Not Appearing​

Problem: Server doesn't show up in MCP panel after restart.

Solutions:

  1. ✅ Verify JSON syntax is valid (no trailing commas, proper quotes)
  2. ✅ Check API key has no extra spaces
  3. ✅ Ensure Server ID is correct (check dashboard)
  4. ✅ Try removing and re-adding the configuration
  5. ✅ Check Cursor logs:
    • Help → Toggle Developer Tools → Console tab
    • Look for MCP-related errors

"Authentication Failed"​

Problem: Error message about authentication when AI tries to use tools.

Solutions:

  1. ✅ Verify API key is correct
  2. ✅ Check key hasn't been revoked in dashboard
  3. ✅ Ensure API key is linked to the correct server
  4. ✅ Try generating a new API key

Tools Not Available​

Problem: AI says it doesn't have access to your tools.

Solutions:

  1. ✅ Restart Cursor (full restart, not just reload)
  2. ✅ Check server status in dashboard (should be active)
  3. ✅ Verify custom tools are added to server
  4. ✅ Test server in Reeva Chat first to ensure it works
  5. ✅ Check for Cursor updates (update to latest version)

"Insufficient Credits"​

Problem: Tool execution fails with credit error.

Solutions:

  1. ✅ Check credit balance in dashboard
  2. ✅ Purchase more credits if needed
  3. ✅ Verify tool execution succeeded (check Usage page)

Slow Tool Execution​

Problem: Tools take a long time to respond.

Expected behavior:

  • Most tools respond in 1-5 seconds
  • Web scraping may take 5-15 seconds
  • External API delays are normal

If consistently slow:

  1. ✅ Check network connection
  2. ✅ Verify external service (Notion, Jira, etc.) is responding
  3. ✅ Test tool in Reeva Playground to isolate issue

Configuration File Location​

If you need to manually edit the config file:

Mac:

~/Library/Application Support/Cursor/User/mcp-settings.json

Windows:

%APPDATA%\Cursor\User\mcp-settings.json

Linux:

~/.config/Cursor/User/mcp-settings.json

Best Practices​

Security​

  • ✅ Never commit API keys to version control
  • ✅ Use server-specific keys for production
  • ✅ Rotate keys periodically (every 90 days)
  • ✅ Revoke unused keys in dashboard

Organization​

  • ✅ Name servers descriptively: "research-tools" not "server1"
  • ✅ Group related tools: One server per use case
  • ✅ Document usage: Add comments in config (outside JSON)

Performance​

  • ✅ Limit tool count: Don't add 50 tools to one server
  • ✅ Test before deploying: Use Chat/Playground first
  • ✅ Monitor usage: Track which tools are actually used

Advanced Configuration​

Environment Variables​

For team sharing (keep secrets out of config):

# In your shell profile
export REEVA_API_KEY="mcpk_your_key_here"

Then reference in Cursor (if supported):

{
  "mcpServers": {
    "reeva": {
      "url": "https://api.joinreeva.com/mcp/server_abc123",
      "apiKey": "${REEVA_API_KEY}"
    }
  }
}

Multiple Environments​

Use different servers for dev/staging/prod:

{
  "mcpServers": {
    "reeva-dev": {
      "url": "https://api.joinreeva.com/mcp/server_dev123",
      "apiKey": "mcpk_dev_key"
    },
    "reeva-prod": {
      "url": "https://api.joinreeva.com/mcp/server_prod456",
      "apiKey": "mcpk_prod_key"
    }
  }
}

Next Steps​

  • ✅ Explore other IDEs (Windsurf, Claude Code)
  • ✅ Learn API integration for programmatic access
  • ✅ Check common errors if issues arise
  • ✅ Join the community to share tips and ask questions

Need Help?​

You're all set! Your Reeva tools are now available in Cursor. Happy coding! 🚀