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

# JetBrains IDEs

> Troubleshooting Neptune MCP in JetBrains IDEs

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

## Supported IDEs

Neptune MCP works with any JetBrains IDE that has AI Assistant:

* IntelliJ IDEA
* PyCharm
* WebStorm
* GoLand
* PhpStorm
* Rider
* CLion
* RubyMine
* DataGrip

> [!NOTE]
>
> JetBrains AI Assistant requires a JetBrains AI subscription.

## Configuration

JetBrains AI Assistant currently only supports **stdio** transport for MCP servers. HTTP/SSE transport is not natively supported.

> [!TIP]
>
> Already use Claude Desktop? Click **Import from Claude** in the MCP settings to reuse your existing configurations.

> [!NOTE]
>
> For more details, see the [official JetBrains MCP documentation](https://www.jetbrains.com/help/ai-assistant/mcp.html).

## Troubleshooting

> [accordion] Where to configure MCP
>
> 1. Open **Settings** (`Cmd+,` on macOS, `Ctrl+Alt+S` on Windows/Linux)
> 2. Navigate to **Tools** → **AI Assistant** → **Model Context Protocol (MCP)**
> 3. Click **Add** to add a new MCP server
>
> Alternatively, type `/` in the AI Assistant chat and select **Add Command**.

> [accordion] How to configure Neptune
>
> **Option 1: JSON configuration (recommended)**
>
> 1. Click **Add** → select **As JSON**
> 2. 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"]
>     }
>   }
> }
> ```
>
> **Option 2: Manual configuration**
>
> * **Name**: `neptune`
> * **Command**: `uvx` (or `cmd` on Windows)
> * **Arguments**: `--from git+https://github.com/shuttle-hq/neptune-mcp.git neptune mcp`
>
> On Windows, use:
>
> * **Command**: `cmd`
>
> * **Arguments**: `/c uvx --from git+https://github.com/shuttle-hq/neptune-mcp.git neptune mcp`
>
> 3. Set **Level** to "Global" to use Neptune across all projects
> 4. Click **Apply**

> [accordion] 'uvx: command not found'
>
> The IDE 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 the IDE

> [accordion] MCP not available in settings
>
> MCP support requires:
>
> 1. JetBrains AI Assistant plugin installed
> 2. Active JetBrains AI subscription
> 3. Recent version of the IDE (2024.x or later)
>
> Update your IDE and plugins if MCP options aren't visible.

> [accordion] Using HTTP transport (workaround)
>
> JetBrains doesn't natively support HTTP transport, but you can use a proxy tool like [mcp-remote](https://github.com/anthropics/anthropic-cookbook/tree/main/misc/mcp_over_http) to connect to remote MCP servers.
>
> Alternatively, you can run Neptune's HTTP server locally and connect via a stdio proxy:
>
> 1. Start the Neptune MCP server in HTTP mode:
>
> ```bash theme={"dark"}
> uvx --from git+https://github.com/shuttle-hq/neptune-mcp.git neptune mcp --transport=http
> ```
>
> 2. The server runs at `http://localhost:8001/mcp`
> 3. Use a stdio-to-HTTP proxy to connect JetBrains to this endpoint

> [accordion] Connection issues
>
> If the MCP connection fails:
>
> 1. Check that Python 3.13+ is installed
> 2. Try running the command manually in terminal to see errors
> 3. Restart the IDE after configuration changes

## Verify Installation

To verify Neptune is working:

1. Open AI Assistant chat
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.