Connected apps (MCP)¶
You can use your AI Analysts from an external AI app such as Claude, ChatGPT or Cursor. You paste your organization's MCP server address into the app and sign in once. After that, the app can ask every AI Analyst you can use in Explorer, and show you the charts and tables they produce.
For what this is for and what the app can and can't do, see AI Analyst MCP Server.
Availability
- Who can do this: any member with the Chat capability in at least one Workspace, once an administrator has turned on the MCP server and allowed the app. See MCP server.
- Deployment: Actian SaaS. Support for self-managed deployments is coming soon.
Find the server address¶
You need your organization's Server address. You can find it in two places:
- Settings → Connected apps. You can also open it from your account menu at the bottom of the sidebar: click your name and choose Connected apps.
- Use in another app, under the message box of a conversation once an AI Analyst is chosen. The dialog shows the address, the apps your organization allows with a link to each app's setup guide, and an example prompt you can copy.
Click Copy address. The address has this form:
https://<your AI Analyst host>/mcp
If the page says The MCP server is off for this organization, ask someone who manages the organization to turn it on. If no apps are listed, none has been allowed yet.
Connect an app¶
The steps depend on the app. The steps below follow each app's own documentation at the time of writing; if a menu has moved, use the app's guide linked in the table further down.
Claude¶
These steps are for an individual Claude plan. Free plans are limited to one custom connector.
- In Claude, go to Customize → Connectors.
- Click + Add, then Add custom connector.
- Enter a name, for example
AI Analyst. - Paste the server address and click Continue.
- Review the authentication settings Claude detected and click Continue.
- Under Authentication, choose Sign in now.
- Under OAuth client, keep Use Claude's published identity (Recommended).
- Click Add. Your browser opens the AI Analyst sign-in.
- Sign in and allow the app.
To use it, start a chat, click + at the lower left of the message box, choose Connectors, and turn the connector on.
Claude Team and Enterprise plans
An Owner first adds the connector for the whole Claude organization under Organization settings → Connectors → Add → Custom → Web, with the same address and settings. After that, each person goes to Customize → Connectors, finds the connector and clicks Connect.
Warning
Don't choose Register automatically under OAuth client. AI Analyst accepts only the apps your administrator allowed, identified by their published identity, so an automatically registered client is refused.
ChatGPT¶
- In ChatGPT, open Plugins.
- Click the plus button, then Add custom MCP server.
- Enter a name, for example
AI Analyst, and a description. - Under Connection, paste the server address as the MCP server URL.
- Configure authentication, read the risk warning, and select I understand and want to continue.
- Click Create as a plugin. When ChatGPT asks you to sign in, your browser opens the AI Analyst sign-in.
- Sign in and allow the app.
- Review the tools ChatGPT found and install the plugin.
To use it, start a new conversation, type @ in the message box and select the plugin.
Note
Your ChatGPT account and workspace policies decide whether you can add a custom MCP server. If the option is missing, ask your ChatGPT workspace administrator.
Other apps and app guides¶
For the other apps, follow the app's own guide for adding a remote MCP server and paste the server address when it asks for a URL. Settings → Connected apps in Studio links to the same guides (How to add an MCP server).
| App | Guide |
|---|---|
| Claude | Claude guide |
| ChatGPT | ChatGPT guide |
| Claude Code | Claude Code guide |
| Codex | Codex guide |
| Cursor | Cursor guide |
| VS Code | VS Code guide |
| Zed | Zed guide |
| OpenCode | OpenCode guide |
| Goose | Goose guide |
An app that is not in the supported list can't sign in.
Sign in and allow the app¶
When the app connects for the first time, it opens AI Analyst in your browser.
- Sign in the way you normally do. Enterprise SSO works here too.
- A page shows the app's name and the organization it wants to connect to, with a list titled This app will be able to:
- See the AI Analysts you can use
- Ask those AI Analysts questions as you
- Find and continue your past conversations
- Read the charts, tables, and reports you can open
- If you belong to more than one organization, check Organization and switch to the one you want. A connection works in one organization only.
- Click Allow. Your browser returns to the app.
Nothing is shared with the app until you click Allow. If you close the page instead, the app is not connected.
If you can't allow the app¶
| Message | What it means | What to do |
|---|---|---|
| The MCP server is turned off for this organization. | The organization hasn't turned the MCP server on. | Ask someone who manages the organization. |
| Ask your administrator to grant access to this app. | The organization hasn't allowed this app. | Copy the text on the page and send it to your administrator. |
| You don't have access to a workspace this app can use. | You don't hold the Chat capability in any Workspace. | Ask to be added to a Workspace. See Members. |
| This request has expired. Start again from the app. | The sign-in took too long. | Go back to the app and connect again. |
Ask your AI Analysts¶
Once the app is connected, ask in plain language. For example:
Ask AI Analyst what our revenue was last quarter by region.
The app chooses an AI Analyst you can use, asks the question and shows you the answer. A few things work differently from Explorer:
- Name the AI Analyst if you want a specific one. For example, Ask the Sales Analyst…. Otherwise the app picks from the AI Analysts you can use. The example prompt in Use in another app does this for you.
- Follow-ups stay in the same conversation. Ask a follow-up in the same chat and the app continues the conversation with the same AI Analyst.
- Longer questions take time. An answer can take several minutes. If it isn't ready when the app stops waiting, the app checks back for it. You don't need to ask again; asking again starts a second conversation.
- You can pick up earlier work. Ask the app to find a conversation you had before, in Explorer or in an app, and continue it. Ask it to find a chart, table or report you saved.
Charts, tables and reports¶
- Charts and tables are drawn in the chat in apps that support it (see Supported apps). You can switch a chart between Chart and Data, and open it with Open in AI Analyst. In other apps you get a text preview of the data and a link.
- Reports are not displayed in the chat. The app gives you a link that opens the report in AI Analyst, and it can read the report's text to answer questions about it.
- Large tables are shortened in the chat. Open the link to see every row in AI Analyst.
The app can't save, share or change anything in AI Analyst. To save a chart as an Artifact, or to share it, open the link and do it in Explorer. See Artifacts.
Some apps ask you to confirm before they call a tool or open a link. That confirmation comes from the app, not from AI Analyst.
Where your conversations appear¶
Every question you ask from an app is a normal AI Analyst conversation. It appears in your Explorer conversation history, labelled with the app, for example via Claude. You can open it in Explorer and continue it there.
Members with the Edit capability can see these conversations in Studio Monitoring, like any other conversation. See Sharing.
Questions asked from an app count against your organization's message allowance. See Usage and message limits.
Your connections¶
In Explorer, Settings → Connected apps lists the apps you have connected under Your connections, with the date you connected each one.
- A connection lasts 30 days. After that, the app asks you to sign in again.
- To disconnect an app, remove the AI Analyst connector or server in that app's settings.
- An administrator can end connections. If the MCP server or the app is turned off for your organization, your connection ends. When it is turned back on, connect the app again.
- Losing access ends the connection. If you no longer have access to any Workspace, the connection ends. When you get access back, connect the app again.