Skip to content
⌘K
InboxAsk a human

Enterpret MCP Server

Updated by Vaishnavi

The Enterpret MCP server brings your customer feedback — themes, accounts, sentiment, verbatim quotes — into Claude, ChatGPT, Codex, Cursor, Notion, and Glean. This article covers what it can do, how to set it up, and how to troubleshoot a connection.

Key capabilities:

  • Query the customer feedback available to the authenticated Enterpret connection.

  • Request answers with source links and verify the underlying records; citation availability can depend on the tool and rollout.

  • Retrieve customer quotes with available source and speaker attribution; check the quote and attribution against its source.

  • Discover entities, taxonomy values, and source-specific metadata fields on demand


Choose the guide for your task: This page maintains common server, authentication, and connection guidance. Use Claude plugins for reusable Claude skills, multiple Enterpret organizations for separate desktop connections, or Notion Custom Agents for a Notion workflow.

Setup Instructions

Claude (Web & Desktop)

Note: Connector availability and limits depend on your Claude plan and organization settings. Follow the options shown in Claude and its current connector documentation.

The Enterpret listing in Claude’s directory with a Sign in to add button.
Open the Enterpret listing and sign in if prompted.

Pro and Max

Click here to add Enterpret to Claude. Sign in if prompted, then click Connect to authorize access.

...or, find it manually:

  1. Open Claude and click Customize in the sidebar

  2. Click Connectors

  3. Click the + button

  4. Search "Enterpret"

  5. Click Connect to authorize access

Ask your question directly — no initialization step is required.

Team and Enterprise

Setting up Enterpret for your team is a two-step process: an admin adds the connector for the organization, then each team member connects individually.

Step 1: Admin adds the connector

Click here to add Enterpret to Claude. Sign in if prompted, then click Add to enable it for your organization.

...or, find it manually:

  1. Navigate to Organization settings → Connectors (an Owner or Primary Owner may be required)

  2. Search for "Enterpret" in the Connectors Directory and click Add

Then:

  1. Open Customize → Connectors (older versions may show Settings → Connectors)

  2. Find Enterpret in the list and click "Connect" to authorize access

Adding the connector makes it available to the team. In the individual sign-in flow described here, each member still connects and authorizes their own account; organization enablement alone does not grant data access.

Step 2: Members connect individually

Click here to add Enterpret to Claude. Sign in if prompted, then click Connect to authorize access.

...or, find it manually:

  1. Open Customize → Connectors (older versions may show Settings → Connectors)

  2. Find Enterpret in the list of available connectors

  3. Click "Connect" to authorize access

Ask your question directly — no initialization step is required.

Each member authenticates with their own account — queries and usage are tracked individually.


Claude Code

  1. Open Terminal (or Command Prompt on Windows) and run:

    claude mcp add --transport http --scope user enterpret https://wisdom-api.enterpret.com/server/mcp
    Terminal example of adding the Enterpret MCP server in Claude Code.
    Register the Enterpret MCP server from Terminal.
  2. Start Claude Code:

    claude
  3. Run the /mcp command, select Enterpret from the list of MCP servers, then click "Authenticate" to complete the authentication flow

Ask your question directly — no initialization step is required.


Cursor

  1. In your Enterpret dashboard, navigate to Settings > Enterpret MCP

  2. Click the Connect button next to Cursor

    The Cursor row in Enterpret MCP settings with a Connect button.
    Select Connect next to Cursor in Enterpret MCP settings.
  3. This will start the configuration process in Cursor with your organization's MCP settings prefilled

Ask your question directly — no initialization step is required.

Manual Setup

Manual Setup

If auto-configuration doesn't work, you can manually configure Cursor:

  1. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows) to open the command palette

  2. Type "Cursor Settings" and select it

  3. Open your global ~/.cursor/mcp.json file, or .cursor/mcp.json for a project

  4. Add a named entry under mcpServers

  5. Add the following configuration:

    { "mcpServers": { "enterpret": { "command": "npx", "args": ["-y", "mcp-remote", "https://wisdom-api.enterpret.com/server/mcp"] } } }
  6. Save the file (Cmd+S or Ctrl+S)

Ask your question directly — no initialization step is required.


ChatGPT

