Skip to main content
For installation instructions, see the Quickstart.

​
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”
For more details, see the official Warp MCP documentation.

​
Troubleshooting

  1. Go to Settings → MCP Servers
  2. Click + Add
  3. Paste this configuration:
{
  "mcpServers": {
    "neptune": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
On Windows:
{
  "mcpServers": {
    "neptune": {
      "command": "cmd",
      "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
  1. Click Start on the Neptune server to enable it
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
Warp can’t find the uv package manager.
  1. Install uv:
# 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"
  1. Restart Warp
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.
  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:
uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp
  1. If issues persist, try stopping and restarting the server
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

Quickstart

Continue with authentication and deploy your first app