Skip to main content

Connect an AI App to the Alteryx MCP Server

Connect a supported MCP client to the Alteryx MCP Server so a third-party AI app can use supported Alteryx capabilities.

Before You Start

Before you connect an AI app, make sure you meet these requirements:

  • An Alteryx One account on a Professional or Enterprise Edition.

  • A supported MCP client.

  • An MCP client that supports OAuth 2.0.

  • A supported client with an approved redirect URI.

  • Datasets with Use For Generating Insights turned on, or workflows and analytic apps available through the Apps toolset.

  • Permission to use the Alteryx assets and capabilities available through the MCP Server.

To set up assets before you connect a client, go to Set Up Assets.

Copy the MCP Server URL

  1. Open Agent Studio in Alteryx One.

  2. Select the Custom MCP Connections tab.

  3. Copy the Alteryx MCP Server URL for your region.

Region

MCP Server URL

United States

https://us1.alteryxcloud.com/mcp/v1

Europe

https://eu1.alteryxcloud.com/mcp/v1

Australia

https://au1.alteryxcloud.com/mcp/v1

Set Up Your AI App

The Setup Instructions section includes setup options for various popular AI platforms. Select Open Instructions next to your AI platform and follow the step-by-step instructions to connect to Alteryx One using the MCP Server URL.

Limit Available Toolsets

You can add query parameters to the MCP Server URL to limit which toolsets are available through a connection. To learn what each toolset does, go to Alteryx MCP Server Toolsets.

  • toolsets: Exposes specific toolsets by name. Supported options are insights and apps.

  • readOnly: Exposes only toolsets that do not update data. Supported options are true and false.

Example for the Insights toolset:

https://us1.alteryxcloud.com/mcp/v1?toolsets=insights

Example with multiple parameters:

https://us1.alteryxcloud.com/mcp/v1?toolsets=insights&readOnly=true

In this section: