Considerações sobre o MCP para Agentforce

Registros e servidores MCP

• O MCP para Agentforce oferece suporte a servidores que usam o protocolo de transporte HTTP transmitível. Não há suporte para HTTP+SSE e outros protocolos.
• O MCP para Agentforce não oferece suporte apenas para autenticação e credenciais de cliente OAuth 2.0. Não há suporte para outros fluxos OAuth, incluindo código de autorização, CIMD, DCR, portador JWT e PKCE. Alguns padrões de autenticação avançados estão disponíveis com configuração adicional, incluindo credenciais de cliente OAuth 2.1.
• Não há suporte para autenticação no nível do usuário. No momento, não oferecemos suporte a casos de uso que exigem IDs de usuário individuais ou respostas personalizadas. Por exemplo, você não pode usar o MCP para Agentforce para dar um reembolso a um usuário individual, mas pode usá-lo para obter todas as faturas de seus clientes.
• O MCP para Agentforce oferece suporte apenas a ferramentas de servidor. Não há suporte para aplicativos, avisos e recursos de servidor MCP.
• Os nomes de ferramentas podem ter até 128 caracteres e oferecer suporte aos seguintes caracteres: ^a-zA-Z0-9./-{1,128}$
• Quando um servidor MCP está fora de sincronia ou indisponível, o modo de exibição de lista Registro e a página de registro do servidor mostram o servidor como conectado. Uma correção está a caminho.
• Alterações feitas em um registro de servidor ou no próprio servidor podem interromper as ações da ferramenta MCP associada em um agente. Antes de fazer qualquer alteração, incluindo excluir o registro, remova todas as ações associadas de seu agente, exclua as ações associadas do agente da biblioteca de ativos e, em seguida, exclua o registro do servidor. Em seguida, você pode registrar novamente seu servidor e adicionar as novas ações da ferramenta MCP ao seu agente.

Empacotamento e implantação

Para garantir a segurança, o Salesforce oferece suporte ao empacotamento ou à implantação de agentes que contêm ações da ferramenta MCP, mas os metadados de registro do servidor MCP não são empacotados. Qualquer ação de ferramenta MCP adicionada ao agente não funciona pronta para uso.

Antes de implementar um pacote, no novo ambiente, registre os servidores MCP e a lista de permissões as ferramentas que o agente usa. Então, depois de implementar, remova todas as ações de ferramenta MCP existentes do agente e substitua-as pelas novas ações da biblioteca de ativos.

Metadados do agente podem ser empacotados para agentes de rascunho ou confirmados. Se o agente estiver em um estado de rascunho em seu novo ambiente, você poderá editá-lo. Se o agente estiver em um estado confirmado, criar um novo rascunho para fazer as alterações.

Suporte da Plataforma e do Criador do Agentforce

• Ações do agente que fazem referência a ações do servidor MCP (ações da ferramenta MCP) são faturadas com a mesma taxa que outras ações do agente. Os relatórios sobre uso estão disponíveis na Digital Wallet. Consulte Uso e cobrança de IA Agentforce e generativa.
• O Suporte do Agentforce Builder é mais forte para valores primitivos e acesso a campos superficiais, portanto, escolha ferramentas de servidor MCP com respostas JSON estruturadas simples ou ajuste suas respostas, quando possível. Há suporte para objetos de nível superior, propriedades de objeto de nível superior e matrizes de objetos de nível superior. No momento, não há suporte para formas mais complexas de ponta a ponta, incluindo propriedades aninhadas, matrizes de objetos e cargas úteis de objetos dinâmicos. Saiba mais.
• O Agentforce Builder usa tipos do Lightning para renderizar entradas e saídas de ação. Nem todos os esquemas de entrada e saída de ferramentas do MCP são mapeados para tipos do Lightning. Quando os dados de uma ação de ferramenta MCP não puderem ser resolvidos para um tipo Lightning, você ainda poderá usar a ação com seu agente, mas a entrada ou a saída não poderão ser armazenadas em uma variável. Saiba mais.
• Quando você adiciona uma ação de ferramenta MCP ao seu agente:
  • Os rótulos de entrada e saída para alguns tipos de dados (por exemplo, números) podem ser substituídos pelo rótulo "string". Isso não afeta a lógica ou o raciocínio do seu agente, mas, para facilitar o uso, recomendamos substituir os rótulos pelos valores originais da ação da ferramenta MCP na biblioteca de ativos ou do esquema de entrada ou saída da ferramenta MCP. Uma correção está a caminho.
  • O campo Tipo de ação de referência aparece vazio. A ação pode ser executada sem um tipo de ação de referência, embora esteja identificada como um campo obrigatório, pois a ação de referência é preenchida. Se você clicar ou alterar o campo Tipo de ação de referência, a ação de referência será redefinida e não poderá ser redefinida manualmente para a ferramenta MCP. Nesse caso, remova a ação de seu agente e adicione-a novamente da biblioteca de ativos. Uma correção está a caminho.
  • Para servidores e ferramentas MCP, as propriedades devem ter menos ou igual a 255 caracteres. Não há suporte atualmente para uma propriedade com mais de 255 caracteres.
• As respostas do servidor MCP estão sujeitas a estas janelas de tempo limite. Ajuste as respostas para se ajustarem a esses limites, quando possível.
  • O limite de tempo limite do cliente MCP é de 60 segundos. Por exemplo, quando um servidor está indisponível ou leva mais de 60 segundos para responder.
  • O tempo limite do mecanismo de raciocínio do Atlas é de 120 segundos. Por exemplo, quando vários servidores são chamados e coletivamente levam mais de 120 segundos para responder.