Skip to main content
WisdomAI provides a hosted Model Context Protocol (MCP) server that lets you connect AI tools, such as Claude, ChatGPT, Cursor, and VS Code, directly to your WisdomAI domains. Once connected, you can ask natural language questions about your data and receive structured responses including text, tables, and interactive charts.
To connect a third-party MCP server as a data source inside WisdomAI, see Connect an external MCP server instead.

​
Before you begin

Before connecting WisdomAI, make sure you have:
  • Access to WisdomAI.
  • An MCP-compatible AI client.
  • An MCP URL that your client can reach.
  • A sign-in method supported by your organization.

​
Connect to the WisdomAI MCP Server

Complete the following steps to connect your AI client to the WisdomAI MCP Server and verify the connection.

​
Step 1: Choose your MCP URL

Use https://mcp.wisdom.ai/mcp. It is a common entry point for supported instances and prebuilt integrations. Use your custom MCP URL for custom connections, or when the central endpoint cannot reach your instance. This includes instances on private networks and staging or dev instances. To build the URL, append /mcp to the address you sign in at. For example, if you sign in at {your-instance}.askwisdom.ai, your MCP URL is https://{your-instance}.askwisdom.ai/mcp.
When using a custom MCP URL, use the same domain you use to sign in to WisdomAI. Both wisdom.ai and askwisdom.ai are valid depending on your deployment.
Your MCP client must be able to reach the URL you choose. For cloud-hosted clients, connectivity is required from the client’s servers; browser access or a local VPN alone is insufficient.

​
Step 2: Set up your AI client

Choose your AI client below and follow the steps to connect WisdomAI.
Connecting WisdomAI doesn’t create new access. You sign in with your own WisdomAI account, and the role and permissions you already have apply.
  1. In Claude, open Settings > Connectors.
  2. Click Add, then select Add custom connector.
  3. Enter the name WisdomAI or a representative name and paste your chosen MCP URL.
  4. Click Add to save the connector, then click Connect.
  5. Enter your work email, sign in, and approve the requested access.
On Claude Enterprise, custom connectors are added by an organization admin. If you don’t see the option to add one, ask your admin to add WisdomAI, then reload Claude.
  1. Sign in to Claude as an organization admin and open Settings > Connectors.
  2. Click Add, then select Add custom connector.
  3. Enter the name WisdomAI or a representative name and paste your chosen MCP URL.
  4. Click Add. Users in your organization will then find WisdomAI in their connectors and can connect to it.
Open Settings > Connectors, find WisdomAI, and disconnect or remove it.
  1. In ChatGPT, select Plugins in the sidebar.
  2. Search for WisdomAI and open it.
  3. Click Install plugin. You’ll be redirected to a sign-in page.
  4. Enter your work email and click Continue. You’ll be signed in to your organization’s WisdomAI workspace, where you can approve the requested access.
In ChatGPT, mention the plugin to use it:
Go to Plugins, open WisdomAI, select the ··· menu, then click Uninstall.
Any MCP-compatible client works. Use these details to add WisdomAI to your client:How you enter them depends on the client. Some provide a form, and others use a JSON configuration file. Check your client’s documentation for where its MCP configuration lives.

​
Clients that support remote MCP servers

Most take a JSON configuration file in this shape:
VS Code uses different keys for the same connection. In .vscode/mcp.json, add the following configuration:
Claude Code is configured from the command line. Run:
Then, in Claude Code, run:
Select wisdomai and follow the sign-in flow.

​
Clients without remote MCP support

Connect through the mcp-remote proxy, which bridges the remote server to a local connection:
Once you’ve added the connection, restart the client and complete authentication when prompted. The exact flow varies by client.
Delete the wisdomai entry from your client’s configuration and restart it.In Claude Code, run claude mcp remove wisdomai.

​
Step 3: Authenticate

Choose a sign-in method supported by your AI tool and your organization:
  • Sign in with WisdomAI (OAuth). For interactive connections, follow your tool’s sign-in prompts and approve access. Use a sign-in method allowed by your organization. Most clients handle setup automatically; some require an administrator to register the connection first.
  • API key. For scripts or tools that accept an API key, create one in WisdomAI’s API Keys settings and add it to your tool’s connection settings. Use your own WisdomAI MCP URL.
  • Your organization’s identity provider. If your administrator has enabled this option, your integration can use an access token from your organization’s identity provider. Use your own WisdomAI MCP URL and ask your administrator for the setup details.
For tools that require an HTTP header, send the API key or access token as:
After authentication succeeds, confirm that your client can reach WisdomAI.

​
Step 4: Confirm the connection

Start here to confirm the connection and see the data available to you:
  • What domains are available in WisdomAI?
If WisdomAI returns the domains available to your account, the connection is ready to use.

​
Security and privacy

Access works exactly as it does in the WisdomAI app. A connected client acts as the signed-in user, so their role, domain access, row-level security, and column-level security all apply unchanged. Queries made through MCP appear in your audit trail alongside activity from the app.

​
Example prompts

Once the connection is working, try prompts like these:

​
Ask a question

  • How did Q3 net revenue track against plan in EMEA?
  • Break that down by segment and show the last four quarters.
  • Show me the top 5 products by sales this quarter as a table.
  • Visualize monthly active users over the last 12 months.
  • Pull last quarter’s revenue by region and draft a summary for the board deck.

​
Check where an answer came from

  • Which definition of net revenue was used, and what data did it come from?
  • Show me the query behind that answer.

​
Manage domain context

  • What metrics are defined in the Finance domain?
  • Add business knowledge to the Sales domain: bookings exclude intercompany transfers.
  • Save that question and query as a reviewed query in the Sales domain.

​
Capabilities

What’s available to you depends on your WisdomAI role. Everyone with domain access can:
  • Find the domains and tables they can query.
  • Ask questions in natural language and get complete responses, including text, tables, and charts.
  • Refine an answer with follow-ups, keeping the context of the conversation.
  • See the query behind an answer and the definitions it used.
  • Give feedback on an answer, or seek help from the domain admin.
With the role to edit and manage context, you can also:
  • Read and edit metric definitions, business knowledge, synonyms, table relationships, derived columns, and parameterized tables.
  • Read and edit reviewed queries and row-level security settings.
  • Reindex a domain after changes.
Context edits go into a draft and take effect after you publish it.

​
Not available via MCP

The MCP server doesn’t currently expose everything you can do in the WisdomAI app. Use the app for these common tasks:
  • Creating or editing live apps
  • Building and running agents
  • Uploading files

​
Next steps

Ask a question

Learn how questions move from your AI client to a WisdomAI answer.

Give feedback

Rate an answer or ask a domain admin for help.

Manage context

Read and edit the definitions that shape WisdomAI answers.
For support, feedback, or feature requests, contact our team at support@askwisdom.ai.