Skip to main content
mdfahd
Gainsight Employee ⭐️⭐️
May 27, 2026

Set Up Gainsight CC MCP

  • October 19, 2026 at 5:58 AM
  • 31 replies
  • 2268 views
  • Translate All

This article helps Admins and Community Managers set up and configure Gainsight Community MCP AI assistants such as Claude, ChatGPT, Microsoft Copilot Studio, and Gemini CLI.

Overview

 

Gainsight Community MCP is a connector that lets you interact with your community data through AI assistants such as Claude, ChatGPT, Microsoft Copilot Studio, and Gemini CLI. Model Context Protocol (MCP) is a standardized way for AI assistants to connect to external tools and data sources. Once connected, you can ask questions in natural language and get answers drawn directly from your community.

Gainsight Community MCP follows the standard MCP specification with OAuth 2.1 authentication and streamable HTTP transport, so MCP-compliant clients can connect. Claude, ChatGPT, Microsoft Copilot Studio, and Gemini are already supported, and many more clients can connect after Gainsight enables their redirect URIs. For details, refer to the Limitations section.

 

Setting up the Gainsight Community MCP involves two parts:

  • Admin Setup: An admin enables Community MCP for the community from Control. This is a one-time configuration step.
  • User Connection: Each user connects from their AI client, such as Claude, using their community credentials. The tools available to each user depend on their community role and permissions.

The scope of tools available depends on your community role. When you connect, the connector authenticates you against your community and displays only the tools that match your role. The tools are organized across three areas:

  • Search Tools: Find community content such as posts, topics, and discussions.
  • Analytics Tools: Query community performance metrics and dashboard KPIs.
  • Admin Tools: Review moderation queues, recognition data, user information, and community structure.

For more information on AI Tools, refer to the Use CC MCP Write Tools article.

The AI assistant selects the appropriate tools based on the prompts. Since the available tools depend on the community role assigned to each user, reviewing tool access helps determine what types of questions to ask and what data to expect.

  • Search to find content
  • Analytics to understand trends
  • Admin to see what needs your attention.

Prerequisites

Before you begin, ensure the following requirements are met:

  • You must have an admin, Community Manager, or a Moderator role in your Gainsight Customer Community to enable the Community MCP server in Control.
  • The community must have at least one authentication method configured (SAML, OIDC, OAuth2, Google SSO, or local username and password).
  • Users who will connect must have an active account in the community with a valid role assignment.
  • Users must have access to an AI client that supports MCP connectors, such as Claude, ChatGPT, Microsoft Copilot Studio, or Gemini CLI. Client-specific prerequisites, such as plan requirements, are listed in each client section.
  • If your organization restricts outbound network traffic, ensure that your AI client can reach the Gainsight Community MCP server at https://mcp.insided.com/mcp. Refer to your AI client's documentation for the current IP range list.

Limitations

 

The following limitations apply to the Gainsight Community MCP:

  • Admin tools are read-only. You cannot modify community data through the MCP connector.
  • After you turn on or turn off the Community MCP toggle, it may take some time for the change to take effect.
  • You can connect only one community at a time.
  • The Gemini web app (gemini.google.com) does not support custom MCP connectors. Use Gemini CLI to connect Gemini.
  • Microsoft 365 Copilot chat does not accept an MCP server URL directly. Add Gainsight Community MCP as a tool on a Copilot Studio agent instead.
  • Gainsight Community MCP accepts connections only from a fixed allowlist of OAuth redirect URIs. Gainsight maintains this allowlist, so you do not configure it. Claude, ChatGPT, Microsoft Copilot Studio, and Gemini are already on the list. If you connect from another client, such as Glean or Cursor, the first connection attempt fails because the redirect URI of the client is not yet on the list. Gainsight adds the URI after the failed attempt, and later connections from that client succeed. Contact Gainsight Support to have the redirect URI enabled for your organization.

Enable MCP in Customer Community

 

Admins must turn on the Community MCP Server toggle in Control before users can connect from their AI clients. This is a one-time setup step.

To enable Community MCP:

  1. Log in to Control.
  2. Navigate to AI > AI Settings. The AI Settings page appears.
  3. Scroll down to Features and turn on the Community MCP toggle.
     

    Note: After you turn on the toggle, it may take some time for the change to take effect.

Configure Gainsight Community MCP in Claude

 

Once Community MCP is enabled in control, admins need to set up the configuration in AI Assistant.