The Enterpret plugin gives ChatGPT access to your customer feedback and a Skill for selecting relevant taxonomy nodes. Describe the topic in your own words; you do not need to supply node identifiers. Review the selected scope and supporting feedback in the answer.

Connect fromSteps
ChatGPTOpen the Enterpret plugin and install it using the available control. Follow the prompts to sign in to Enterpret and authorize the connection.
EnterpretGo to Settings → Enterpret MCP and select Connect beside ChatGPT. Complete installation and sign-in in ChatGPT.
ChatGPT row in Enterpret MCP settings with the Connect button outlined in amber.
Select Connect beside ChatGPT in Settings → Enterpret MCP.
  1. After installation, start a new chat so the bundled Skill is available.
  2. Type @ and select Enterpret, or ask ChatGPT to use Enterpret.
  3. Ask a focused question with the topic, dates, and filters you need, such as “Use Enterpret to summarize onboarding complaints from the last 30 days, with supporting feedback links.”
  4. Review what was counted, the selected taxonomy scope, date window, and cited feedback before using the result.

If Enterpret is unavailable: check installation, connection authorization, and your ChatGPT workspace’s plugin controls. If you installed it while a chat was open, start a new chat. Installation and permission to access Enterpret are separate.

For provider installation and workspace controls, see OpenAI’s plugins guide.

Codex App

Use the Enterpret plugin in the Codex desktop app to query customer feedback from your workspace.

  1. In your Enterpret dashboard, go to Settings > Enterpret MCP.

  2. Click Connect next to ChatGPT Codex. Allow your browser to open the Codex desktop app.

    The ChatGPT Codex row in Enterpret MCP settings with a Connect button.
    Select Connect next to ChatGPT Codex to open the desktop plugin.
  3. Install the Enterpret plugin and follow the prompts to connect your Enterpret account.

  4. Start a new chat and ask Codex to use Enterpret to answer your customer-feedback question.

For command-line setup, follow the Codex CLI instructions below.


Codex CLI

Open Terminal and run:

codex mcp add enterpret --url https://wisdom-api.enterpret.com/server/mcp

Complete the Enterpret sign-in if a browser window opens. If you still need to sign in, run this command and follow the browser prompts.

codex mcp login enterpret
Terminal example of codex mcp get enterpret showing the Streamable HTTP server URL.
Check the server URL with codex mcp get enterpret.

Ask your question directly — no initialization step is required.


Notion Custom Agents

Where enabled, connect Enterpret to a Notion Custom Agent to research feedback in a configured workflow. Authenticate the connection and select the tools that agent may use; support depends on the host and connection settings.

Follow the step-by-step setup in Enterpret in Notion Custom Agents.

Note: Notion currently documents MCP connections for Business and Enterprise plans. For a custom server, a workspace admin enables custom MCP servers in Settings → Connections → Manage and controls which connections members may install. Authenticate the connection for each Custom Agent.

Notion’s Add connection menu with Add custom MCP at the bottom.
Find Add custom MCP in Notion’s Add connection menu. Screenshot from Notion Help.

Glean

Connect Enterpret to Glean so users can query customer feedback from the Glean Assistant and wire Enterpret tools into Glean Agent Builder workflows. A Glean administrator configures the server and tools in the Admin Console. With OAuth User authentication, each user must also authorize their own Enterpret account. Shared admin credentials or API keys use the access of that shared identity; choose and review the intended setup with your administrator.

Check Glean’s Connectors catalog for Enterpret first and use its setup flow if listed. For a custom connection, open the Admin Console and go to Platform → Tools → Vendor Provided Tools (via MCP). Select Add, open the Vendor provided tools (via MCP) tab, and select Import tools from MCP server.

Glean’s Add tools dialog with Vendor provided tools (via MCP) selected and Import tools from MCP server highlighted.
Select Import tools from MCP server to configure a custom connection. Screenshot from Glean documentation.

Use the following configuration:

  • MCP server URL: https://wisdom-api.enterpret.com/server/mcp

  • Transport type: Streaming HTTP

  • Authentication: OAuth User for individual Enterpret authorization, or API Key with a Bearer token from Enterpret Settings → Enterpret MCP for an approved shared-credential setup

Once connected, an admin can enable individual Enterpret tools for the Glean Assistant and for Agent Builder, and apply role-based access to control which creators can use them in agents. For the full admin walkthrough, see Glean's documentation: Connect Remote MCP Servers to Glean.


