How to add IDE Index MCP Server to Windsurf

JetBrains IDE plugin exposing an MCP server so AI agents can use the IDE's indexing and refactoring. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 254★ · http · no auth

Windsurf config for IDE Index MCP Server

claude mcp add --transport http --scope user intellij-index http://127.0.0.1:29170/index-mcp/streamable-http

{
  "mcpServers": {
    "ide-index-mcp-server": {
      "serverUrl": "http://127.0.0.1:29170/index-mcp/streamable-http"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the IDE Index MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5IDE Index MCP Server's tools become available to Cascade.

Before you start

JetBrains IDE 2025.1 or later (any IntelliJ Platform-based IDE)
JVM 21 or later
The IDE Index MCP Server plugin installed from JetBrains Marketplace (plugin 29174)
An MCP-compatible client supporting Streamable HTTP (MCP 2025-03-26), e.g. Claude Code, Codex, Cursor, Windsurf

What IDE Index MCP Server can do in Windsurf

ide_find_references

Find all references to a symbol across the entire project.

ide_find_definition

Find the definition/declaration location of a symbol.

ide_find_class

Search for classes/interfaces by name with camelCase/substring/wildcard matching.

ide_find_file

Search for files by name using the IDE's file index.

ide_find_symbol

Search for symbols (classes, methods, fields, functions) by name with IntelliJ Go to Symbol matching (disabled by default).

ide_search_text

Text search using the IDE's pre-built word index with context filtering.

ide_diagnostics

Analyze file problems with fresh editor diagnostics for open files or batch diagnostics for closed files, plus optional build/test results.

ide_index_status

Check if the IDE is in dumb mode (indexing) or smart mode.

Security

The server binds to 127.0.0.1 by default and implements no authentication (it does not advertise auth capabilities). Changing Server Host to 0.0.0.0 exposes it for remote/WSL access without any auth, so restrict network access accordingly. Each JetBrains IDE uses a distinct default port to avoid conflicts when multiple IDEs run at once.

IDE Index MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the IDE Index MCP Server config there under the "mcpServers" key and restart the client.

Is IDE Index MCP Server safe to use with Windsurf?

How do I connect Claude Code to it?

Run the install command (adjust name and port for your IDE), e.g. `claude mcp add --transport http --scope user intellij-index http://127.0.0.1:29170/index-mcp/streamable-http`. You can also use the plugin's 'Install on Coding Agents' button in the tool window.

What port does it use?

Each JetBrains IDE has a distinct default port and server name to avoid conflicts: IntelliJ IDEA 29170 (intellij-index), Android Studio 29171, PyCharm 29172, WebStorm 29173, GoLand 29174, PhpStorm 29175, RubyMine 29176, CLion 29177, RustRover 29178, DataGrip 29179. The port is changeable in Settings > Tools > Index MCP Server.

Does it require authentication?

No. The server binds to 127.0.0.1 by default and does not implement or advertise authentication. If you change the host to 0.0.0.0 for remote/WSL access, it remains unauthenticated, so restrict access at the network level.

View repo Full IDE Index MCP Server page