CodeIndex
← Back to Resources
If you haven't set up the terminal application, go here first.

How to set up the CIDX MCP on JetBrains IDEs

Follow these steps to integrate the CIDX MCP with your favorite JetBrains IDE (IntelliJ IDEA, WebStorm, PyCharm, etc.) and unlock powerful documentation, code search, and agent features directly in your editor.

Last Updated: May 13, 2025

Important

Make sure you've already run npx cidx@latest login in your terminal before proceeding with these steps. See CLI setup instructions for more details.

  1. Open the JetBrains settings

    Go to Settings via File → Settings (or Ctrl+Alt+S).

  2. Navigate to the MCP server section

    In the left panel, expand Tools (or AI) and click MCP Server.

  3. Click the + Add new global MCP server button

    This opens a JSON editor where you can configure MCP servers.

  4. Add the CIDX MCP configuration

    Delete any placeholder content and copy-paste the following configuration:

    {
      "mcpServers": {
        "cidx-mcp": {
          "command": "npx",
          "args": [
            "cidx@latest"
          ]
        }
      }
    }
    Note: If you already have other MCP servers installed, you only need to add this portion inside your mcpServers object:
      "cidx-mcp": {
        "command": "npx",
        "args": [
          "cidx@latest"
        ]
      }
    Example with another server:
    {
      "mcpServers": {
        "cidx-mcp": {
          "command": "npx",
          "args": ["cidx@latest"]
        },
        "dummy-server": {
          "command": "dummy",
          "args": ["--mcp"]
        }
      }
    }
  5. Save and verify the configuration

    1. Click Save or press Ctrl+S to save.
    2. If successful, you'll see a green status indicator next to cidx-mcp.
    3. If you see a red indicator, make sure you've completed the login step correctly.

Try it out!

Now that CIDX MCP is installed, try some example prompts mentioning mcp:

Create a Spring Boot REST API using the mcp for reference
Add JWT authentication with guidance from the mcp documentation
Refactor this method leveraging patterns you find via the mcp

For more help, visit our Resources page or contact support.