Skip to main content

Install MCP Services for ArcGIS Enterprise

MCP for ArcGIS Enterprise is enabled through the MCP Services for ArcGIS Enterprise installable component on Windows and Linux. You install this component on your ArcGIS Enterprise hosting server. This page describes how to prepare for the installation, run the setup, and verify that MCP for ArcGIS Enterprise is available.

Prepare to install

Before you begin the installation, complete the following steps:

  1. Verify that the machine has a supported version of ArcGIS Server installed. For the list of supported versions, see Introduction to MCP for ArcGIS Enterprise.

  2. Verify that the ArcGIS Server site is configured as your ArcGIS Enterprise hosting server.

  3. Sign in to the machine using the same operating system account that was used to install ArcGIS Server.

  4. Download the MCP Services for ArcGIS Enterprise setup for your operating system from My Esri.

Note:

If your hosting server site contains multiple machines, you must install MCP Services for ArcGIS Enterprise on each machine in the site.

Run the setup

Caution:

The setup restarts the ArcGIS Server service during installation. Plan the installation for a time when this interruption will have minimal impact on users.

To install MCP Services for ArcGIS Enterprise on Windows, complete the following steps:

  1. Browse to the folder that contains the downloaded MCP Services for ArcGIS Enterprise setup.

  2. Run the setup program.

  3. On the welcome page, click Next.

  4. Read the master agreement. If you accept the terms, select I accept the master agreement and click Next. Otherwise, click Cancel to exit the setup.

  5. On the Ready to Install the Program page, click Install.

  6. When the installation completes, click Finish.

  7. Make sure that ArcGIS Server is running.

To install MCP Services for ArcGIS Enterprise on Linux, complete the following steps:

  1. Browse to the folder that contains the downloaded MCP Services for ArcGIS Enterprise setup.

  2. Run the installation script.

    ./MCPServicesforArcGISEnterprise-Setup.sh
    
  3. Wait for the installation to complete.

  4. Make sure that ArcGIS Server is running.

Verify the installation

After you install MCP Services for ArcGIS Enterprise on every machine in your hosting server site, complete the following steps:

  1. Make sure that ArcGIS Server is running.

  2. For ArcGIS Enterprise 12.2 and later, verify that External AI client access is turned on. If it is not, see Enable MCP for ArcGIS Enterprise.

  3. Verify that the default catalog endpoint is available. For the URL format, see Default catalog endpoint.

  4. Verify that your AI applications can discover and use the expected tools. For details, see Verify the connection.

Troubleshoot the installation

The setup requires a supported version of ArcGIS Server on the machine. If this requirement is not met, the setup displays a message and exits.

On Windows, the following message appears:

MCP Services for ArcGIS Enterprise setup requires ArcGIS Server versions 11.1, 11.3, 11.5, 12.1 or 12.2

On Linux, the following message appears:

A valid product for this setup was not detected.
  * Valid product: ArcGIS Server
This install will now exit.

If you see this message, complete the following steps:

  1. Verify that ArcGIS Server is installed on the machine and that its version is supported.

  2. Verify that you are running the setup on a machine in your hosting server site.

  3. Run the setup again.

Next steps

After you verify the installation, see the following:

To remove MCP Services for ArcGIS Enterprise later, see Uninstall MCP Services for ArcGIS Enterprise.