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.

  • Have access to the dataset you want to analyze, 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.

Set Up Your AI App

Setup steps vary by AI app and can change when the app updates its interface. Use these general steps, and refer to your AI app's documentation for the latest app-specific details.

  1. In your AI app, open the settings where you add an MCP server. Depending on the app, this might be called a connector, integration, or tool.

  2. Add a new remote MCP server, and enter 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

  3. If your app asks for an authentication method, select OAuth 2.0. If your app offers more than 1 OAuth option, select the option that uses dynamic client registration or dynamic discovery. You don't need to enter a client ID or client secret.

  4. Save the server, then connect. Your app opens an Alteryx One sign-in page.

  5. Sign in to Alteryx One, and approve access.

  6. Return to your AI app. The Alteryx capabilities you have permission to use are now available in the app.

Suggerimento

If you're not sure where to add an MCP server in your AI app, ask the app how to add a remote MCP server that uses OAuth. Give it your Alteryx MCP Server URL.

Supported AI Apps

You can connect these AI apps to the Alteryx MCP Server:

  • ChatGPT

  • Gemini Enterprise

  • Antigravity

  • Claude

  • Copilot Studio

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

    • apps

    • datasets

    • designer

    • knowledge

    • formulaService

    • assets

  • 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 questa sezione: