Documentation.

Option A — one-click deeplink (Cursor 0.45+)

Open this URL in your browser; Cursor will intercept it:

cursor://anysphere.cursor-deeplink/mcp/install?name=codeindexer&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0Ojg5NzgvbWNwIn0=

The base64 payload decodes to {"url":"http://localhost:8978/mcp"}.

Option B — edit config file manually

Global: ~/.cursor/mcp.json (every project). Project: .cursor/mcp.json (committed with the repo).

{
  "mcpServers": {
    "codeindexer": {
      "url": "http://localhost:8978/mcp"
    }
  }
}

Restart Cursor or reload the MCP panel in Settings → MCP.

Option A — one-liner via the claude CLI

HTTP transport (needs codeindexer serve running):

claude mcp add --transport http codeindexer \
  --scope user http://127.0.0.1:8978/mcp

stdio transport (no server needed, Claude launches the binary):

claude mcp add --transport stdio codeindexer \
  --scope user -- codeindexer serve --stdio

Scope flags: --scope user → ~/.claude.json; --scope project → .mcp.json (committed); --scope local → .claude/settings.local.json.

Option B — edit config manually

User scope: ~/.claude.json. Project scope: .mcp.json in repo root.

{
  "mcpServers": {
    "codeindexer": {
      "type": "http",
      "url": "http://127.0.0.1:8978/mcp"
    }
  }
}

⚠ Important: set "type": "http" — not "sse". Claude Code uses "http" for the Streamable HTTP transport; without it, the URL is treated as a subprocess.

Option A — one-liner via the codex CLI

Streamable HTTP (needs codeindexer serve):

codex mcp add codeindexer --url http://localhost:8978/mcp

stdio (no server needed):

codex mcp add codeindexer -- codeindexer serve --stdio

Add --bearer-token-env-var NAME to send Authorization: Bearer $NAME with every HTTP request.

Option B — edit ~/.codex/config.toml

stdio:

[mcp_servers.codeindexer]
command = "codeindexer"
args = ["serve", "--stdio"]

Streamable HTTP:

[mcp_servers.codeindexer]
url = "http://localhost:8978/mcp"

Project-scoped variant (only loaded for trusted projects): .codex/config.toml in the repo root.

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or equivalent on other OS.

{
  "mcpServers": {
    "codeindexer": {
      "command": "codeindexer",
      "args": ["serve", "--stdio"]
    }
  }
}

No running server needed — Claude Desktop launches codeindexer automatically.

Config file: ~/.gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "codeindexer": {
      "url": "http://localhost:8978/mcp"
    }
  }
}

Antigravity uses Streamable HTTP (/mcp), not SSE. Restart Antigravity after editing.

Option A — one-liner via the code CLI

code --add-mcp {"name":"codeindexer","type":"http","url":"http://localhost:8978/mcp"}

For VS Code Insiders use code-insiders. The entry is written to your User-profile mcp.json; trust the server on first use.

Option B — edit mcp.json manually

In VS Code run MCP: Open User Configuration or MCP: Add Server. Or open the file directly:

• macOS — ~/Library/Application Support/Code/User/mcp.json
• Linux — ~/.config/Code/User/mcp.json
• Windows — %APPDATA%\Code\User\mcp.json

Workspace-scoped: .vscode/mcp.json (committed with repo).

{
  "servers": {
    "codeindexer": {
      "type": "http",
      "url": "http://localhost:8978/mcp"
    }
  }
}

⚠ Plan mode notice: built-in Plan mode in VS Code Copilot disables non-built-in tools, including MCP servers. Use Agent mode (MCP tools fully available) or define a custom chat mode that whitelists codeindexer tools — see the README on GitHub for the template.

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codeindexer": {
      "command": "codeindexer",
      "args": ["serve", "--stdio"]
    }
  }
}