> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neptune.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Troubleshooting Neptune MCP in Cursor

For installation instructions, see the [Quickstart](https://docs.neptune.dev/quickstart.md#step-1-install-the-neptune-mcp).

## Troubleshooting

> [accordion] MCP server not appearing in Cursor
>
> 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

> [accordion] 'uvx: command not found'
>
> Cursor can't find the `uv` package manager. Fix:
>
> 1. Open a terminal and verify uv is installed:
>
> ```bash theme={"dark"}
> uv --version
> ```
>
> 2. If not installed, install it:
>
> ```bash theme={"dark"}
> # macOS
> brew install uv
>
> # Linux
> curl -LsSf https://astral.sh/uv/install.sh | sh
> ```
>
> 3. Restart Cursor

> [accordion] Windows: Command fails
>
> On Windows, you must wrap the command with `cmd /c`:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "neptune": {
>       "command": "cmd",
>       "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-mcp.git", "neptune", "mcp"]
>     }
>   }
> }
> ```

> [accordion] Neptune tools not showing up
>
> 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

> [accordion] Login not opening browser
>
> 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

> [accordion] MCP keeps disconnecting
>
> 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:
>
> ```bash theme={"dark"}
> uvx --from git+https://github.com/shuttle-hq/neptune-mcp.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

> [card] [Quickstart](https://docs.neptune.dev/quickstart.md#step-2-authenticate)
>
> Continue with authentication and deploy your first app


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.