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

Installation

Claude Code uses the claude mcp add command to install MCP servers:

MCP Scopes

Claude Code supports different scopes for MCP server configuration:

Managing MCP Servers

Troubleshooting

Claude Code can’t find the uv package manager.
  1. Install uv:
  1. Make sure uv is in your PATH
  2. Try the command again
On Windows, you must use the cmd /c wrapper:
Without cmd /c, Windows cannot directly execute uvx.
  1. Verify the server was added:
  1. Check the server details:
  1. Try removing and re-adding:
If the server takes too long to start, increase the timeout:
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:
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