Configure an MCP server integration

Connect the automation orchestrator to a Model Context Protocol (MCP) server. Agent nodes use this connection to discover and call external tools.

Before you begin

  • You must have an administrator role in the automation orchestrator. For more information about roles, see Role-based access control.
  • You must have access to an MCP server endpoint, including:
    • The Base URL
    • Authentication credentials for the MCP server, if required
  • The MCP server must be accessible from the automation orchestrator network.

About this task

The Configure integration wizard guides you through three steps: integration details, connection credential, and tool enablement.

Procedure

  1. Complete the integration details.
    1. Log in to the automation orchestrator.
    2. Navigate to Configuration > Integrations.
    3. Click Configure integration.
    4. From the Integration type list, select MCP Server.
    5. Enter the integration details.
      Field Description
      Server name / ID A unique name that identifies this MCP server integration.
      Description An optional description of the MCP server and the tools it provides.
      Base URL The URL of the MCP server endpoint.
      Scope When Global is enabled, this integration is available to all projects. Disable to scope the integration to specific projects.
    6. Expand the Security section and configure the following optional fields.
      Field Description
      Allow HTTP connections Permits unencrypted HTTP URLs for this integration.
      Disable TLS certificate verification Skips validation of the server's TLS certificate on connections.
      CA certificate PEM-encoded CA certificate to trust for this integration's TLS connections.
    7. Click Next.
  2. Configure the connection credential (optional).

    This step is optional. If your MCP server does not require authentication, click Next to skip this step.

    1. Select a Health check credential from the list. This credential is used to verify the connection to the integration and perform periodic health checks.
      Note

      This credential is not the credential used by the integration at runtime in a workflow. Workflow credentials are configured separately in the workflow builder.
    2. Click Test connection to verify that the MCP server is reachable and to discover available tools.
      • If the test succeeds, a confirmation message is displayed.
      • If the test fails, review the error message and verify your Base URL and health check credential. For more information, see Test and monitor integration health.
    3. Click Next.
  3. Enable tools.
    1. Review the tools discovered from the MCP server.
    2. Enable the tools that you want to make available for use in workflows.
    3. Click Save.

Results

On the Integrations list page, verify that the new integration shows an Available status and the expected number of enabled resources.

Note

The MCP server integration is now available. Agent nodes in workflows can discover and use the tools provided by this MCP server during workflow execution. You can view discovered tools on the Resources tab of the integration details page.