Skip to content

Cursor

Cursor Setup

Cursor is a popular AI-powered code editor that supports MCP servers over HTTP.

How to Find the Configuration File

The MCP configuration file location depends on your operating system. Follow these steps to locate or create it:

Windows

Option 1: Using PowerShell (Recommended)

  1. Open PowerShell
  2. Run this command to open the file directly: 
    notepad "$env:APPDATA\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json"
  3. If the file doesn't exist, Notepad will ask if you want to create it. Click "Yes".

Option 2: Manual Navigation

  1. Press Win + R to open the "Run" dialog
  2. Type: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings
  3. Press Enter
  4. If the file cline_mcp_settings.json doesn't exist, create it with that exact name

Alternative locations (if the above doesn't work): - %APPDATA%\Cursor\mcp.json - C:\Users\<YourUsername>\.cursor\mcp.json

macOS

Option 1: Using Terminal

  1. Open Terminal
  2. Run this command to open the file: 
    open -a TextEdit ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  3. If the file doesn't exist, TextEdit will create it when you save.

Option 2: Manual Navigation

  1. Open Finder
  2. Press Cmd + Shift + G (Go to Folder)
  3. Paste: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings
  4. If the file cline_mcp_settings.json doesn't exist, create it

Alternative location: ~/.cursor/mcp.json

Linux

Option 1: Using Terminal

  1. Open Terminal
  2. Run this command to open the file: 
    nano ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  3. If the file doesn't exist, nano will create it when you save (Ctrl + O, then Enter, then Ctrl + X).

Option 2: Manual Navigation

  1. Open your file manager
  2. Navigate to: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings
  3. If the file cline_mcp_settings.json doesn't exist, create it

Alternative location: ~/.cursor/mcp.json

Configuration

Add the following configuration to your Cursor MCP settings file. If the file already exists and has an mcpServers section, merge this configuration into it.

Basic Configuration

{
  "mcpServers": {
    "akashic-mcp": {
      "type": "http",
      "url": "https://akashic-mcp.com/mcp"
    }
  }
}

Configuration

{
  "mcpServers": {
    "akashic-mcp": {
      "type": "http",
      "url": "https://akashic-mcp.com/mcp"
    }
  }
}

Steps

  1. Find or create the configuration file using the instructions above
  2. Add the configuration JSON to the file:
  3. If the file is empty, paste the entire JSON configuration
  4. If the file already has an mcpServers section, add "akashic-mcp" to it
  5. Configure your MCP token in the client (e.g. Authorization: Bearer)
  6. Save the file
  7. Restart Cursor completely (close all windows and reopen)
  8. Verify connection - Cursor should now show Akashic MCP tools available

Verifying Your Configuration

After configuring, verify that everything works:

  1. Check MCP Status: In Cursor, go to Settings → MCP (or check the MCP panel)
  2. Look for "akashic-mcp": You should see "akashic-mcp" in the list of servers
  3. Check Status: The status should be "Connected" or "Ready"
  4. Test a Tool: Try using a simple tool like list_collections from your AI assistant

Troubleshooting

"Loading tools" but tools don't appear

  1. Verify the server is accessible:
  2. Open https://akashic-mcp.com/health in your browser

  3. Should return {"status":"ok"}

  4. Check the endpoint manually: 

    curl -X POST https://akashic-mcp.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

  5. Review Cursor logs for connection errors

  6. Ensure the JSON syntax is correct (no trailing commas)

Connection Error

  • Verify the URL is correct: https://akashic-mcp.com/mcp
  • Check that no firewall is blocking the connection
  • Try accessing https://akashic-mcp.com/health from your browser

Authentication Error

  • The tools/list method does not require authentication
  • Only tools/call requires authentication
  • If tools/list fails, there's a server issue