Skip to main content
Gainsight Inc.

Gainsight CS MCP Server Integration

  1. Last updated
  2. Save as PDF
This article helps Admins set up and configure the Gainsight CS Model Context Protocol (MCP

This article helps Admins set up and configure the Gainsight CS Model Context Protocol (MCP) server so that users can connect Gainsight CS data to external LLM tools such as ChatGPT. It also guides end users on how to use the MCP connection to query and write Gainsight data from within their LLM tool.

Overview

The Gainsight CS MCP server exposes a set of structured tools that connect Gainsight CS directly to large language models (LLMs) such as ChatGPT. Once connected, users can query companies, CTAs, Success Plans, and Timeline activities, and perform write actions such as creating CTAs and Success Plans, all through natural-language prompts in their LLM tool.

The MCP server acts as a general-purpose API connector. The LLM calls the exposed Gainsight tools based on user prompts, which means prompt quality directly affects the accuracy and usefulness of responses.

The MCP server requires user-level OAuth authentication with Proof Key for Code Exchange (PKCE) enabled. Before you begin the MCP setup, ensure that you have configured User Authentication with PKCE in your instance. For more information, refer to the OAuth for Gainsight APIs article.

Prerequisites

Ensure that you meet the following requirements before you begin:

  • Gainsight Admin access: You must have Admin-level permissions in Gainsight CS to create OAuth apps and enable PKCE.
  • LLM tool with MCP support: Your LLM tool (for example, ChatGPT) must support MCP integrations.
  • ChatGPT Admin access (if connecting through ChatGPT): A ChatGPT workspace admin must have the ability to create apps in ChatGPT. Developer Mode must be turned on in ChatGPT settings.
  • Client ID and Client Secret: The Gainsight Admin generates these credentials from the OAuth app configuration. The ChatGPT Admin uses these values to create the MCP app. 

Supported Capabilities

The MCP server exposes tools that allow your LLM to read and write Gainsight data. The following tables list currently supported capabilities.

Data Retrieval

Capability

Status

Look up company details

Supported

Query any MDA object

Supported

Fetch CTAs for a company

Supported

Fetch Success Plans

Supported

Read Timeline activities

Supported

Scorecards and Health Scores

Partial

Cross-account portfolio analysis

Supported

Write Actions

Capability

Status

Create CTAs

Supported

Update CTAs

Supported

Create Success Plans

Supported

Update Success Plans

Supported

Create Timeline activities

Supported

Delete records

Not Supported

Update company fields

Not Supported

Admin-level configuration

Not Supported

 Set Up the MCP Server Connection in ChatGPT

This setup requires coordination between the Gainsight Admin and ChatGPT admin. Follow the steps below to complete the integration between ChatGPT and Gainsight CS.

  • Configure OAuth with PKCE in Gainsight
  • Create the MCP App in ChatGPT
  • Complete the Connection
  • Connect and Authenticate

Configure OAuth with PKCE in Gainsight

The MCP server requires user-level OAuth authentication with Proof Key for Code Exchange (PKCE) enabled.

To enable PKCE:

  1. Navigate to Administration > User Management > Authentication tab.
  2. Click OAuth Applications.
  3. Locate an existing OAuth app or create a new one.

    OAuth App.jpg

    For more information on how to create an OAuth app, refer to the OAuth for Gainsight APIs article.
  4. Click the three-vertical dots menu.
  5. Click View/Edit. The application slide-out panel appears.

    Enable PKCE.jpg 
  6. Turn on the Enable PKCE (Proof Key for Code Exchange) toggle.
  7. Copy the Client ID and the Client Secret.
  8. Click Save.

Create the MCP App in ChatGPT

After enabling PKCE, ensure the Client ID and Client Secret are copied, as these are required for setting up the MCP app in ChatGPT.

  1. In ChatGPT, navigate to Settings > Apps.
  2. Turn on the Developer mode toggle. The Create app option is now available.

    Dev mode.jpg
     
  3. Click Create app. The New App window appears.
  4. Enter the following details to create the app:
    1. In the Name text field, enter the name of the app.
    2. (Optional) In the Description text field, describe the app.
    3. In the MCP Server URL field, enter the URL instance followed by /v1/ds-mcp/mcp. For example: https://your-domain.gainsightcloud.com/v1/ds-mcp/mcp
    4. From the Authentication dropdown, select OAuth.

      New Apps
       
  5. Select Advanced settings. The OAuth advanced settings dialog appears.

    advanced setting.jpg
     
  6. In the OAuth Client ID field, paste the Client ID copied from the previous section.
  7. In the OAuth Client Secret field, paste the Client Secret copied from the previous section.
  8. Copy the Callback URL.
  9. Select the I understand and want to continue checkbox.
  10. Click Create to create the app.

Complete the Connection

The Callback URL from the app settings is required to complete the connection in User Management.

  1. Navigate to Administration > User Management > Authentication tab.
  2. Click OAuth Applications.
  3. Locate an existing OAuth app.
  4. Click the three-vertical dots menu.
  5. Click View/Edit. The application slide-out panel appears.

    Callback URLs.jpg
     
  6. Paste the Callback URL copied from the previous section.
  7. Click Save to complete the connection.

Connect and Authenticate

After the Gainsight Admin and ChatGPT Admin complete the setup, each end user can connect to the new app.

  1. Navigate to ChatGPT > Apps.
  2. Select the newly created app. For example, in this case, GSMCP.

    GSMCP.jpg
     
  3. Click Connect. The Gainsight Login page appears.

    GSMCP Connect.jpg
     
  4. Click Continue to GSMCP to authenticate the connection.

    authenticate.jpg

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

GSMCP active.jpg

Set Up the MCP Server Connection in Claude

To set up an MCP server connection in Claude, you must add the Callback URLs below in Gainsight CS.

  • https://claude.ai/api/mcp/auth_callback
  • https://claude.com/api/mcp/auth_callback

Claude requires the same configuration in Gainsight CS as ChatGPT. Refer to the following sections to complete configuration in Gainsight CS.

  • Configure OAuth with PKCE in Gainsight
  • Complete the Connection

Create the Custom Connector in Claude

Once you have added a Callback URL and copied the Client ID and Client Secret from the Gainsight CS instance, you can now create a custom connector in Claude.

To create a custom connector in Claude:

  1. Navigate to Settings > Connectors.
  2. Click Add custom connector. The Add custom connector dialog appears.

    Add Custom Connector
     
  3. Enter the following details
    1. Name: Enter a name for the MCP Server.
    2. Server URL: Enter the URL instance followed by /v1/ds-mcp/mcp. For example: https://your-domain.gainsightcloud.com/v1/ds-mcp/mcp
  4. Expand Advanced settings:
    1. In the OAuth Client ID field, paste the Client ID copied from the previous section.
    2. In the OAuth Client Secret field, paste the Client Secret copied from the previous section.
  5. Click Add.

Add details

Connect and Authenticate

After the Gainsight Admin and Claude Admin complete the setup, each end user can connect to the new app.

To connect and authenticate:

  1. Navigate to Settings > Connectors. The Connectors page appears.
  2. Click Connect. Claude redirects you to the Gainsight login page.

    connect claude
     
  3. Log in with your Gainsight credentials. After authentication, Claude confirms the connection
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Article type
    Topic
    Custom Filter
    Admin Guides
  2. Tags
    1. ChatGPT integration
    2. Claude Integration
    3. MCP Server Integration
    4. PKCE