> ## 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 + GitHub Copilot

> Troubleshooting Neptune MCP with GitHub Copilot

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
* [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension installed
* GitHub Copilot subscription (Individual, Business, or Enterprise)

> [!NOTE]
>
> MCP support in GitHub Copilot requires VS Code 1.99+ and GitHub Copilot extension version 1.250+.

> [!NOTE]
>
> For more details, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

## Troubleshooting

> [accordion] Where to add the configuration
>
> 1. Open the Command Palette (`Cmd+Shift+P` on macOS, `Ctrl+Shift+P` on Windows/Linux)
>
> 2. Run **MCP: Open User Configuration**
>
> 3. Add the Neptune configuration to your `mcp.json` file
>
> > [!TIP]
> >
> > Use **MCP: Open Remote User Configuration** if you want the server to run on a remote machine when connected remotely.

> [accordion] Configuration format
>
> Add this to your `mcp.json`:
>
> ```json theme={"dark"}
> {
>   "servers": {
>     "neptune": {
>       "command": "uvx",
>       "args": ["--from", "git+https://github.com/shuttle-hq/neptune-mcp.git", "neptune", "mcp"]
>     }
>   }
> }
> ```
>
> On Windows:
>
> ```json theme={"dark"}
> {
>   "servers": {
>     "neptune": {
>       "command": "cmd",
>       "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-mcp.git", "neptune", "mcp"]
>     }
>   }
> }
> ```

> [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] MCP not available
>
> MCP support requires:
>
> 1. VS Code version 1.99 or later
> 2. GitHub Copilot extension version 1.250 or later
> 3. Active GitHub Copilot subscription
>
> Update both VS Code and the Copilot extension if MCP options aren't available.

> [accordion] Neptune tools not appearing in Copilot Chat
>
> 1. Make sure you've reloaded VS Code after adding the configuration
> 2. Open Copilot Chat (Cmd+Shift+I or Ctrl+Shift+I)
> 3. Try asking: "What MCP tools do you have?"
> 4. Check the Output panel for any error messages (View → Output → GitHub Copilot)

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

## Verify Installation

To verify Neptune is working:

1. Open Copilot Chat in VS Code (Cmd+Shift+I or Ctrl+Shift+I)
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.