Connecting an AI Agent

Last updated: November 9, 2026

Tier Deployment
Launch     Grow    Enterprise Cloud     On-Prem

Note:

This page covers connecting an AI client. For what the MCP Server is and how it is governed, see Sisense MCP Server.

You connect an MCP-compatible AI client to Sisense by adding the Sisense MCP endpoint and signing in once with your Sisense credentials. There is nothing to install. Claude, ChatGPT, and Cursor are validated. Validation covers connecting and running the tools; whether a client can display rendered charts and dashboards depends on MCP Apps support in that client, described under Interactive Charts and Dashboards in Claude and ChatGPT below. Claude and ChatGPT users can also connect from each client's connector directory, without entering an endpoint. See Add It to Your MCP Client below.

Note for Administrators:

On Managed Cloud, the MCP Server is enabled by default under System Configuration > MCP. On self-hosted deployments, an administrator must first enable it at install or upgrade. See Enabling the MCP Server on Self-Hosted Deployments. To stop AI clients from connecting to a given environment, turn the Enabled toggle off. Each Sisense environment is controlled independently.

1. Get the Endpoint URL

Managed Cloud

The hosted MCP Server runs at a single Sisense address. There are two ways to tell it which deployment to work against, and both are supported.

If you want to use one deployment, with one target URL, use option 1 (this will eliminate the need to enter your target URL upon each sign in); if you want to be prompted to choose your deployment's target URL before signing in (e.g., the first time you sign in, or if you have more than one deployment to sign in to), use option 2.

Option 1: Name your deployment in the URL. Add a target query parameter set to your Sisense URL:

https://mcp.sisense.com/mcp?target=<your-deployment-url>

The client then connects straight to your deployment with no further prompting. This is the form administrators usually distribute when rolling the connector out to a team, because it settles both the endpoint and the deployment up front and nobody has to know or type their instance URL.

Option 2: Use the base endpoint and choose your deployment on screen. Add the endpoint without a target:

https://mcp.sisense.com/mcp

The first time you connect, Sisense presents a form where you enter your deployment URL before signing in. This suits individual users, and anyone who connects to more than one deployment.

Your Sisense administrator can confirm the exact endpoint and your deployment URL.

Self-Hosted

On self-hosted deployments, the endpoint is exposed by your own instance and serves that instance directly, so no target parameter is needed:

https://<your-deployment>/mcp

For example, https://company.sisense.com/mcp.

The endpoint is available only after your administrator has enabled the MCP Server. See Enabling the MCP Server on Self-Hosted Deployments. Your administrator provides the exact endpoint.

2. Add It to Your MCP Client

Add the endpoint as a remote (HTTP) MCP server. There are no credentials to enter. Authentication happens in the browser on first use.

3. Sign In and Approve Access

The first time the agent uses the server, your browser opens a Sisense sign-in page. Sign in with your existing Sisense credentials, including SSO, and approve access. Sisense issues the agent a short-lived credential scoped to you, and you are ready to go.

On self-hosted deployments running Sisense 2026.4.1 or later, the approval (consent) page shows your organization's logo, name, and colors instead of the Sisense branding. See Branding the Consent Page.

The connection stays signed in for 3 days from sign-in. Within that period, your client renews access automatically, so you do not need to do anything. Using the connection does not extend this period. After 3 days, sign in to Sisense again. See Troubleshooting below.

Note:

Each user connects individually. Every person who wants to use the MCP Server completes this sign-in with their own account. There is no shared login, and each user sees only the data their permissions allow.

4. Verify the Connection

Confirm the agent is connected before you rely on it:

  1. Check that the Sisense tools appear in your client's tool or connector list.

  2. Ask the agent to list your data sources, for example, "List my Sisense data sources."

  3. You should see the data models your account can access.

If the tools do not appear or the request fails, see Troubleshooting below.

Switching Deployment or Instance

Each connection is scoped to one deployment and one user.

  • To point an agent at a different Sisense deployment on Managed Cloud, change the target in the endpoint URL. On self-hosted, use the other deployment's own /mcp URL. The client prompts you to sign in again for that deployment.

  • Signing in as a different user, or connecting to a different instance, also starts a new sign-in. Credentials are never shared between users or deployments.

Interactive Charts and Dashboards in Claude and ChatGPT

Claude and ChatGPT can render charts and dashboards as live, interactive visualizations inside the conversation. For this to work, your administrator must add each client's content domain to the allowed origins in Admin > Security Settings > CORS Allowed Origins. Add the entry for every client your users connect:

  • Claude: https://*.claudemcpcontent.com

  • ChatGPT: https://*.web-sandbox.oaiusercontent.com

Use the subdomain wildcard form. Each client loads charts and dashboards from a subdomain (for example, Claude uses https://abc123.claudemcpcontent.com), so the browser origin is a subdomain, not the bare domain. Listing the bare domain on its own does not match, and charts and dashboards stay blocked.

Note:

Rendered Charts and Dashboards Depend on MCP Apps, Not on MCP Compatibility Alone.

Sisense renders charts and dashboards through MCP Apps, an extension for interactive content inside the conversation that not every MCP client implements. A client can be fully MCP compatible, connect successfully, and run every tool, and still have no way to display a rendered chart or dashboard. Claude and ChatGPT are validated for interactive charts and dashboards. In other clients, expect the narrative insights instead, and treat chart and dashboard rendering as unverified until you have tried it in that client.

Without these entries, queries and other tools still work, but dashboards and charts do not load, and users get text-only answers. Clients that do not support interactive content receive only the narrative insights, not a rendered chart or dashboard.

Troubleshooting