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:
uv --version
  1. If not installed, install it:
# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Restart Cursor
On Windows, you must wrap the command with cmd /c:
{
  "mcpServers": {
    "neptune": {
      "command": "cmd",
      "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
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:
uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp

​
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