> ## 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.

# VS Code + Cline

> Troubleshooting Neptune MCP with the Cline extension

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

## Prerequisites

* [VS Code](https://code.visualstudio.com/) installed
* [Cline extension](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) installed

## Configuration

MCP servers are configured in the `cline_mcp_settings.json` file. Access it via the **MCP Servers** icon in the Cline panel → **Configure** tab → **Configure MCP Servers**.

> [!NOTE]
>
> For more details, see the [official Cline MCP documentation](https://docs.cline.bot/mcp/configuring-mcp-servers).

## Troubleshooting

> [accordion] Where to add the configuration
>
> 1. Click the **MCP Servers** icon in the top navigation bar of the Cline panel
> 2. Select the **Configure** tab
> 3. Click **Configure MCP Servers** to open `cline_mcp_settings.json`
> 4. Add the Neptune configuration

> [accordion] Configuration not being recognized
>
> Make sure your `cline_mcp_settings.json` has the correct structure:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "neptune": {
>       "command": "uvx",
>       "args": ["--from", "git+https://github.com/shuttle-hq/neptune-mcp.git", "neptune", "mcp"]
>     }
>   }
> }
> ```
>
> Note: The config uses `mcpServers` (same format as Claude Desktop).

> [accordion] 'uvx: command not found'
>
> VS Code can't find the `uv` package manager.
>
> 1. Install uv:
>
> ```bash theme={"dark"}
> # macOS
> brew install uv
>
> # Linux
> curl -LsSf https://astral.sh/uv/install.sh | sh
>
> # Windows
> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
> ```
>
> 2. Reload VS Code window (Cmd+Shift+P → "Reload Window")

> [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 appearing
>
> 1. Make sure Cline extension is installed and enabled
> 2. Reload VS Code window after adding configuration
> 3. Try asking Cline: "What MCP tools do you have?"

> [accordion] Cline not using MCP
>
> Make sure you're using a Cline version that supports MCP. Update the extension:
>
> 1. Go to Extensions (Cmd+Shift+X)
> 2. Find Cline
> 3. Click "Update" if available

## Verify Installation

To verify Neptune is working:

1. Open Cline in VS Code
2. Ask: "What Neptune tools do you have access to?"
3. You should see a list including `login`, `deploy_project`, 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.