The connector uses dynamic client registration with PKCE, so no OAuth client credentials, authorization URLs, or callback allowlists are required at any point.

The following steps describe the connection flow for Claude. To configure Gainsight Community MCP in Claude:

  1. Log in to Claude.
  2. Navigate to Customize > Connectors. The Connectors page appears.
  3. Click the Plus icon.
  4. Select Add Custom Connector. The Add Custom Connector dialog appears.
     
  5. In the Name textfield, enter the name to identify the connector. For example Gainsight Community MCP.
  6. In the Remote MCP URL textfield, enter the MCP URL https://mcp.insided.com/mcp
     

     

    Note: No OAuth client credentials are required.

  7. Click Add. The MCP connector is now added in Claude.
     
  8. Click Connect. The Select Your Community page appears.
  9. In the Community URL textfield, enter your valid community URL. For example, if your community URL is https://community.acme.com, enter community.acme.com
     

  10. Click Continue. The community Login page appears.
     
  11. Enter the following details:
    • Username: Enter a valid user name.
    • Password: Enter your community password.
  12. Click LOG IN. The Authorize Application dialog appears.
  13. Click Approve. The Login is successful.

The permissions displayed depend on your role in the community.

The following table describes the permissions displayed for each role level:

Role

Permissions Displayed

All users

View your profile information, Search community content, View your email address

Admins and Community Managers

All user permissions, plus: View community analytics

Admins

All user permissions, plus: View community analytics, Manage community settings

Moderators

All user permissions, Manage Community settings

 

You are redirected back to Claude. The connector now shows as connected with a list of available tools based on your role.
 

 

Configure Gainsight Customer Communities MCP in ChatGPT

 

You can configure Gainsight CC MCP using ChatGPT Plugins. To install using plugins:

  1. Go to  https://chatgpt.com/plugins
  2. Search for Gainsight Customer Communities (or) click here 
  3. Click Install plugin.

Configure Gainsight Community Custom MCP Server in ChatGPT

 

ChatGPT connects to remote MCP servers as apps in Developer mode. Once connected, ChatGPT can call Gainsight Community MCP as a live data source and return answers drawn from your community.

Prerequisites

 

Before you begin, ensure the following requirements are met:

  • ChatGPT Admin access: A ChatGPT admin must have the ability to create apps in ChatGPT.
  • Developer Mode Enabled: Developer mode must be turned on in ChatGPT settings for the Create app option to appear.
  • Community MCP turned on: Community MCP must be turned on in Control. For more information , refer to the Enable MCP in Customer Community section.

Create the MCP Plugin in ChatGPT

 

Creating the plugin registers the Gainsight Community MCP server in ChatGPT.

To create the MCP plugin in ChatGPT:

  1. Go to https://chatgpt.com/plugins
  2. From the Add dropdown, click Add Custom MCP Server.
     
  3. Enter the following details
    1. (Optional) Upload an Icon for the MCP.
    2. In the Name text field, enter the name of the app. For example, Gainsight Community.
    3. (Optional) In the Description text field, describe the app.
    4. In the MCP Server URL field, enter https://mcp.insided.com/mcp.
    5. From the Authentication dropdown list, select OAuth.

      Note: No OAuth client credentials or callback URLs are required. ChatGPT registers itself through dynamic client registration.

       

  4. Select the I understand and want to continue checkbox.
  5. Click Create as plugin. The new plugin is created and appears in your Plugins list.

Connect and Authenticate

 

After the plugin is created, each user connects to it with their own community credentials.

To connect and authenticate:

  1. Navigate to ChatGPT > Plugins.
  2. Select the newly created plugin by your admin. For example, Gainsight Community.
  3. Click Connect. The Select Your Community page appears.
  4. In the Community URL field, enter your valid community URL. For example, if your community URL is https://community.acme.com, enter community.acme.com.
  5. Click Continue. The community Login page appears.
  6. Enter your community Username and Password.
  7. Click LOG IN. The Authorize Application dialog box appears.
    Note: If your community uses SSO, complete the sign-in for your organization instead of entering a username and password.
  8. Click Approve. You are redirected to ChatGPT with a confirmation message.

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

Try MCP in chat

 

After you successfully connect your community to the MCP, test it in the chat.

  1. Navigate to ChatGPT > Plugins.
  2. Select your MCP plugin.
  3. Click Try in chat.

 

