Skip to main content
For installation instructions, see the Quickstart.

Troubleshooting

  1. Make sure you’ve added the configuration in Settings → Tools & MCP
  2. Restart Cursor completely (not just reload window)
  3. Check the MCP panel to see if Neptune shows as connected
Cursor can’t find the uv package manager. Fix:
  1. Open a terminal and verify uv is installed:
  1. If not installed, install it:
  1. Restart Cursor
On Windows, you must wrap the command with cmd /c:
Try asking the AI: “What MCP tools do you have access to?”If Neptune isn’t listed:
  1. Check the MCP panel in Cursor settings
  2. Look for error messages
  3. Try removing and re-adding the configuration
If the browser doesn’t open when you say “Log me in to Neptune”:
  1. Check your default browser settings
  2. Look in the Cursor output panel for a login URL
  3. Copy and paste the URL manually into your browser
This can happen if the MCP process crashes. Try:
  1. Check Cursor’s output panel for error messages
  2. Make sure Python 3.13+ is installed
  3. Try running the MCP command manually in terminal to see errors:

Verify Installation

To verify Neptune is working in Cursor:
  1. Open a new AI chat
  2. Ask: “What Neptune tools do you have?”
  3. You should see a list including login, deploy_project, get_deployment_status, etc.

Next Steps

Quickstart

Continue with authentication and deploy your first app