Enterpret MCP Server
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.
Pro and Max
Click here to add Enterpret to Claude. Sign in if prompted, then click Connect to authorize access.
...or, find it manually:
Open Claude and click Customize in the sidebar
Click Connectors
Click the + button
Search "Enterpret"
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:
Navigate to Organization settings → Connectors (an Owner or Primary Owner may be required)
Search for "Enterpret" in the Connectors Directory and click Add
Then:
Open Customize → Connectors (older versions may show Settings → Connectors)
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:
Open Customize → Connectors (older versions may show Settings → Connectors)
Find Enterpret in the list of available connectors
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
Open Terminal (or Command Prompt on Windows) and run:
claude mcp add --transport http --scope user enterpret https://wisdom-api.enterpret.com/server/mcpRegister the Enterpret MCP server from Terminal. Start Claude Code:
claudeRun the
/mcpcommand, 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
Quick Install (Recommended)
In your Enterpret dashboard, navigate to Settings > Enterpret MCP
Click the Connect button next to Cursor
Select Connect next to Cursor in Enterpret MCP settings. 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:
Press
Cmd+Shift+P(Mac) orCtrl+Shift+P(Windows) to open the command paletteType "Cursor Settings" and select it
Open your global ~/.cursor/mcp.json file, or .cursor/mcp.json for a project
Add a named entry under mcpServers
Add the following configuration:
{ "mcpServers": { "enterpret": { "command": "npx", "args": ["-y", "mcp-remote", "https://wisdom-api.enterpret.com/server/mcp"] } } }Save the file (
Cmd+SorCtrl+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 from | Steps |
|---|---|
| ChatGPT | Open the Enterpret plugin and install it using the available control. Follow the prompts to sign in to Enterpret and authorize the connection. |
| Enterpret | Go to Settings → Enterpret MCP and select Connect beside ChatGPT. Complete installation and sign-in in ChatGPT. |
- After installation, start a new chat so the bundled Skill is available.
- Type @ and select Enterpret, or ask ChatGPT to use Enterpret.
- 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.”
- 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.
In your Enterpret dashboard, go to Settings > Enterpret MCP.
Click Connect next to ChatGPT Codex. Allow your browser to open the Codex desktop app.
Select Connect next to ChatGPT Codex to open the desktop plugin. Install the Enterpret plugin and follow the prompts to connect your Enterpret account.
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
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.
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.
Use the following configuration:
MCP server URL:
https://wisdom-api.enterpret.com/server/mcpTransport 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
Sign in to Grok and open the Connectors page. In Plugins, select the Connectors tab.
Find New Connector in the Connectors tab. Select New Connector, then Custom. If your Grok team admin already added Enterpret, open that connector and skip to sign-in.
Choose Custom to add a connector by server URL. Enter Enterpret in Name and paste
https://wisdom-api.enterpret.com/server/mcpinto Server URL. Select Add Connector to open the Enterpret sign-in window.Name the connector Enterpret, paste the MCP server URL, and select Add Connector. 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.
Check the organization before authorizing access. Return to Grok and check that Enterpret appears under Connected.
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.
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
Authorizationheader using theBearerscheme. If you usemcp-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.
get_organization_details— Identifies your Enterpret organization, so answers link back to your dashboard.get_profile— Returns the Enterpret profile associated with the credentials used for the connection.get_graph_schema— Lets the assistant see what kinds of feedback you track and how it's organized.get_query_examples— Gives the assistant reference patterns for common kinds of feedback questions before it answers.search_graph_fields— Surfaces integration-specific data points like Zendesk tags, App Store ratings, or Gong call metadata.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.resolve_taxonomy_scope— Finds the taxonomy nodes to use when filtering feedback for a count or breakdown.run_graph_query— Queries feedback to answer your question. Where enabled and available, results can include citation links to supporting records.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
npxormcp-remote, checknode --versionin 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/mcpMake 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/mcpEnsure 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.