Skip to main content
Supported for single-tenant and on-prem deployments.

​
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 Context Engine as an MCP server?

Qodo Context Engine 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 Context Engine.
  • You get consistent, organization-aware responses, grounded in your real repositories, services, and documentation.
  • You benefit from Qodo Context Engine’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 startContact Qodo to receive your client domain and token.These are necessary for setting up Qodo Context Engine 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 Context Engine 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”

Installation steps vary by tool:
1
  1. Open Cursor Settings.
2
  1. Navigate to the MCP section and select Add new global MCP server.
3
  1. 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.
Add the Qodo Aware MCP configuration to your Windsurf MCP config file.
Add the Qodo Aware MCP configuration to your Claude Desktop claude_desktop_config.json file.
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.
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>"
      }
    }
  }
}
Replace QODO_AWARE_CLIENT_DOMAIN and QODO_AWARE_TOKEN with your client domain and token.