> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qodo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentic tools (MCPs)

<Badge color="deployment" size="sm" shape="pill">Enterprise</Badge>

<Info>
  Qodo IDE plugin, formerly Qodo Gen, brings local code review workflows to JetBrains and VS Code as part of the Qodo Platform.
</Info>

Agentic Tools (MCPs) allow you to integrate external tools and services into Qodo IDE plugin. This enables Qodo to access and use custom tools when needed.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-tools-overview.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=a48f3c39dd3bfa166ec7a8e933e46d4c" alt="Agentic Tools MCP panel showing Built-in MCPs and Custom MCPs with toggle controls" width="1224" height="1674" data-path="images/qodo-ide/mcp-tools-overview.png" />
</Frame>

## Requirements

You will need [Node.js](https://nodejs.org/) installed to run tools properly.

To verify you have Node installed, open the command line on your computer.

* On macOS, open the Terminal from your Applications folder
* On Windows, press Windows + R, type “cmd”, and press Enter

Once in the command line, verify you have Node installed by entering in the following command:

If you get an error saying “command not found” or “node is not recognized”, download Node from [nodejs.org](https://nodejs.org/).

Learn more on why Node.js is required in [Anthropic's official MCP documentation](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server).

## Agentic tools configuration

<Note>
  **Note:**

  If you're an Enterprise user, you may be unable to add new Agentic Tools if your system administrator has restricted additions in the **Agentic Tools Allow List**.
</Note>

To create a tool and add it to Qodo, you need the applicable MCP server configuration.

**Qodo supports two types of MCPs:**

1. **Local MCPs** These run directly in your environment and don’t require network calls. Ideal for internal tools or logic that doesn’t rely on external APIs.
2. **Remote MCPs (SSE MCPs)** These are hosted externally and communicate via HTTP. When setting up a Remote MCP, you'll provide a URL, and optionally, you can add custom HTTP headers (e.g., for authentication).

### 1. Local MCPs

The configuration for a local MCP is usually in JSON form. For example, the [GitHub MCP server configuration](https://github.com/modelcontextprotocol/servers) is:

You can find many MCP tools and setup options in the [MCP GitHub](https://github.com/modelcontextprotocol/servers/blob/main/README.md).

### 2. Remote (SSE) MCPs

SSE (Server-Sent Events) MCPs are recommended for Enterprise environments. They are easier to manage, more secure, and ideal for external services like Jira. If you're setting up an **Allow List** in your Enterprise environment, enable SSE-based MCPs for a smoother experience.

The SSE MCPs configuration relies on a URL.

To configure this type of tool, add the following as to the Agentic Tools configuration text box:

## Create a new Agentic Tool

Once you've got your [required MCP configuration](/qodo-ide/tools-mcps/agentic-tools-mcps#agentic-tools-configuration), you can create a new Agentic Tool for Qodo's Agent to use:

<Steps>
  <Step>
    **Open Qodo chat** Learn more about Agentic Mode and what it does.
  </Step>

  <Step>
    **Go to the Tools Management page**

    Click **Add new tools.**

    <Frame>
      <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-agent-mode-add-tools.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=c40dafef59551a9b1d70f971e6b06d89" alt="Qodo Gen agent mode panel with Add new tools button highlighted" width="806" height="945" data-path="images/qodo-ide/mcp-agent-mode-add-tools.png" />
    </Frame>
  </Step>

  <Step>
    **Create a New Tool** Click **Add new MCP** button at the top left of the tools management page.

    <Frame>
      <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-tools-panel-full.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=94eca97f29a64250e805df922b71262f" alt="Agentic Tools MCP full panel showing Add new MCP button and list of built-in and custom MCPs" width="988" height="1340" data-path="images/qodo-ide/mcp-tools-panel-full.png" />
    </Frame>
  </Step>

  <Step>
    **Enter Tool Configuration Details** Paste a JSON configuration script to configure your new tool. [Learn more about tools configuration](/qodo-ide/tools-mcps/agentic-tools-mcps#agentic-tools-configuration).

    <Frame>
      <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-new-tool-json-form.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=e5cc93c0d972cf34a949a97c25f0729b" alt="New Agentic Tool form with JSON configuration editor for adding an MCP server" width="599" height="908" data-path="images/qodo-ide/mcp-new-tool-json-form.png" />
    </Frame>
  </Step>

  <Step>
    **Save and Test** Save your configuration.

    * **A green dot** will indicate a successful connection.
      * A list of sub-tools will appear under the tool, indicating all the services this tool is capable of. You can toggle all sub-tools on or off.
      * Click **Auto approve** to automatically approve every in-chat use of that sub-tool.
      * You can turn sub-tools on or off by clicking the toggle button.

    <Frame>
      <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-organization-mcps.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=91899c19eac9c3ae419da4c728aba10e" alt="GitHub MCP showing expanded tools list with On toggle and Ask and Auto approve options" width="968" height="826" data-path="images/qodo-ide/mcp-organization-mcps.png" />
    </Frame>

    * **A yellow dot** indicates a problem with your connection. Try checking your configuration and API keys and make sure you've set them all correctly.

    <Frame>
      <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-github-no-tools.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=03ea0b463a041db6488e306ed9013505" alt="GitHub MCP entry showing No tools available with yellow connection indicator" width="904" height="300" data-path="images/qodo-ide/mcp-github-no-tools.png" />
    </Frame>
  </Step>

  <Step>
    **Modify or Delete:** You can edit or remove a tool as needed. **Some of the built-in tools, like Code Navigation, cannot be edited.**

    <Frame>
      <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-code-navigation-web-search.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=f4c2f722af4d6230ac0402bda358754b" alt="Code Navigation and Web Search built-in MCPs shown with toggle controls" width="978" height="234" data-path="images/qodo-ide/mcp-code-navigation-web-search.png" />
    </Frame>
  </Step>
</Steps>

## Remove or manage tools

You can scroll through all connected tools in the tools management page.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-add-new-tools-button.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=8846d84bb0b580b7f92834b14ef72612" alt="Qodo Gen agent mode showing Add new tools button to access tool management" width="806" height="945" data-path="images/qodo-ide/mcp-add-new-tools-button.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-tools-panel-compact.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=cb7935dd77f194af7a89f83ad475567d" alt="Agentic Tools panel showing all enabled built-in and custom MCPs with toggles" width="1224" height="1674" data-path="images/qodo-ide/mcp-tools-panel-compact.png" />
</Frame>

You can enable, disable, or modify the configuration of tools at any time. Click the **pen and note symbol** next to a custom tool's toggle button to modify a tool's configuration.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-github-json-editor.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=18eaed875c11a0b02ae64f247719eddd" alt="GitHub MCP JSON configuration editor showing server command and arguments" width="990" height="492" data-path="images/qodo-ide/mcp-github-json-editor.png" />
</Frame>

Toggling a tool off will disable Qodo from using it.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-web-search-off.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=27efd0f0273dfdd07a3222f9f13891fc" alt="Web Search MCP tool row with toggle switched off" width="972" height="126" data-path="images/qodo-ide/mcp-web-search-off.png" />
</Frame>

See the number of available tools any time at the bottom of Qodo Chat, under the chatbox. Clicking on it displays a list of available tools.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-agentic-mode-toolbar.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=9ba03a4052511d940f29accdb88eb4a9" alt="Qodo Gen chat toolbar showing Standard and Agentic mode tabs with tool count" width="938" height="282" data-path="images/qodo-ide/mcp-agentic-mode-toolbar.png" />
</Frame>

### Manage sub-tools

Click the small arrow next to a tool's name to open a list of sub-tools, indicating all the services this tool is capable of.

You can toggle all sub-tools on or off, and set whether your approval is needed for their use.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-github-tools-expanded.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=2cab93ee229c17517770c5c09a0abe91" alt="GitHub custom MCP expanded showing sub-tools with On, Ask, and Auto approve controls" width="984" height="888" data-path="images/qodo-ide/mcp-github-tools-expanded.png" />
</Frame>

## Troubleshooting

**A yellow dot** near the tool's name indicates a problem with your connection.

Try checking your configuration and API keys and make sure you've set them all correctly. Also, ensure your internet connection is stable.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-fetch-url-tools.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=0f78509cede6078b4608d2c7f4ada167" alt="GitHub MCP expanded showing No tools available indicating a connection issue" width="1194" height="346" data-path="images/qodo-ide/mcp-fetch-url-tools.png" />
</Frame>

## Agentic tools allow list

This feature is only available for Enterprise users.

The **Agentic Tools Allow List** feature enables enterprise organizations to enforce stricter governance over Agentic Tools usage in Qodo.

When enabled, this mode restricts developers to using only a predefined set of tools defined at the organization level.

This feature is ideal if you need tight control over tool configuration to comply with internal policies, reduce misconfigurations, and standardize environments.

### Activation flow

1. **Request Enablement** An organization admin submits a request to Qodo Support to enable Agentic Tools Allow List mode.
2. **Allow List Configuration** The Qodo DevOps team configures the organization's MCP allow list manually.

### Developer behavior

Once MCP Allow List mode is active:

* <Icon icon="check" /> **View Access:** Developers can view the organization-defined tools list upon their next login to Qodo.
* <Icon icon="check" /> **Overrides Allowed:** Developers may override values for existing environment variables listed in the allow list.
* <Icon icon="xmark" /> **No Custom Agentic Tools:** Developers **cannot** add new or custom tools outside the allow list.

<Frame>
  <img src="https://mintcdn.com/qodo/JM7O0sE7d8xjdl1v/images/qodo-ide/mcp-terminal-commands-settings.png?fit=max&auto=format&n=JM7O0sE7d8xjdl1v&q=85&s=ec0be70a4f10da4e9d7e4b5d80b50ff1" alt="MCP panel showing Built-in MCPs and Organization MCPs including hackernews and context7 entries" width="924" height="1100" data-path="images/qodo-ide/mcp-terminal-commands-settings.png" />
</Frame>