Grok (Web)

Connect Enterpret to Grok as a custom MCP server. You need a Grok account and access to the Enterpret workspace you want to query. Grok makes connectors available to all users.

Grok Business and Enterprise. A team admin first adds the server in the xAI console under Grok Business → Connectors → Add Connector → Other. Use the server URL below. Team members then connect their own accounts in Grok. See Grok’s connector management guide.

Connect your account

  1. Sign in to Grok and open the Connectors page. In Plugins, select the Connectors tab.

    Grok’s Plugins window with the Connectors tab selected and the New Connector button on the right.
    Find New Connector in the Connectors tab.
  2. Select New Connector, then Custom. If your Grok team admin already added Enterpret, open that connector and skip to sign-in.

    Grok’s New Connector dialog showing the Custom option beneath the search field.
    Choose Custom to add a connector by server URL.
  3. Enter Enterpret in Name and paste https://wisdom-api.enterpret.com/server/mcp into Server URL. Select Add Connector to open the Enterpret sign-in window.

    Grok’s Custom Connector form with Enterpret in Name, the Enterpret MCP URL in Server URL, and Add Connector in the lower right.
    Name the connector Enterpret, paste the MCP server URL, and select Add Connector.
  4. In the window that opens, sign in to Enterpret if prompted. On the authorization screen, check that Organization shows the workspace you want to connect, then select Authorize.

    Enterpret MCP authorization for Grok, showing Acme Communications in the Organization field and the Authorize button below the access details.
    Check the organization before authorizing access.
  5. Return to Grok and check that Enterpret appears under Connected.

    Grok’s Connected list showing Enterpret, its server hostname, and an Added checkmark.
    The connector appears under Connected.

Test the connection

In a new Grok chat, send the following prompt.

Use the Enterpret connector to call get_organization_details. Report the organization name and dashboard URL returned by that tool.

Expand the answer’s activity to check for Used Enterpret Get Organization Details. Confirm the name and dashboard URL match your workspace.

Grok’s response shows Used Enterpret Get Organization Details and returns the Acme Communications demo workspace name and dashboard URL.
Grok returns the connected workspace name and dashboard URL.

Troubleshoot

  • Can’t find the connector. In a Grok Business or Enterprise workspace, ask your team admin to add it. For a personal account, open the Connectors page and look for Custom.

  • Sign-in failed. Check the server URL and confirm that you can sign in to the intended Enterpret workspace. If Grok is waiting for authentication, look for the separate sign-in window. If an expired connector offers Reconnect, select it and sign in to Enterpret again.

  • Wrong workspace. If the authorization screen shows a different organization, select Cancel, switch to the intended workspace in Enterpret, and try again. If you already authorized the connection, disconnect it in Grok and connect again. Run the test prompt to confirm the workspace.

For Grok’s setup options, see Grok’s custom MCP connector documentation.


Other AI Tools

For MCP-compatible AI tools not listed above, use this URL to connect to the Enterpret MCP: https://wisdom-api.enterpret.com/server/mcp

Ask your question directly — no initialization step is required.


Bearer Token Authentication

Bearer Token Authentication

In addition to OAuth, Enterpret MCP supports Bearer token authentication for MCP clients that require this method.

  • Navigate to Settings > Enterpret MCP in your Enterpret dashboard

  • Click Generate under Auth Token

  • Copy the token

  • Configure the HTTP Authorization header using the Bearer scheme. If you use mcp-remote, use the example below.

Example configuration:

{ "mcpServers": { "enterpret": { "command": "npx", "args": [ "-y", "mcp-remote", "https://wisdom-api.enterpret.com/server/mcp", "--header", "Authorization:${ENTERPRET_AUTH_HEADER}" ], "env": { "ENTERPRET_AUTH_HEADER": "Bearer YOUR_AUTH_TOKEN_HERE" } } } }

Replace YOUR_AUTH_TOKEN_HERE with your token. Keep the space after Bearer in the environment value. The header argument references that value so the configuration also works with the Windows argument handling described by mcp-remote.

Note: Token lifetime and expiry behavior depend on the token and workspace configuration. Check the expiry shown in Enterpret and regenerate or reconnect when required. A fixed six-month lifetime does not apply to every token.


Available Tools

Your AI assistant can choose from the tools exposed by the connection. The names below describe the newer catalog; available names depend on the current rollout and your connection. Follow the tool list your client actually receives.

  1. get_organization_details — Identifies your Enterpret organization, so answers link back to your dashboard.

  2. get_profile — Returns the Enterpret profile associated with the credentials used for the connection.

  3. get_graph_schema — Lets the assistant see what kinds of feedback you track and how it's organized.

  4. get_query_examples — Gives the assistant reference patterns for common kinds of feedback questions before it answers.

  5. search_graph_fields — Surfaces integration-specific data points like Zendesk tags, App Store ratings, or Gong call metadata.

  6. search_graph_values — Looks up the exact themes, accounts, sources, or taxonomy values in your data, so the assistant searches and filters on real labels.

  7. resolve_taxonomy_scope — Finds the taxonomy nodes to use when filtering feedback for a count or breakdown.

  8. run_graph_query — Queries feedback to answer your question. Where enabled and available, results can include citation links to supporting records.

  9. find_user_quote — Surfaces verbatim customer quotes from the records behind your answer.

Migrating from older tool names? Depending on availability, you may see get_schema, execute_cypher_query, and search_knowledge_graph or the newer names above. Supported legacy names remain callable. Refreshing or reconnecting updates a cached tool list, but does not by itself enable a catalog that is unavailable to your connection.


Citations and quotes

Enterpret MCP provides tools for researching the underlying feedback and retrieving supporting evidence. The host AI assistant writes the answer, so review its scope, claims, and source links.

Verify supporting citations

When a result includes a count or percentage citation, open it to inspect the supporting records and check the population, filters, and time window. Citation coverage can be incomplete, and not every computed value has a record link. Verify unsupported numbers before relying on them.

Customer quotes in their own words

Request verbatim customer quotes with source links. Check the returned wording and available speaker or company attribution against the original feedback. Quote coverage can be incomplete; an AI assistant's response is not a guarantee that suitable quotes exist or that every attribution is present.


Frequently asked questions

I don't see the Enterpret MCP in my AI tool
  • Ensure you completely restarted your application (not just minimized)

  • If your configuration uses npx or mcp-remote, check node --version in Terminal and use a supported Node.js LTS release. Native HTTP connections do not require Node.js.

  • Verify you're using the correct MCP URL: https://wisdom-api.enterpret.com/server/mcp

  • Make sure you have a stable internet connection

I'm getting "Cannot connect to MCP server" error
  • Double-check your MCP URL - ensure you're using https://wisdom-api.enterpret.com/server/mcp

  • Ensure there are no extra spaces in your configuration

  • Try restarting your AI tool again

  • Check your client’s connection and authentication logs. A browser response from the endpoint can help diagnose network reachability, but does not validate an authenticated MCP connection.

I'm getting "npx command not found" error (Windows)
  • Restart your computer after installing Node.js

  • Try using the full path: "C:\\Program Files\\nodejs\\npx.cmd" instead of "npx"

I'm behind a corporate firewall - what do I need?
  • If using mcp-remote, ensure your firewall permits the npm registry needed to install it

  • Allow HTTPS access to the server configured here, wisdom-api.enterpret.com, and the authentication endpoints used during sign-in. Ask your administrator to review the connection if network policy blocks it.

  • If behind a corporate proxy, npm and HTTPS requests need proxy configuration

My older tool calls are returning a "DEPRECATED:" prefix message

A DEPRECATED: description can identify a supported legacy tool and its newer counterpart. Use the tools available in your client; the newer catalog may require rollout enablement. Contact Enterpret if a required tool is unavailable.

My MCP connection looks connected but isn't showing the new tools

MCP hosts may cache tool lists. Try a fresh conversation or reconnect to refresh the list. The catalog also depends on the server's availability settings, so reconnecting does not guarantee newer names appear. If calls fail or required tools remain unavailable, contact Enterpret.

I have access to multiple organizations - how does this work?

Each Enterpret organization uses its own API token to connect to multiple orgs, add a separate mcp-remote entry per org (same URL, unique name, port, and token) in claude_desktop_config.json. See Connecting Claude to Multiple Enterpret Organizations for the full template and steps.