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

​
Installation

Claude Code uses the claude mcp add command to install MCP servers:
  • macOS / Linux
  • Windows
claude mcp add --transport stdio neptune -- uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp

​
MCP Scopes

Claude Code supports different scopes for MCP server configuration:
ScopeFlagDescription
Local--scope localAvailable only to you in the current project (default)
Project--scope projectShared with team via .mcp.json file
User--scope userAvailable to you across all projects
# Make Neptune available across all your projects
claude mcp add --scope user --transport stdio neptune -- uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp

​
Managing MCP Servers

# List all configured servers
claude mcp list

# Get details for Neptune
claude mcp get neptune

# Remove Neptune
claude mcp remove neptune

# Check server status (within Claude Code)
/mcp

​
Troubleshooting

Claude Code can’t find the uv package manager.
  1. Install uv:
# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Make sure uv is in your PATH
  2. Try the command again
On Windows, you must use the cmd /c wrapper:
claude mcp add --transport stdio neptune -- cmd /c uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp
Without cmd /c, Windows cannot directly execute uvx.
  1. Verify the server was added:
claude mcp list
  1. Check the server details:
claude mcp get neptune
  1. Try removing and re-adding:
claude mcp remove neptune
claude mcp add --transport stdio neptune -- uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp
If the server takes too long to start, increase the timeout:
MCP_TIMEOUT=10000 claude
This sets a 10-second timeout (default is lower).
If the browser doesn’t open when you ask to log in:
  1. Check your system’s default browser settings
  2. Look for a login URL in Claude’s response
  3. Copy and paste the URL manually
Use project scope to create a .mcp.json file that can be committed:
claude mcp add --scope project --transport stdio neptune -- uvx --from git+https://github.com/shuttle-hq/neptune-cli-python.git neptune mcp
This creates a .mcp.json in your project root that teammates can use.

​
Verify Installation

To verify Neptune is working:
  1. Run /mcp in Claude Code to check server status
  2. Ask: “What Neptune tools do you have access to?”
  3. You should see tools including login, deploy_project, etc.

​
Learn More

​
Next Steps

Quickstart

Continue with authentication and deploy your first app