---
schema_version: "1"
id: cf9ef74f8450bc93782ffddc40ac6e9c72a3cb8488959f9fdbd9c011dde95917
title: Enable CRM Analytics MCP Server (Beta)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/analytics/264-0-0/bi_mcp_enable.md
canonical_url: https://help.salesforce.com/s/articleView?id=analytics.bi_mcp_enable.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 96cf0231c6531a6b9e3ff4a4774c919daff9450e6bf12a022a91c2cb323e0cf1
description: Create an external client app (ECA), enable CRM Analytics MCP server in Setup, and connect your MCP client to query CRM Analytics data through AI assistants.
products:
  - CRM Analytics
  - Cross Cloud
release: "264"
---
# Enable CRM Analytics MCP Server (Beta)

Create an external client app (ECA), enable CRM Analytics MCP server in Setup, and connect your MCP client to query CRM Analytics data through AI assistants.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in Lightning Experience.</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available with CRM Analytics, which is available for an extra cost in <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions.</td></tr></tbody></table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/images/icon_note.png)

Note CRM Analytics MCP server is a pilot or beta service that is subject to the Beta Services Terms at [Agreements - Salesforce.com](https://www.salesforce.com/company/legal/agreements/) or a written Unified Pilot Agreement if executed by Customer, and applicable terms in the [Product Terms Directory](https://ptd.salesforce.com/). Use of this pilot or beta service is at the Customer's sole discretion.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d24323e78">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d24323e78 ">To create an ECA and enable the server:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d24323e78 ">System Administrator</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d24323e78 ">To view analytics assets and query data:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d24323e78 ">Use CRM Analytics</td>

          </tr>
        </tbody>
      </table>

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/images/icon_important.png)

Important CRM Analytics MCP server is available in production, sandbox, and scratch orgs.

Before you start, make sure that you have a supported MCP client: Claude (Desktop, Web, or Code), Cursor, ChatGPT (developer mode), Agentforce Vibes 2.0, or another client. Your client must support OAuth 2.0 Authorization Code with Proof Key for Code Exchange (PKCE).

MCP servers are off by default. Complete the [steps to get started with Salesforce hosted MCPs](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide#getting-started).

To connect your AI assistant to CRM Analytics, create an ECA and turn on the server in Salesforce. Then log in to the target org and complete OAuth in your MCP client.

1. Create an ECA that uses OAuth 2.0 Authorization Code with PKCE.
    
    CRM Analytics MCP server authenticates using the ECA. See [Create an External Client App](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/create-external-client-app.html#steps-to-create-an-external-client-app), and use the callback URL for your MCP client. Examples include `https://claude.ai/api/mcp/auth_callback` for Claude and `cursor://anysphere.cursor-mcp/oauth/callback` for Cursor.
2. From Setup, in the Quick Find box, enter MCP Servers, and then select **MCP Servers** under API Catalog.
3. Turn on **CRM Analytics MCP Server**.
4. Sign out of all other Salesforce orgs. In your default browser, log in to the org with your ECA, and leave the browser open.
    
    Your MCP client opens a new tab during authentication. Signing in to the correct org first helps prevent the multitenant conflicts that cause most connection failures.
5. Add CRM Analytics MCP server to your MCP client by using the server URL for your org type, and complete the OAuth flow when the client opens a browser tab.
    
    - Production: `https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta`
    - Sandbox or scratch org: `https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta`
    
    Each user authenticates individually. CRM Analytics MCP server doesn't support service account patterns. For client-specific connection instructions, see [Configure Your MCP Client](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/client-connection-overview.html).

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/images/icon_example.png)

Example

Confirm the connection by asking a discovery prompt in your AI client.

**Sample prompt:** What analytics apps do I have access to?

**Expected result:** The AI client returns the folders (apps) that you can access by using `list_folders`.

For more first-session prompts, see [CRM Analytics MCP server Troubleshooting and Tips](https://help.salesforce.com/s/articleView?id=analytics.bi_mcp_tips.htm&release=264.0.0&type=5 "Resolve connection and permission issues, and use prompts and practices that help AI clients query CRM Analytics data more accurately."). If the client can't connect or no tools appear, see the same topic.