Skip to main content

Install Alteryx MCP Server Dependencies

Overview

The Alteryx One app installer includes the local Alteryx MCP Server, which allows supported AI clients and Alteryx Skills to work with your local Alteryx Designer environment.

It doesn't include its own AI model. Connected AI clients act on behalf of the signed-in Alteryx One user and can only access the assets and capabilities that user already has permission to use.

The Alteryx One app installer doesn't install Microsoft .NET 8 Desktop Runtime. You must install it separately before the Alteryx MCP Server can run.

Local and Alteryx One Servers

The local Alteryx MCP Server works on .yxmd files and data on your machine. The Alteryx One server works with assets in Alteryx One.

To connect to the Alteryx One server, go to Get Started with Alteryx Skills.

Requirements

Before you use the local Alteryx MCP Server, make sure you meet these requirements:

Install Microsoft .NET 8 Desktop Runtime

Microsoft .NET 8 Desktop Runtime is required for the Alteryx MCP Server to run.

  1. Download the Alteryx-supplied .NET 8 Desktop Runtime installer: https://downloads.alteryx.com/runtimes/windowsdesktop-runtime-8.0.28-win-x64.exe.

  2. Run the installer.

  3. Follow the installation prompts.

  4. If prompted, approve the installation with administrator privileges.

  5. After installation, restart any open terminal, AI client, or MCP client.

Managed or Multi-User Environments

In managed or multi-user environments such as Citrix, Virtual Desktop Infrastructure (VDI), Terminal Services, or locked-down enterprise desktops, an IT administrator might need to install Microsoft .NET 8 Desktop Runtime before users can run the Alteryx MCP Server.

Contact your IT administrator if you don't have permission to install Microsoft .NET 8 Desktop Runtime.

Install Alteryx One App

  1. Download and run the Alteryx One app installer.

  2. Follow the installation prompts.

  3. If the installer indicates that Microsoft .NET 8 Desktop Runtime is already installed, no additional runtime action is required.

  4. If the installer indicates that Microsoft .NET 8 Desktop Runtime is not installed, you can complete the installation, but the Alteryx MCP Server won't run until Microsoft .NET 8 Desktop Runtime is installed.

  5. Select Finish.

  6. Restart any open terminal, AI client, or MCP client so it can detect the installed Alteryx MCP Server.

Verify the Installation

To verify that the Alteryx MCP Server is ready:

  1. Open your supported AI or MCP client.

  2. Ask your AI assistant to check its connection to the local Alteryx MCP Server.

  3. Confirm that the response shows authorization as verified, a status of active, and a Designer version of 2026.2 or later.

If authorization isn't verified, open the Alteryx One app and sign in. If the Designer version is earlier than 2026.2, upgrade Designer to 2026.2 or later.

Troubleshooting

The AI Client Can't Start the Alteryx MCP Server

This can happen for several reasons:

  • Microsoft .NET 8 Desktop Runtime is not installed.

  • The terminal, AI client, or MCP client was open before the Alteryx One app was installed and needs to be restarted.

  • Alteryx One app sign-in, licensing, or entitlement is not valid.

Try these steps:

  1. Confirm that Microsoft .NET 8 Desktop Runtime is installed.

  2. Confirm that the Alteryx One app was installed successfully.

  3. Close and reopen your terminal, AI client, or MCP client.

  4. Open the Alteryx One app and sign in.

  5. Try the Alteryx Skill again.

Tools Fail With an Unsupported Designer Version Error

This can happen if the version of Designer installed on your computer is earlier than 2026.2.

Upgrade Designer to 2026.2 or later, then restart your AI client or MCP client.

The Installer Says .NET 8 Desktop Runtime Is Missing

Install Microsoft .NET 8 Desktop Runtime from the Alteryx download page, then restart any open terminal, AI client, or MCP client.

You can install the Alteryx One app before Microsoft .NET 8 Desktop Runtime, but the Alteryx MCP Server won't run until the runtime is installed.

I Don't Have Permission to Install .NET 8 Desktop Runtime

Contact your IT administrator. Microsoft .NET 8 Desktop Runtime might require administrator approval, especially in managed enterprise environments.

I Use Citrix, VDI, Terminal Services, or Another Managed Desktop

Contact your IT administrator when you install the Alteryx One app. Your organization might need to deploy Microsoft .NET 8 Desktop Runtime through its standard software management process before users can run the Alteryx MCP Server.

I Installed Everything, But the Connection Still Fails

Try these steps:

  1. Restart your AI client or MCP client.

  2. Restart the Alteryx One app.

  3. Restart Designer.

  4. Confirm that you are signed in to Alteryx One.

  5. Confirm that your Alteryx One account has access to the relevant Alteryx capabilities.

  6. If the issue continues, contact Alteryx Support.

Notes for Administrators

  • The Alteryx One app installer installs the Alteryx MCP Server, but Microsoft .NET 8 Desktop Runtime must be installed separately.

  • For managed desktop environments, install Microsoft .NET 8 Desktop Runtime using your standard enterprise software deployment and patching process.

  • The Alteryx MCP Server uses the signed-in Alteryx One user's existing permissions and entitlements. Installing the Alteryx MCP Server doesn't grant users access to additional Alteryx assets or capabilities.