Connect MCP servers

You can connect Model Context Protocol (MCP) servers to your agent workflow to extend your agent's capabilities with custom tools, resources, and APIs.

Workflow Builder provides dedicated MCP step types that let you call tools, list resources, and query servers hosted on any MCP-compatible endpoint. You can also add MCP tools to Gemini agent steps so the model can invoke them dynamically during reasoning.

Before you begin

Before using this feature, complete the following steps:

  • Ensure that a Gemini Enterprise administrator has enabled the Workflow Builder feature toggle in your app's feature management settings. For more information, see Manage web app features.
  • Ensure that your Gemini Enterprise organization has access to at least one MCP-compatible server endpoint. For more information, see Set up a custom MCP server data store.

Add an MCP step to your workflow

App

  1. Open your Gemini Enterprise web app in a browser.
  2. Navigate to an existing agent or create a new agent.
  3. In the flow builder, click Add step.
  4. In the Add step panel, click MCP servers to expand the section.
  5. Click the MCP step you want to add.
  6. The MCP step is added to your workflow, and its configuration panel opens.
  7. Configure any additional parameters required by the selected step type.
  8. (Optional) Click Preview to preview the workflow and the operation of the MCP step.

Add MCP tools to a Gemini agent step

You can add MCP tools to a Gemini agent step so the model can discover and invoke them dynamically based on context. Unlike dedicated MCP steps that run deterministically in your workflow based on an event or trigger, MCP tools added to a Gemini agent step are available for the model to call as needed during its reasoning process.

App

  1. Open your Gemini Enterprise web app in a browser.
  2. Navigate to an existing agent or create a new agent.
  3. In the flow builder, click the Gemini agent step you want to configure. The agent configuration panel opens.
  4. Click Tools & Integrations to view available tools, including any MCP apps available in your organization.
  5. To enable access to the tool for your agent, click the Authorize toggle.

    The Gemini agent step can discover and invoke the authorized MCP apps at runtime, if required.

What's next