Você está aqui:
Dicas e solução de problemas do servidor MCP do CRM Analytics
Resolva problemas de conexão e permissão e use avisos e práticas que ajudam os clientes de IA a consultar dados do CRM Analytics com mais precisão.
Edições obrigatórias
| Disponível no Lightning Experience. |
| Disponível com o CRM Analytics, que está disponível por um custo extra nas edições Enterprise, Performance e Unlimited. |
Problemas gerais de conectividade
- A conexão do servidor falha: Confirme se o servidor MCP do CRM Analytics está ativado em Configuração em Servidores MCP. Confirme também que você criou um aplicativo cliente externo com o URL de retorno correto. Em seguida, confirme que você se conectou à organização que contém esse aplicativo antes de iniciar o fluxo do OAuth.
- Nenhuma ferramenta é exibida: Confirme se o cliente MCP usa o URL do servidor correto para o tipo de organização e se cada usuário concluiu o OAuth com suas próprias credenciais do Salesforce. O servidor MCP do CRM Analytics não oferece suporte a tokens de conta de serviço.
- Organização de produção: O servidor MCP do CRM Analytics está disponível em organizações de produção, bem como em organizações de sandbox e teste. Use o URL do servidor que corresponde ao seu tipo de organização:
- Produção:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox ou organização teste:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Produção:
Acesso a dados e ferramentas
Sua sessão de MCP é executada como você. Como a autenticação usa suas credenciais do Salesforce, cada solicitação respeita as regras de segurança em nível de campo (FLS), segurança em nível de objeto (OLS), segurança em nível de linha (RLS) e compartilhamento. O cliente de IA nunca pode ver dados ou ativos que você não pode ver no CRM Analytics.
- Conjuntos de dados, painéis ou lenses ausentes: Se o cliente relatar que um ativo está indisponível ou uma chamada de
list_retornar menos itens do que o esperado, você provavelmente não tem permissão para esse ativo. Confirme se você tem acesso ao aplicativo ou ativo e se seu conjunto de permissões concede acesso ao CRM Analytics. - Limites da API: Chamadas de ferramenta MCP contam para os limites da API do Wave da sua organização. Verifique o uso em Configuração em Uso da API.
Consulte o Guia de solução de problemas para obter mais informações.
Dicas para melhores resultados
- Descreva o objetivo, não a ferramenta: Digamos "Mostre-me oportunidades abertas por estágio" em vez de "chamar list_datasets". O cliente de IA seleciona as ferramentas.
- Aumentar a precisão da consulta com descrições de campo: Adicionar rótulos e descrições de campo aos metadados estendidos (XMD) do conjunto de dados ajuda o cliente de IA a gerar SAQL mais preciso.
- Refinar consultas complexas: Agrupamentos aninhados, junções de vários conjuntos de dados ou funções SAQL avançadas podem exigir avisos de acompanhamento para obter o resultado exato.
Exemplos de avisos
Use esses avisos em uma nova sessão para descobrir ativos, inspecionar esquema e fazer perguntas sobre seus dados.
| Prompt do usuário | Ferramenta chamada | Objetivo |
|---|---|---|
| A quais aplicativos de análise eu tenho acesso? | list_folders |
Retorna as pastas (aplicativos) que contêm seus painéis, conjuntos de dados e lenses. Use os resultados para definir o escopo de pesquisas posteriores. |
| A quais conjuntos de dados do CRM Analytics eu tenho acesso neste momento? | list_datasets |
Recupera nomes, rótulos e IDs do conjunto de dados disponíveis no contexto de segurança. |
| Mostre todos os painéis na minha pasta de Solicitação de vendas. | list_dashboards |
Localiza painéis predefinidos para um aplicativo ou unidade de negócios específico. |
| Lista todas as explorações salvas que tenho permissão para visualizar. | list_lenses |
Coleta um inventário de lenses salvos e os conjuntos de dados aos quais eles fazem referência. |
| Dê-me os metadados completos para o conjunto de dados de Funil executivo. | get_dataset |
Retorna detalhes do conjunto de dados, incluindo o ID da versão atual necessário para consultá-lo. |
| Quais são os campos, dimensões e medidas exatos no conjunto de dados Oportunidade? | get_xmd |
Fornece nomes de API de campo, tipos de dados e rótulos para que o cliente possa criar SAQL sintáticamente correto. |
| Quais eram nossas 10 principais contas por receita no último ano fiscal? | execute_query |
Inspeciona o esquema do conjunto de dados, gera uma consulta SAQL e retorna resultados estruturados. |
| Qual foi o pipeline total por região no último trimestre? | execute_query |
Realiza agrupamento e filtragem usando SAQL. |
| Mostre o desempenho do representante versus a cota neste mês. | execute_query |
Executa uma consulta e retorna metadados de linha e coluna como JSON estruturado. |
Feedback e suporte beta
Esse servidor está disponível como uma versão beta. Seu feedback forma a experiência disponível ao público em geral (GA).
- Compartilhe feedback com sua equipe da conta do Salesforce ou envie-o no grupo Trailblazer Community para este programa.
- Verifique as notas de versão para cada atualização quanto a problemas conhecidos e soluções alternativas.
- Entre em contato com o suporte da Salesforce quanto a problemas técnicos durante a configuração e consulte o servidor MCP do CRM Analytics (beta).
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
