Solución de problemas de 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. ¿Ha cambiado 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 ser el resultado de credenciales incorrectas o caducadas u otros cambios del 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 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 cambiada, 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 Fuera de sincronización 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 en 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 por determinar si una latencia alta se debe a operaciones relacionadas con MCP. Utilice las 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 está limitada.)

Resuelva cualquier problema, pruebe e implemente sus soluciones y continúe supervisando si hay 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.
• Póngase en 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 conversaciones 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 conversación o prueba de flujo de trabajo. Céntrese en operaciones relacionadas con MCP.
• Utilice registros de eventos mejorados para proporcionar detalles granulares sobre conversaciones de agentes.
• Utilice Agent Analytics para supervisar el rendimiento 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 Supervisión de estado de agentes, establezca umbrales de alerta para desencadenar notificaciones cuando el rendimiento de agentes supera los niveles de umbral.
• Para servidores MCP alojados en Salesforce, diagnostique y solucione problemas utilizando las herramientas administrativas que acompañan al servidor MCP.