Skip to main content
Use MCP when you want to connect Qodo Agentic Toolbox managed skills to a remote or custom agent, workflow, or application. For local development, Install Qodo Agentic Toolbox with the CLI. With MCP, your agent can use Qodo’s code understanding and review capabilities as part of its workflow. For example, you can:
  • Understand your codebase, including dependencies, relationships, and recent changes.
  • Retrieve the rules and standards that apply to a task.
  • Review changes before opening a pull request.
  • Retrieve and resolve review findings.
  • Access and manage Review Standards.
You connect your MCP-compatible client to Qodo’s MCP server using an API key to make Qodo Agentic Toolbox managed skills available to your agent. You don’t need to install the Qodo Agentic Toolbox to use its managed skills through MCP. For more information about choosing between MCP and the CLI, see the Agentic Toolbox overview.

Prerequisites

Before you connect, make sure you have:
  • An MCP-compatible client that supports Streamable HTTP and custom request headers.
  • Access to the repositories you want to work with in Qodo.
  • Access to your MCP client’s configuration or secure secret management.

Connect your MCP client

1. Create an API key

Create a personal API key in the Qodo portal. Follow Manage API keys in the Qodo portal for instructions.

2. Add the Qodo MCP server

Use the MCP server URL provided for your Qodo workspace.
For single-tenant (ST) and on-prem deployments, get the MCP server URL from the Qodo portal.
If your client accepts an mcpServers JSON object and supports custom request headers, use:
If your client uses a different configuration format, use these values:

3. Reload your MCP client

Restart or reload your MCP client after adding the server configuration. Once connected, verify that Qodo Agentic Toolbox managed skills appear in your client’s available skills or tools. The skills available to you depend on your Qodo workspace access and permissions.

Authentication

MCP authenticates requests to Qodo using the API key you created in the Qodo portal. The key is sent in the Authorization header:
Keep your API key secure. Do not commit it to source control or include it directly in configuration files that are shared with others.If your MCP client supports secure credentials or secret management, use it to store your API key.

Use Qodo Agentic Toolbox managed skills

After the connection is established, your agent can discover and call the Qodo Agentic Toolbox managed skills available to your workspace. Your agent decides when and how to use the available skills based on the task and the instructions you provide.

Troubleshooting

If the managed skills do not appear after you configure the server:
  • Confirm that your API key is valid and available to the MCP client.
  • Confirm that the Authorization header is configured correctly.
  • Verify that your client supports Streamable HTTP and custom request headers.
  • Reload or restart the MCP client.
  • Confirm that you have access to the required repositories in Qodo.
API keys can have an expiration period. If your key has expired or been revoked, create a new API key in the Qodo portal and update your MCP configuration.See Manage API keys in the Qodo portal.

Next steps