Configure Gainsight Community MCP in Microsoft Copilot Studio

 

Copilot Studio reaches MCP servers through Copilot Studio. You add the server as an MCP tool on an agent, and users then interact with that agent. Microsoft 365 Copilot chat does not accept an MCP server URL directly.

 

Prerequisites

 

Before you begin, ensure the following requirements are met:

  • Microsoft Copilot Studio access: You must have permissions to create or edit agents in Microsoft Copilot Studio.
  • An existing Copilot agent: The MCP tool is added to an agent within Copilot Studio.
  • Community MCP turned on: Community MCP must be turned on in Control. For more information, refer to the Enable MCP in Customer Community section.

Create an MCP Tool in Copilot

 

In Copilot Studio, you create the MCP tool for an agent:

  1. Navigate to Copilot Studio.
  2. Select an existing Copilot agent and click Tools. The Tools page appears.
  3. Click + Add a tool.
  4. Select MCP. The Model Context Protocol window appears.
  5. Enter the following details:
    • Server name: Enter a display name for the MCP app. For example, Gainsight Community.
    • Server description: Enter a brief description of what the app does.
    • Server URL: Enter the endpoint URL for the server: https://mcp.insided.com/mcp.
  6. From Authentication, select the OAuth 2.0 option.
  7. From Type, select the Dynamic discovery option.

    Note: Dynamic discovery requires no client ID, client secret, authorization URL, token URL, or callback URL. Copilot Studio discovers the endpoints and registers itself.

  8. Click Create, followed by Next. The Add tool dialog box appears.

Connect and Authenticate

After you create the tool, connect it to your community and add it to the agent:

  1. Select Create a new connection.
  2. Complete the community sign-in flow. On the Select Your Community page, enter your community URL. For example, if your community URL is https://community.acme.com, enter community.acme.com.
  3. Click Continue. Sign in with your community credentials.
  4. Click Approve in the Authorize Application dialog box.
  5. Click Add to agent.

The server appears on the Tools page of the agent. Open it to review the tools that the server exposes and to turn individual tools on or off.

Note

  • Copilot Studio supports the Streamable transport only, which is what the Gainsight Community MCP server uses. SSE is not supported.
  • MCP access in Copilot Studio runs through Power Platform connectors. If a data loss prevention (DLP) policy governs Power Platform connectors in your tenant, it also governs this server and its tools.
  • Each user of the agent signs in with their own community credentials, so the tools available through the agent reflect the community role of that user.

 

Configure Gainsight Community MCP in Gemini CLI

 

Gemini CLI connects to Gainsight Community MCP over HTTP transport with OAuth. The Gemini web app (gemini.google.com) does not support custom MCP connectors, so these instructions apply to Gemini CLI only.

 

Prerequisites

 

Before you begin, ensure the following requirements are met:

  • Gemini CLI is installed. For more information, refer to the Gemini CLI Repository on GitHub.
  • Node.js is installed.

Note: Gemini CLI completes the OAuth flow on a localhost callback, so headless environments such as CI runners and browserless containers cannot complete sign-in.

 

Register the Server

 

Admins can register the server either by adding it through the command line or setting up the server manually.

 

Add the Server Using the Command Line

 

The command line is the fastest way to register the server. Run the following command:

gemini mcp add --transport http --scope user gainsight-community https://mcp.insided.com/mcp

 

Add the Server Manually

 

If you prefer to edit the configuration file, add the server manually.

To add the server manually:

  1. Open the Gemini CLI settings file using the following commands:
    • MacOS and Linux: ~/.gemini/settings.json
    • Windows: %USERPROFILE%\.gemini\settings.json
  2. Add the following entry:
     
    {
    "mcpServers": {
    "gainsight-community": {
    "httpUrl": "https://mcp.insided.com/mcp"
    }
    }
    }
  3. If other MCP servers are already configured, insert the gainsight-community entry into the existing mcpServers object instead of replacing it.
  4. Save the file and restart Gemini CLI.

Authenticate and Verify the Connection

 

After you add the server, sign in with your community credentials and confirm that the connection works.

To authenticate and verify the connection:

  1. In the terminal, start a session by running gemini.
  2. Run /mcp auth gainsight-community. A browser window opens.
  3. Complete the community sign-in flow in the browser window. On the Select Your Community page, enter your community URL. For example, if your community URL is https://community.acme.com, enter community.acme.com.
  4. Click Continue. Sign in with your community credentials.
  5. Click Approve in the Authorize Application dialog box.
     

    Note: Gemini CLI stores the tokens in ~/.gemini/mcp-oauth-tokens.json and refreshes them automatically. If the tokens expire, run the same command again.

  6. Run gemini mcp list to confirm that the server is registered, or run /mcp inside the session to see the connection state and the available tools.

