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.

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. Use the Alteryx Skill or MCP integration.

If setup is complete, the plugin used in a supported AI or MCP client should be able to call the local Alteryx MCP Server.

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.

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.

In this section: