Skip to main content
Gainsight Inc.

Connect Gainsight PX to LLMs Using MCP [Beta]

  1. Last updated
  2. Save as PDF

This article explains how to configure and connect the PX MCP Server with supported AI assistants such as Claude and ChatGPT.

Overview

The PX MCP Server enables you to connect Gainsight PX with supported AI assistants such as Claude and ChatGPT. After the connection is configured, you can use natural-language prompts to access product experience insights, feature adoption metrics, engagement analytics, survey feedback, and other contextual PX data directly from your AI workflow.

This document provides setup and configuration instructions for the PX MCP Server. For more information about PX MCP Server capabilities, supported use cases, limitations, and available tools, refer to the Gainsight PX MCP Server Integration Overview article.

Depending on your organization’s policies, administrative controls, and preferred AI workflow, you can configure the PX MCP Server using one of the following methods:

  • Claude organization setup: A Claude organization administrator configures the PX MCP integration for the organization. Individual users of the organization can then connect and use the integration from their Claude accounts. 
  • ChatGPT organization setup: A ChatGPT workspace administrator creates and configures the PX MCP app for the organization. Individual users can then connect and use the integration from their own ChatGPT accounts. Some organisations may allow individual users to create and configure apps.
  • Local MCP setup for Claude Desktop: If organization-wide connector setup is unavailable or restricted, individual users can configure a local MCP connection directly in Claude Desktop. 

Set Up the MCP Server Connection in Claude

Integrating Claude with Gainsight PX using the PX MCP server allows Claude to access and query product experience insights and contextual PX data directly. 

Add the PX Connector for Your Organization

A Claude organization administrator must first add Gainsight PX as a custom connector before users in the organization can use Claude with the PX MCP server. After the administrator completes the organizational setup, individual users can use the connection in their own accounts without performing additional configuration.

Ensure Third-Party Connectors (or Custom Connectors) are enabled for your workspace.

To add a connector in Claude as the admin: 

  1. Click the profile icon in the bottom-left corner of Claude, and select Organization settings.
  2. Navigate to the Connectors section and click the Add button. 
  3. Hover on Custom and select the Web option (recommended).

    Organization settings page showing the Connectors library with the Add menu expanded to create a custom web connector.
     
  4. In the Add custom connector dialog box, enter the following details:
    1. Name: Gainsight PX MCP
    2. Server URL: Use one of the following URLs based on your PX data center. To identify your PX data center, refer to your PX application URL. For example, https://app-us2.aptrinsic.com indicates the US2 data center.
      1. US1: https://mcp.aptrinsic.com/mcp
      2. US2: https://mcp-us2.aptrinsic.com/mcp
      3. EU: https://mcp-eu.aptrinsic.com/mcp

        Add custom connector dialog showing configuration fields for connector name and MCP server URL in Claude organization settings.
         
  5. Select Add. PX appears in the connectors list for your organization for Claude Web, as well as Claude Desktop.

    Connectors library displaying Gainsight PX MCP added as a custom web connector in organization settings.

Connect PX to Claude

After the administrator adds the PX connector, individual users can connect and authenticate from their own Claude accounts.

  1. From the left menu, click Customize. 
  2. Navigate to Connectors. 
  3. In the Not connected section, select the PX connector installed by your organization's Claude admin.

    Claude desktop Customize panel showing Gainsight PX MCP connector with a Connect button to establish the MCP integration.
     
  4. Click Connect. The PX login page appears. 
  5. Sign in to your PX account when prompted, to connect Claude to your PX subscription. On successful login, you are redirected back to Claude’s Connectors page, with the PX connector connected. Here, you can view the available tools and set tool permissions. By default, all tools require approval per prompt. You can set all or individual tools to Always allow.

    Claude desktop Gainsight PX MCP permissions screen showing tool access controls with approval options including Always allow, Needs approval, Blocked, and Custom.
     

After successful authentication, the MCP connection appears as active in Claude.

Claude desktop connector menu showing Gainsight PX MCP enabled and available from the Connectors menu in the chat composer.

Set Up the MCP Server Connection in ChatGPT

Integrating ChatGPT (Web) with Gainsight PX using the PX MCP Server allows ChatGPT to access and query product experience insights and contextual PX data directly. 

Create the MCP App in ChatGPT

A ChatGPT workspace administrator is typically required to publish organization-wide MCP apps, depending on your ChatGPT workspace permissions and policies. The administrator can configure the PX MCP integration for your organization. After the setup is complete, individual users can connect and use the integration from their own ChatGPT accounts without additional configuration.

To add the PX MCP app in ChatGPT (web) as an administrator: 

  1. Navigate to Workspace Settings > Apps. 
  2. Click Create. 
  3. Click Enable developer mode in the popup that appears, in case you do not have it already enabled.

    ChatGPT workspace Apps page with the Apps section selected and the Create button highlighted to add a new custom app.
     
  4. In the New App window, enter the following details to create the app:
    1. In the Name text field, enter the name of the app as Gainsight PX MCP.
    2. (Optional) In the Description text field, describe the app.
    3. (Optional) In the Icon section, click the + icon to upload the PX icon. Click here to download the icon. 
    4. In the MCP Server URL field, enter one of the following URLs based on your PX data center. To identify your PX data center, refer to your PX application URL. For example, https://app-us2.aptrinsic.com indicates the US2 data center.
      1. US1: https://mcp.aptrinsic.com/mcp
      2. US2: https://mcp-us2.aptrinsic.com/mcp
      3. EU: https://mcp-eu.aptrinsic.com/mcp
    5. From the Authentication dropdown, leave the selection to OAuth. 
  5. Review the disclaimer message and select the I understand and want to continue checkbox.

    New App modal in ChatGPT workspace showing Gainsight PX MCP configuration with OAuth authentication and MCP server URL settings.
     
  6. Click Create. The new app is created and appears in the Drafts tab of apps  for your organization.
  7. Click Publish.

    ChatGPT workspace Apps Drafts tab showing the unpublished Gainsight PX MCP app with the Publish button highlighted."
     
  8. Review the warning information in the Review potential risk: Unauthorized data access section, and select the I understand checkbox. This is a standard warning displayed during MCP setup in ChatGPT.

    Security review panel for custom ChatGPT app highlighting the acknowledgment checkbox for unauthorized data access risk before publishing.
     
  9. Review the warning and permission details in the Review potential risk: Malicious app section, and select the I trust this app and I have reviewed... checkboxes. These confirmations are displayed during MCP app setup in ChatGPT to help you review app access and permissions.

    Security review panel for custom ChatGPT app showing trust confirmation checkboxes required before publishing the app.
     
  10. Click Publish. The app is added to the Enabled tab of apps  for your organization.

    Apps management page in ChatGPT workspace showing the published Gainsight PX MCP app listed under enabled apps.

Connect and Authenticate 

After the app creation is complete, ChatGPT admins or ChatGPT users of the organisation must proceed to connect ChatGPT with the organization's PX subscription. 

To connect: 

  1. Navigate to Workspace Settings > Apps.
  2. Access the PX MCP app using one of the following methods, depending on your role:
    1. As a ChatGPT administrator: For the newly added app, click the three-dots horizontal menu, and select App details.
      1. Click Show in directory.

        ChatGPT Apps page showing the Gainsight PX MCP app details modal with options for app details, user access, and disable actions.
         
    2. As a ChatGPT user in the organization: Select the PX MCP app from the organization apps list.

      ChatGPT connection modal for Gainsight PX MCP showing API key input field and Connect button for app authentication.
       
  3. Click Connect. 
  4. Click the Continue to Gainsight PX MCP button. 

    ChatGPT desktop interface showing the More menu expanded with Gainsight PX MCP listed as an available internal app.
     
  5. On the PX login page, sign in to your PX account when prompted, to connect ChatGPT to your PX subscription. On successful login, you are redirected back to ChatGPT’s Apps page, with the PX connector connected. Here, you can click the settings icon to view the available tools used by the MCP. 

After successful authentication, the MCP connection appears as active in ChatGPT.

ChatGPT connection approval modal for Gainsight PX MCP with admin-approved access details and Continue button.

Set Up a Local MCP Server Connection in Claude Desktop

You can configure a local PX MCP Server connection in Claude Desktop when your organization does not allow custom connectors, or when administrator approval for organization-wide integrations is unavailable or delayed. This setup enables individual users to connect Claude Desktop directly to Gainsight PX using a local MCP configuration.

Prerequisites: Ensure you have Node.js 18+ installed on your machine. For more information, refer to the Node.js download page.

To set up a local MCP: 

  1. Click the profile icon in the bottom-left corner of Claude, and select Settings.
  2. Navigate to the Developer section and click Edit Config. This opens your machine’s file viewer for Claude files. 
  3. Open the claude_desktop_config.json file using a text editor.
  4. Replace the existing content with the following configuration:
{
  "mcpServers": {
    "Gainsight PX MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.aptrinsic.com/mcp"
      ]
    }
  }
}

Update the MCP server URL based on your PX data center: 

  1. Save the configuration file.
  2. Restart Claude Desktop.

After Claude Desktop restarts, the PX login page opens automatically. Sign in with your PX credentials to connect Claude Desktop with your PX subscription.

After successful authentication, the PX MCP Server appears on the Connectors page under the Desktop section. From here, you can view the available tools and manage tool permissions. By default, all tools require approval for each prompt. You can configure individual tools or all tools to Always allow.

Claude desktop Connectors settings showing Gainsight PX MCP tool permissions with approval options including Always allow, Needs approval, and Blocked."

After authentication is complete, you can begin interacting with PX using Claude Desktop.

Claude desktop connector menu showing Gainsight PX MCP enabled and available from the Connectors menu in the chat composer.