Note: Gemini CLI can prompt you to approve tool calls as part of its security model.

 

Tools Available in Gainsight Community MCP

 

The Gainsight Community MCP provides a set of tools organized across three areas:

  • Admin
  • Search
  • Analytics

The tools available to you depend on your community role and the scopes granted during the connection flow.

The following table summarizes the scopes and tools available for each role: 

Role

Scopes Granted

Tools Visible

Admins

mcp:search, mcp:analytics, mcp:admin

All search, analytics, and admin tools

Community Manager

mcp:search, mcp:analytics, mcp:admin

All search, analytics, and admin tools

Moderator

mcp:search, mcp:admin

Search and admin tools

Registered user, Super-user

mcp:search

Search tools only

 

Admin Tool

The Admin Tool gives community admins a conversational way to review community state. It includes four read-only tools that surface information without modifying any community data.

The following table describes each Admin tool and the types of queries it supports:

 

Tool

What You Can Ask

Moderation Overview

Surface the moderation queue state, including trashed content and content with moderation labels.

Recognition Overview

Read leaderboards (all-time and weekly), available badges, an individual user's leaderboard position, and points history.

User Overview

Look up users by ID or field (email, username) and view their current role assignments.

Community Structure

Navigate the category tree, view content per category, and check visible topic counts.

 

The following scenario demonstrates how the Admin tools work together in a single conversation:

  • Prompt: What needs my attention today, and who should I celebrate this week?

    Result: The Moderation Overview surfaces content that has been trashed and content with active moderation labels, and the Recognition Overview returns this week's top point earners so you can recognize them publicly. 

Search Tool

The Search Tool allows you to query community posts, topics, and indexed content through the MCP connector. The AI assistant retrieves this data and uses its own capabilities to generate insights such as sentiment analysis across discussions, activity dashboards, member engagement breakdowns, and classification of search results by type.

Example prompts:

  • What were the most discussed topics this month?
  • Run a sentiment analysis on posts from the last 30 days.
  • Classify recent search results by type (questions, complaints, feature requests).
  • What were the most recent topics in the community?

Analytics Tool

The Analytics Tool allows admins and Community Managers to query community analytics data conversationally through the AI assistant. Previously, reviewing community KPIs required navigating to individual dashboards and manually comparing metrics across time periods.

The following table describes the insight areas available through the Analytics Tool:

 

Insight Area

What You Can Learn

Community Health

Overall community performance with period-over-period comparison across users, content, traffic, Q&A, and gamification.

User Insights

Individual user profiles and activity details.

User Trends

Registration trends, leaderboards, role breakdowns, active and churned user lists, and subscription activity.

Content Performance

Topic and reply analytics, Q&A metrics, response times, helpfulness ratings, and content gaps such as unanswered questions.

Audience Traffic

Pageview trends, visitor segments (contributors, reactors, viewers), and breakdowns by section or content type.

Product Ideas

Idea pipeline status, top-voted ideas, and delivered ideas.

 

Example prompts:

  • How is the community performing this quarter compared to last quarter?
  • How many new users joined in the last 30 days?
  • Which categories have the most unanswered questions?
  • Who are the top contributors this month?

