Usted estĆ” aquĆ:
MCP para Solución de problemas de Agentforce
Resuelva problemas comunes con soluciones Agentforce que se integran con MCP para Agentforce.
Mi agente no puede encontrar un servidor MCP.
Sin respuesta de un servidor MCP registrado en Salesforce.
- Compruebe la conexión de red.
- Verifique que el servidor MCP estĆ” funcionando correctamente.
- Compruebe la configuración de registro de su servidor MCP. ¿Cambió algo en el lado del servidor, como su URL? ¿Sigue disponible la herramienta en el servidor MCP? Actualice la configuración de registro según sea necesario. Consulte Modificar detalles del servidor MCP.
- Para servidores MCP alojados en Salesforce, consulte también Fallos de conexión del servidor.
Resuelva cualquier problema e intente conectar con el servidor de nuevo.
Mi agente no puede acceder a una herramienta de servidor MCP (error de autenticación).
Los errores de autenticación pueden deberse a credenciales incorrectas o caducadas u otros cambios en el lado del servidor. MCP para Agentforce admite estos tipos:
- sin autenticación
- Credencial de cliente de OAuth 2.0
Compruebe su configuración de autenticación para el servidor MCP registrado en Salesforce. ĀæNecesita renovar sus credenciales? ĀæHa cambiado algo mĆ”s en el lado del servidor? Por ejemplo, Āærequiere ahora el servidor credenciales de autenticación cuando antes no lo hacĆa? Actualice su configuración de autenticación en consecuencia. Consulte Modificar detalles del servidor MCP.
Para servidores MCP alojados en Salesforce, consulte también Problemas de autenticación.
Mi agente estÔ recibiendo un error de no sincronización.
Los cambios del lado del servidor en servidores MCP registrados en Salesforce pueden provocar que su configuración de registro y lista de admisión actual no esté sincronizada. Por ejemplo, las actualizaciones en una herramienta de servidor (como una descripción modificada, diferencias en el esquema de entrada o salida o incluso la eliminación de la herramienta) pueden afectar negativamente a agentes que dependen de esa herramienta.
MCP para Agentforce identifica dichos problemas, marca un servidor de MCP registrado o una herramienta de servidor como Desincronizado y notifica a un administrador. Consulte Resolver problemas de servidor MCP no sincronizados.
Mi agente estĆ” recibiendo un error de tiempo de espera de MCP.
Los errores de tiempo de espera relacionados con MCP se producen cuando:
- una herramienta de servidor MCP registrada por Salesforce no estƔ disponible o tarda mƔs de 60 segundos en responder
- se llaman múltiples servidores y tardan colectivamente mÔs de 120 segundos en responder (tiempo de espera del motor de razonamiento Atlas)
Comience determinando si una latencia alta se debe a operaciones relacionadas con MCP. Utilice herramientas de depuración descritas en "Recursos de solución de problemas" (como Planificar rastreador en Agent Builder y registros de rastreo) para aislar dónde se producen los tiempos de espera en su solución Agentforce.
Si confirmó que las operaciones de MCP estÔn causando errores de tiempo de espera:
- Compruebe la conexión de red.
- Verifique que el servidor MCP estĆ” funcionando correctamente.
- Para servidores MCP alojados en Salesforce, utilice herramientas administrativas para solucionar problemas de retrasos causados por operaciones relacionadas con MCP. (La visibilidad en servidores MCP externos es limitada.)
Resuelva cualquier problema, pruebe e implemente sus soluciones y continĆŗe monitoreando los tiempos de espera.
Mi agente estĆ” teniendo otros problemas relacionados con MCP.
- Asegúrese de que su solución Agentforce cumple con los Requisitos para MCP para Agentforce.
- Revise Consideraciones sobre MCP para Agentforce para determinar si se requieren cambios aplicables para su solución Agentforce.
- Haga contacto con el Servicio de asistencia de Salesforce a través de los canales de asistencia de su organización.
Solución de problemas de recursos
Agentforce proporciona herramientas y funciones que le ayudan a identificar patrones, investigar causas raĆz y realizar acciones correctivas.
- En Agent Builder, utilice el Rastreador de planes en el Panel de vista previa de plƔtica para aislar errores de trƔfico de red entre el cliente y el servidor MCP. Inspeccione las decisiones detalladas paso a paso y las acciones que realiza su agente durante una plƔtica o prueba de flujo de trabajo. CƩntrese en operaciones relacionadas con MCP.
- Utilice registros de eventos mejorados para proporcionar detalles granulares sobre plƔticas de agentes.
- Utilice Agent Analytics para monitorear el desempeƱo de los agentes y detectar tendencias de error. Investigue patrones y causas raĆz a nivel de sesión (consulte Analizar datos con optimización de agentes).
- En Monitoreo de estado de agentes, establezca umbrales de alerta para desencadenar notificaciones cuando el desempeƱo de agentes incumple niveles de umbral.
- Para servidores MCP alojados en Salesforce, diagnostique y solucione problemas utilizando las herramientas administrativas que acompaƱan al servidor MCP.
