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

# Warp

> Troubleshooting Neptune MCP in Warp terminal

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

## Configuration

MCP servers are configured through Warp's settings UI. You can access MCP settings via:

* **Settings** → **MCP Servers**
* **Warp Drive** → **Personal** → **MCP Servers**
* **Command Palette** → search "Open MCP Servers"

> [!NOTE]
>
> For more details, see the [official Warp MCP documentation](https://docs.warp.dev/knowledge-and-collaboration/mcp).

## Troubleshooting

> [accordion] How to add Neptune
>
> 1. Go to **Settings** → **MCP Servers**
> 2. Click **+ Add**
> 3. Paste this configuration:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "neptune": {
>       "command": "uvx",
>       "args": ["--from", "git+https://github.com/shuttle-hq/neptune-mcp.git", "neptune", "mcp"]
>     }
>   }
> }
> ```
>
> On Windows:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "neptune": {
>       "command": "cmd",
>       "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-mcp.git", "neptune", "mcp"]
>     }
>   }
> }
> ```
>
> 4. Click **Start** on the Neptune server to enable it

> [accordion] Where to find MCP settings
>
> You can access MCP settings in multiple ways:
>
> * **Settings** → **MCP Servers**
> * **Warp Drive** → **Personal** → **MCP Servers**
> * **Command Palette** (`Cmd+P`) → search "Open MCP Servers"
> * **Settings** → **AI** → **Manage MCP servers**

> [accordion] 'uvx: command not found'
>
> Warp 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. Restart Warp

> [accordion] Invalid JSON error
>
> Common JSON mistakes:
>
> * Trailing commas (remove comma after last item)
> * Missing quotes around strings
> * Using single quotes instead of double quotes
>
> Validate your JSON at [jsonlint.com](https://jsonlint.com/).

> [accordion] MCP not connecting
>
> 1. Make sure the Neptune server shows as "Running" in MCP settings
> 2. Click **View Logs** on the server to check for errors
> 3. Try running the command manually to see errors:
>
> ```bash theme={"dark"}
> uvx --from git+https://github.com/shuttle-hq/neptune-mcp.git neptune mcp
> ```
>
> 4. If issues persist, try stopping and restarting the server

> [accordion] Warp AI features not available
>
> Warp's AI features (including MCP) require:
>
> 1. A Warp account (free tier works)
> 2. AI features enabled in settings
>
> Check **Settings** → **AI** to ensure it's enabled.

## Verify Installation

To verify Neptune is working:

1. Open Warp AI (Cmd+I or click the AI button)
2. Ask: "What Neptune tools do you have?"
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.