MCP Usage

Using Qodo Aware as an MCP

What is MCP?

MCP stands for Model Context Protocol. It's an open protocol that standardizes how tools and services expose structured context to AI models.

It defines a consistent way for applications to communicate with AI, making it easier to integrate external systems like version control, issue trackers, or shell environments into your workflow.

Why use Qodo Aware as an MCP server?

Qodo Aware offers a deeply indexed, AI-enhanced view of your organization’s codebase.

Using it as an MCP server means:

• You can connect products like Claude Desktop, Cursor, or others directly to your remote codebase via Qodo Aware.

• You get consistent, organization-aware responses, grounded in your real repositories, services, and documentation.

• You benefit from Qodo Aware’s agentic reasoning and advanced retrieval, even outside the Qodo interface.

• Eliminate context switching—your tools now understand your code as if a senior engineer were helping.

---

Setup and Installation

Before you start

Contact Qodo to receive your client domain and token.

These are necessary for setting up Qodo Aware as an MCP.

Requirements

• Node.js installed (v18.0.0 and above)

• Cursor, Windsurf, Claude Desktop or another MCP Client

Installation

You can add Qodo Aware as an MCP server to any product that supports the Model Context Protocol (MCP).

Check out our open source repository:

GitHub - qodo-ai/open-aware: Aware - Deep Code Research Agent for Complex Codebase & Knowledge that “Act As Your Agentic Principal Engineer”GitHub

Installation steps vary by tool:

Cursor

1. Open Cursor Settings.

2. Navigate to the MCP section and select Add new global MCP server.

3. Paste the Qodo Aware MCP configuration in your mcp.json file.

You can also add Qodo Aware to a specific project by creating a separate mcp.json file inside the project directory. See Cursor's MCP documentation to learn more.

Windsurf

Add the Qodo Aware MCP configuration to your Windsurf MCP config file.

Claude Desktop

Add the Qodo Aware MCP configuration to your Claude Desktop claude_desktop_config.json file.

GitHub Copilot

Add the Qodo Aware MCP configuration to the mcp section of your Copilot Coding Agent configuration file:

Repository -> Settings -> Copilot -> Coding agent -> MCP configuration.

For more information, see the official GitHub documentation.

Other Products

If your product supports MCP, add the Qodo Aware configuration wherever MCP servers are defined in that tool’s settings or configuration file.

Configuration

{
  "mcpServers": {
    "remote-codebase-search": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<QODO_AWARE_CLIENT_DOMAIN>/mcp/",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer <QODO_AWARE_TOKEN>"
      }
    }
  }
}

Contact Qodo to receive your client domain and token to replace QODO_AWARE_CLIENT_DOMAIN and QODO_AWARE_TOKEN.