Skip to main content

JetBrains IDEs Setup

note

Requires JetBrains IDE 2025.2 or later with AI Assistant enabled, and Node.js 20+.

Prerequisites​

JetBrains IDE 2025.2+

IntelliJ IDEA, PyCharm, WebStorm, or any JetBrains IDE with AI Assistant

Civic Account

Create a free account and configure your tools at app.civic.com

info

JetBrains AI Assistant connects to remote MCP servers via a local mcp-remote bridge. Node.js 20+ is required.

Setup​

JetBrains IDEs support MCP configuration via the UI or a JSON config file. Both methods connect to the same Civic endpoint.

  1. 1
    Open MCP Settings

    Go to Settings (or Preferences on macOS) → Tools → AI Assistant → Model Context Protocol (MCP)

  2. 2
    Add a new server

    Click + to add a new MCP server and fill in:

    • Name: Civic
    • Command: npx
    • Arguments: -y mcp-remote https://app.civic.com/hub/mcp
  3. 3
    Save and connect

    Click OK to save. JetBrains will launch the bridge and connect to Civic automatically.

  4. 4
    Authorize

    On first use, a browser window will open for Civic authentication. Complete the OAuth flow, then return to your IDE.

Test Your Connection​

Open AI Assistant and try:

"What MCP tools do I have available?"
"List my GitHub repositories"
"Check my Google Calendar for today"

Troubleshooting​

Node.js version error

mcp-remote requires Node.js 20 or later. Check your version with node --version and upgrade if needed.

Authentication browser window doesn't open

Try running the connection manually from terminal:

npx -y mcp-remote https://app.civic.com/hub/mcp

Complete the auth flow there, then restart the IDE.

AI Assistant not showing MCP option

MCP support requires JetBrains IDE 2025.2+. Update your IDE and ensure the AI Assistant plugin is installed and enabled.

Need Help?​

Troubleshooting

Common connection issues and solutions

Get Help

Ask in our developer Slack