IDE Setup

Configure Cursor, VS Code, and Claude Desktop to use the IndexMind MCP server.

Once the MCP server is built, you need to register it with your IDE so the editor can discover and invoke the IndexMind tools. Each IDE stores MCP configuration in a slightly different location, but the JSON structure is the same.

Cursor

Add the MCP server in Settings > MCP Servers, or create a .cursor/mcp.json file at the root of your workspace:

{
  "mcpServers": {
    "indexmind": {
      "command": "node",
      "args": [
        "/path/to/packages/mcp-server/dist/index.js",
        "--api-url", "https://api.indexmind.ai",
        "--project-id", "YOUR_PROJECT_ID"
      ],
      "env": {
        "INDEXMIND_API_KEY": "imcp_YOUR_KEY"
      }
    }
  }
}

After saving, Cursor should detect the server automatically. You can verify the connection in Settings > MCP Servers. The IndexMind entry will show a green status indicator when connected.

VS Code

Add the following to your VS Code settings.json (open with Cmd+Shift+P > Preferences: Open User Settings (JSON)):

{
  "mcpServers": {
    "indexmind": {
      "command": "node",
      "args": [
        "/path/to/packages/mcp-server/dist/index.js",
        "--api-url", "https://api.indexmind.ai",
        "--project-id", "YOUR_PROJECT_ID"
      ],
      "env": {
        "INDEXMIND_API_KEY": "imcp_YOUR_KEY"
      }
    }
  }
}

Alternatively, you can place this configuration in a .vscode/mcp.json file at the root of your workspace to share it with your team.

Claude Desktop

Open the Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "indexmind": {
      "command": "node",
      "args": [
        "/path/to/packages/mcp-server/dist/index.js",
        "--api-url", "https://api.indexmind.ai",
        "--project-id", "YOUR_PROJECT_ID"
      ],
      "env": {
        "INDEXMIND_API_KEY": "imcp_YOUR_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving the file. The IndexMind tools will appear in the tools list when you start a new conversation.

Passing additional flags

You can append any CLI flag to the args array. For example, to start the server in read-only mode with debug logging:

{
  "mcpServers": {
    "indexmind": {
      "command": "node",
      "args": [
        "/path/to/packages/mcp-server/dist/index.js",
        "--api-url", "https://api.indexmind.ai",
        "--project-id", "YOUR_PROJECT_ID",
        "--readonly",
        "--log-level", "debug"
      ],
      "env": {
        "INDEXMIND_API_KEY": "imcp_YOUR_KEY"
      }
    }
  }
}

Next steps

Once your IDE shows the MCP server as connected, run through the Health Checks to confirm everything is working end-to-end.