Consideraciones sobre MCP para Agentforce

Servidores y registros MCP

• MCP para Agentforce admite servidores que utilizan el protocolo de transporte HTTP. HTTP+SSE y otros protocolos no son compatibles.
• MCP para Agentforce no admite autenticación y credenciales de cliente de OAuth 2.0 únicamente. No se admiten otros flujos de OAuth, incluyendo código de autorización, CIMD, DCR, soporte JWT y PKCE. Algunos patrones de autenticación avanzada 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 admiten 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. Una solución está en camino.
• Los cambios realizados en el registro de un servidor o en el propio servidor 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. A continuación 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 MCP no están empaquetados. Cualquier acción de herramienta MCP agregada al agente no funciona de forma inmediata.

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. A continuación, 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 un 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 de servidor MCP (acciones de herramienta MCP) se facturan al mismo ritmo que otras acciones de agentes. La creación de informes 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. Por lo tanto, 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ámicos. 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. Sin embargo, 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) se pueden sustituir por la etiqueta “string”. Esto no afecta a la lógica o el razonamiento de su agente. Sin embargo, para facilitar el 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. Una solución está 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. Una solución está en camino.
  • Para herramientas y servidores MCP, se requiere que las propiedades sean 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 a múltiples servidores y tardan colectivamente más de 120 segundos en responder.
• En Vista de secuencia de comandos, no cambie el nombre de desarrollador de una acción MCP en un subagente. En este ejemplo de secuencia de comandos de agente, el nombre del desarrollador (UUID) es a4ace7b43ff031459019d3f5c350629a.

     actions:
        a4ace7b43ff031459019d3f5c350629a:
           description:
              Retrieves a list of customer support cases for a given customer Id.
           label: "custom_cases_by_id"
           require_user_confirmation: False
           include_in_progress_indicator: False
           source: "a4ace7b43ff031459019d3f5c350629a"
           target: "mcpTool://mcptoolx5xf5customerxfcasesxfbyxfid"

  Sin embargo, puede cambiar el alias de una acción de MCP y consultar ese alias en las instrucciones. En este ejemplo, get_cases_from_id es el alias de la acción MCP a la que se hace referencia en la sección instructions y que se define en actions.

  Get customer support cases and answer questions
     reason:
        instructions:
           Get customer cases by customer id by calling {{actions.get_cases_from_id}}.
           If customer provides only email, call {{actions.customer_id_from_email}}
           to get the customer id first.
        actions:
           get_cases_from_id: @actions.a4ace7b43ff031459019d3f5c350629a
              with customer_id = ...
           customer_id_from_email: @actions.a365abc?3dabf237b28ce87f636204384
              with email = ...