Cursor Integration Guide

Cursor is a next-generation AI-first code editor. Because Cursor fully supports the Model Context Protocol (MCP), you can connect Proxima directly in the GUI to allow the Cursor AI Composer, Agent, and Chat features to coordinate search, code compilation, and terminal routing.

1. Quick GUI Configuration

Follow these simple steps to add Proxima to your Cursor editor UI:

1 Open Cursor **Settings** by clicking the gear icon in the top right corner of the window.
2 Select the **Features** tab in the sidebar menu.
3 Scroll down to the **MCP (Model Context Protocol)** section and click the **+ Add New MCP Server** button.
4 Input the following configuration details:
  • **Name**: proxima
  • **Type**: command
  • **Command**: node
  • **Arguments**: "C:/path/to/proxima/src/mcp/index.js" *(Replace with your actual local installation path)*
5 Click **Save**. The status dot next to the server should turn green, indicating a successful local bridge connection.
Tip: If you are working on a team with different OS paths, you can commit a localized mcp.json file directly to your project root inside the workspace.

2. Direct File Configuration (JSON)

If you prefer configuring via workspace setup files, Cursor stores its global MCP configurations in a JSON block. You can edit this file directly:

Config Path

# Windows: %APPDATA%\Cursor\User\globalStorage\moose.copilot\mcp.json # macOS: ~/Library/Application Support/Cursor/User/globalStorage/moose.copilot/mcp.json

JSON Configuration Block

{ "mcpServers": { "proxima": { "command": "node", "args": [ "C:/path/to/proxima/src/mcp/index.js" ] } } }

3. Using Proxima inside Cursor

Once connected, Cursor automatically indexes all tools exposed by Proxima. You can invoke them in two ways:

A. Automatic Selection

Simply ask Cursor Composer or Cursor Chat a question. If Cursor needs web search results or file analysis, it will automatically call Proxima tools like deep_search or analyze_file to gather context.

B. Manual Tool Invocations

You can instruct Cursor to invoke specific tools by mentioning their name in your chat window. For example:

"Use proxima ask_claude to review my code in auth.js" "Run solve on 'fix token auth loop' and verify with write_tests"