MCP para solução de problemas do Agentforce

Meu agente não consegue localizar um servidor MCP.

Nenhuma resposta de um servidor MCP registrado pelo Salesforce.

• Verifique a conexão de rede.
• Verifique se o servidor MCP está ativado e em execução corretamente.
• Verifique suas configurações de registro do servidor MCP. Algo mudou no lado do servidor, como seu URL? A ferramenta ainda está disponível no servidor MCP? Atualize as configurações de registro conforme necessário. Consulte Editar detalhes do servidor MCP.
• Para servidores MCP hospedados no Salesforce, consulte também Falhas de conexão do servidor.

Resolva quaisquer problemas e tente se conectar ao servidor novamente.

Meu agente não pode acessar uma ferramenta de servidor MCP (erro de autenticação).

Os erros de autenticação podem resultar de credenciais incorretas ou expiradas ou de outras alterações no lado do servidor. O MCP para Agentforce oferece suporte a estes tipos:

• nenhuma autenticação
• Credencial do cliente do OAuth 2.0

Verifique suas configurações de autenticação para o servidor MCP registrado no Salesforce. Você precisa renovar suas credenciais? Algo mais mudou no lado do servidor? Por exemplo, o servidor agora precisa de credenciais de autenticação quando antes não precisava? Atualize suas configurações de autenticação de acordo. Consulte Editar detalhes do servidor MCP.

Para servidores MCP hospedados no Salesforce, consulte também Problemas de autenticação.

Meu agente está recebendo um erro de fora de sincronia.

Alterações no lado do servidor em servidores MCP registrados pelo Salesforce podem fazer com que suas configurações atuais de registro e lista de permissões fiquem fora de sincronia. Por exemplo, atualizações em uma ferramenta de servidor (como uma descrição alterada, diferenças no esquema de entrada ou saída ou até mesmo a remoção da ferramenta) podem afetar adversamente os agentes que dependem dessa ferramenta.

O MCP para Agentforce identifica esses problemas, sinaliza um servidor MCP ou ferramenta de servidor registrado como fora de sincronia e notifica um administrador. Consulte Solucionar problemas de servidor MCP fora de sincronia.

Meu agente está recebendo um erro de tempo limite de MCP.

Erros de tempo limite relacionados ao MCP ocorrem quando:

• uma ferramenta de servidor MCP registrada no Salesforce está indisponível ou leva mais de 60 segundos para responder
• vários servidores são chamados e a resposta coletiva leva mais de 120 segundos (tempo limite do mecanismo de raciocínio do Atlas)

Comece determinando se a alta latência é devido a operações relacionadas à MCP. Use as ferramentas de depuração descritas em "Resursos de solução de problemas" (como o Planejador de rastreamento no Agent Builder e os logs de rastreamento) para isolar onde os tempos limite ocorrem em sua solução Agentforce.

Se você tiver confirmado que as operações de MCP estão causando erros de tempo limite:

• Verifique a conexão de rede.
• Verifique se o servidor MCP está ativado e em execução corretamente.
• Para servidores MCP hospedados no Salesforce, use ferramentas administrativas para solucionar problemas de atrasos causados por operações relacionadas ao MCP. (A visibilidade de servidores MCP de terceiros é limitada.)

Resolva quaisquer problemas, teste e implemente suas correções e continue monitorando tempo limite.

Meu agente está tendo outros problemas relacionados à MCP.

• Certifique-se de que sua solução Agentforce cumpra os Requisitos para MCP para Agentforce.
• Revise as considerações para MCP para Agentforce para determinar se as alterações aplicáveis são necessárias para sua solução Agentforce.
• Entre em contato com o suporte da Salesforce por meio dos canais de suporte da sua organização.

Recursos de solução de problemas

O Agentforce fornece ferramentas e recursos que ajudam a identificar padrões, investigar causas-raiz e tomar medidas corretivas.

• No Criador de agentes, use o Planejar no Painel de visualização da conversa para isolar erros de tráfego de rede entre o cliente e o servidor MCP. Inspecione as decisões e ações detalhadas e passo a passo que seu agente toma durante uma conversa ou um teste de fluxo de trabalho. Concentre-se em operações relacionadas ao MCP.
• Use logs de evento aprimorados para fornecer detalhes granulares sobre as conversas do agente.
• Use o Agent Analytics para monitorar o desempenho do agente e detectar tendências de erro. Investigar padrões e causas-raiz no nível da sessão (consulte Analisar dados com otimização do agente).
• No Monitoramento de integridade do agente, defina limites de alerta para acionar notificações quando o desempenho do agente exceder os limites.
• Para servidores MCP hospedados no Salesforce, diagnostique e corrija problemas usando as ferramentas administrativas que acompanham o servidor MCP.