Consideraciones sobre MCP para Agentforce

Servidores y registros de MCP

• MCP para Agentforce admite servidores que utilizan el protocolo de transporte HTTP. HTTP+SSE y otros protocolos no son compatibles.
• MCP para Agentforce solo admite autenticación y credenciales de cliente de OAuth 2.0. No se admiten otros flujos de OAuth, incluyendo código de autorización, CIMD, DCR, soporte JWT y PKCE. Algunos patrones de autenticación avanzados están disponibles con configuración adicional, incluyendo credenciales de cliente de OAuth 2.1.
• No se admite la autenticación a nivel de usuario. Actualmente no admitimos casos de uso que requieren Id. de usuario individuales o respuestas personalizadas. Por ejemplo, no puede utilizar MCP para Agentforce para dar un reembolso a un usuario individual, pero puede utilizarlo para obtener todas las facturas de sus clientes.
• MCP para Agentforce solo admite herramientas de servidor. No se admiten aplicaciones, solicitudes y recursos de servidor MCP.
• Los nombres de herramientas pueden tener hasta 128 caracteres y admitir los siguientes caracteres: ^a-zA-Z0-9./-{1.128}$
• Cuando un servidor MCP no está sincronizado o no está disponible, la vista de lista Registros y la página de registro del servidor muestran actualmente el servidor como conectado. Hay una solución en camino.
• Los cambios realizados en el registro de un servidor o el servidor en sí pueden interrumpir las acciones de la herramienta MCP asociada en un agente. Antes de realizar cualquier cambio, incluyendo la eliminación del registro, elimine cualquier acción asociada de su agente, elimine las acciones de agente asociadas de la biblioteca de activos y luego elimine su registro de servidor. Luego puede volver a registrar su servidor y agregar las nuevas acciones de la herramienta MCP a su agente.

Empaquetado e implementación

Para garantizar la seguridad, Salesforce admite el empaquetado o la implementación de agentes que contienen acciones de herramientas de MCP, pero los metadatos de registro del servidor de MCP no están empaquetados. Cualquier acción de la herramienta MCP agregada al agente no funciona de inmediato.

Antes de implementar un paquete, en el nuevo entorno, registre los servidores MCP y agregue a la lista de admisión las herramientas que utiliza el agente. Luego, después de implementar, elimine cualquier acción de herramienta MCP existente del agente y sustitúyala por las nuevas acciones de la biblioteca de activos.

Los metadatos de agentes se pueden empaquetar para agentes borrador o confirmados. Si el agente está en estado borrador en su nuevo entorno, puede modificarlo. Si el agente está en un estado confirmado, cree un nuevo borrador para realizar los cambios.

Asistencia de Agentforce Platform y Builder

• Las acciones de agentes que hacen referencia a acciones del servidor MCP (acciones de la herramienta MCP) se facturan al mismo ritmo que otras acciones de agentes. La creación de reportes sobre el uso está disponible en Digital Wallet. Consulte Uso y facturación de IA agenteforce y generativa.
• La compatibilidad de Agentforce Builder es más sólida para valores primitivos y acceso a campos superficiales, de modo que seleccione herramientas de servidor MCP con respuestas JSON estructuradas sencillas o ajuste sus respuestas, donde sea posible. Se admiten objetos de nivel superior, propiedades de objetos de nivel superior y matrices de objetos de nivel superior. Las formas más complejas no son compatibles actualmente de extremo a extremo, incluyendo propiedades anidadas, matrices de objetos y cargas de objetos dinámicas. Más información.
• Agentforce Builder utiliza tipos Lightning para representar entradas y salidas de acciones. No todos los esquemas de entrada y salida de la herramienta MCP se asignan a tipos Lightning. Cuando los datos de una acción de herramienta MCP no se pueden resolver en un tipo Lightning, aún puede utilizar la acción con su agente, pero la entrada o la salida no se pueden almacenar en una variable. Más información.
• Cuando agrega una acción de herramienta MCP a su agente:
  • Las etiquetas de entrada y salida para algunos tipos de datos (por ejemplo, números) pueden sustituirse por la etiqueta “cadena”. Esto no afecta a la lógica o el razonamiento de su agente, pero para facilitar su uso, recomendamos sustituir las etiquetas por los valores originales de la acción de herramienta MCP en la biblioteca de activos o el esquema de entrada o salida de la herramienta MCP. Hay una solución en camino.
  • El campo Tipo de acción de referencia aparece vacío. La acción puede ejecutarse sin un tipo de acción de referencia, aunque esté identificada como un campo obligatorio, porque la acción de referencia está rellena. Si hace clic en o cambia el campo Tipo de acción de referencia, la acción de referencia se restablece y no se puede restablecer manualmente en la herramienta MCP. En este caso, elimine la acción de su agente y vuelva a agregarla desde la biblioteca de activos. Hay una solución en camino.
  • Para herramientas y servidores MCP, las propiedades deben ser inferiores o iguales a 255 caracteres. Una propiedad que supera los 255 caracteres no es compatible actualmente.
• Las respuestas del servidor MCP están sujetas a estos plazos de tiempo de espera. Ajuste las respuestas para ajustarse a estos límites, donde sea posible.
  • El límite de tiempo de espera del cliente MCP es de 60 segundos. Por ejemplo, cuando un servidor no está disponible o tarda más de 60 segundos en responder.
  • El tiempo de espera del motor de razonamiento Atlas es de 120 segundos. Por ejemplo, cuando se llaman múltiples servidores y tardan colectivamente más de 120 segundos en responder.