Note: The AI assistant retrieves data that matches the KPIs visible in your community dashboards. The accuracy of the results depends on the quality and completeness of the data in your community.

    31 replies

    Nishers
    Contributor ⭐️⭐️
    May 27, 2026

    This is EPIC! I am so glad GainsightCC is keeping up! So I’ve gone ahead and togged MCP on however I don’t see a place to add a custom connector in my Claude instance!  Your directory screenshot might be outdated! Can I get help here?

     

    Translate
    Gainsight Employee ⭐️
    May 28, 2026

    Hi ​@Nishers 
     

    The custom connector option isn't in the Directory page - that only shows officially listed connectors. You'll need to add it as a custom connector.

     

    If you're on a Team or Enterprise plan, reach out to your IT/operations team and ask them to add this custom connector URL: https://mcp.insided.com/mcp - once they add it at the org level, it'll be visible for you to connect.

     

    Here's the full step-by-step setup guide with screenshots: https://communities.gainsight.com/integrations-54/set-up-gainsight-cc-mcp-beta-31009#Configure+Gainsight+Community+MCP+in+Claude

     

    You'll then log in with your existing community credentials - no separate account needed.

     

    We're also in the process of submitting for the official Connectors Directory - so soon you'll be able to find and connect it directly from that Directory page. Stay tuned!

    Translate
    aluciani
    Helper ⭐️
    May 30, 2026

    This sounds interesting, is Google Gemini an option here as well? 

    Wonder as well if it would make sense to add Glean as possible source. 

    Translate
    Gainsight Employee ⭐️
    May 30, 2026

    Hi ​​​​@aluciani 

    Google Gemini - Yes, Gemini is fully supported. Our MCP server follows the standard MCP specification with OAuth 2.1 authentication and streamable-http transport, so any MCP-compliant client can connect.

     

    Glean - Yes, Glean supports connecting to remote MCP servers via streaming HTTP and OAuth with PKCE, which is compatible with our MCP server.

    However, for Glean (and any MCP client other than Claude, ChatGPT, Microsoft Copilot Studio, and Gemini), the first connection attempt will fail. For security reasons, we maintain a fixed allowlist of redirect URIs for OAuth authentication.

    When a new MCP client tries to connect, its redirect URI won't be in our allowlist yet, so the OAuth flow will be rejected. We log that redirect URI on our side, add it to our supported list, and once that's done, subsequent connections from that client will work.

     

    So if you're connecting via Glean or any other MCP client not yet in our supported list - expect the first attempt to fail, and reach out to us so we can get it enabled for you.

    Translate
    sarahmasterton-brown
    Helper ⭐️
    June 2, 2026

    Thanks ​@mdfahd and the GS team for delivering on this - it’s transformational! 
    Does the MCP index all modules of the community: Ideation, Knowledge Base etc?

    Translate
    Every day is a school day
    Contributor ⭐️⭐️
    June 2, 2026

    First off, really excited to see the MCP connector for CC, we've already started testing it internally and the use cases for our team are very clear!

    One thing we'd love to see on the roadmap: more granular MCP permission scoping, separate from platform roles.

    Right now, the analytics and admin tools are only available to community admins and managers. That makes sense for the platform itself, but it creates a gap for our use case. We want our CSMs to be able to generate customer-specific insights through Claude (things like account activity, engagement trends, top contributors) without giving them full admin access to the community platform. Making someone an admin just to access MCP analytics isn't feasible at scale, and it would introduce access risks we'd rather avoid.

    The ideal would be an MCP-specific permission tier or a way to grant access to specific tool categories (e.g. analytics read-only) without elevating someone's role on the platform itself.

    Is this something on the roadmap, or is there a workaround we might be missing? This feature is very meaningful to us, so hopefully it's something the team can consider for a future release 🤠

    Translate
    mdfahd
    mdfahdAuthor
    Gainsight Employee ⭐️⭐️
    June 4, 2026

    Thank you ​@sarahmasterton-brown 
    Tagging PM and EMs for addressing your query
    FYI ​@Aleksandra 

    Translate
    Mohammed Fahd - Sr. Technical Writer
    mdfahd
    mdfahdAuthor
    Gainsight Employee ⭐️⭐️
    June 4, 2026

    Thank you ​@ndebban for your query.
    Tagging PMs for more information
    FYI ​@Graeme Rycyk ​@Larry ​@Aleksandra 

    Translate
    Mohammed Fahd - Sr. Technical Writer
    Gainsight Employee ⭐️
    June 4, 2026

    Hi ​@sarahmasterton-brown,

     

    “does the MCP index all modules of the community: Ideation, Knowledge Base etc?” → Yes.. all modules of community

    Translate
    Gainsight Employee ⭐️
    June 5, 2026

    Hi ​@ndebban 

    Thanks for the feedback - this is something we're actively discussing internally. The direction we're leaning towards is scoping MCP permissions at both platform roles and custom role level, so admins can configure which MCP capabilities (search, analytics, admin) each role gets access to. Will keep this thread updated as we make progress.

    Translate
    Contributor ⭐️⭐️
    August 26, 2026

    Hey ​@ajadhao have there been any updates on enabling more granular permissions? It’s quite an important functionality for us and we’re eager to expand the users with access to broader MCP capabilities!

    Translate