Como construir um servidor MCP para integrar o Salesforce

Você sabia que o Amplify Fusion pode ajudar você a criar um servidor MCP (Model Context Protocol) para integrar um agente de IA à sua arquitetura?

Usando os conectores do Fusion, os usuários podem conectar um CRM, como o Salesforce, a um assistente de IA, permitindo que façam perguntas e recebam respostas sobre os dados do CRM usando linguagem natural.

Neste exemplo, construiremos um servidor MCP no Amplify Fusion que permite ao usuário fazer perguntas a um assistente de IA, que responderá usando dados de uma instância do Salesforce. Especificamente, acessaremos os apps de Contatos e Pedidos dentro do Salesforce.

Criando um servidor MCP

No Amplify Fusion:

1. Crie um novo Projeto.
   
2. Dê um Nome e uma Descrição ao Projeto.
   
3. Clique em Criar.

Configurar o servidor MCP

1. Dê um Nome ao servidor MCP.
   
2. Forneça uma descrição detalhada sobre o propósito do servidor MCP.
   
3. Clique em Criar.

A descrição é crucial, pois define para o assistente de IA quais dados externos ou ferramentas ele pode acessar por meio do servidor MCP. Isso permite que a IA vá além de seu conhecimento base e ofereça respostas contextualizadas.

Exemplo de descrição usada:

Este gateway permite que agentes de IA acessem e interajam com a plataforma Salesforce por meio de linguagem natural. Ele traduz solicitações da IA em chamadas de API específicas do Salesforce para recuperar dados atualizados do CRM, capacitando o assistente a fornecer respostas precisas, relevantes e a realizar ações no ecossistema Salesforce.

Na página de configuração do servidor MCP:

1. Forneça um Frontend Base Path exclusivo.
   
2. Clique em Salvar.

Criando ferramentas (Tools)

Antes de prosseguir, defina que tipo de perguntas o servidor MCP poderá responder. Neste exemplo:

• “Me mostre o e-mail do [Cliente]”
  
• “Me mostre os pedidos do [Account]”

Tool 1: getEmailAddressFromName

• Descrição: Recupera o e-mail de um contato usando nome e sobrenome.
  
• Input Schema:

{

 “type”: “object”,

 “properties”: {

   “firstName”: { “type”: “string” },

   “lastName”: { “type”: “string” }

 },

 “required”: [“firstName”, “lastName”]

}

Crie a ferramenta com esse schema.

Tool 2: getOrdersByAccountName

• Descrição: Recupera todos os pedidos de uma conta específica.
  
• Input Schema:

{

 “type”: “object”,

 “properties”: {

   “account”: { “type”: “string” }

 },

 “required”: [“account”]

}

Criando integrações

Integração: Get Email Address

1. Clique no ícone de link para a ferramenta getEmailAddressFromName.
   
2. Crie uma nova integração com esse nome.
   
3. Use o conector Salesforce com a operação Query All.
   
4. Crie um plug com acesso de leitura aos Contatos.
   
5. Configure o plug, gere e salve.
   
6. No mapeamento, associe os campos firstName e lastName do MCPServerRequest aos filtros da consulta no Salesforce.
   
7. Adicione um Map Step para definir o tipo de resposta como TextContent.

Integração: Get Orders

1. No servidor MCP, clique no ícone de link para getOrdersByAccountName e crie nova integração.
   
2. Use dois passos de Salesforce:
   
   • O primeiro busca o ID da conta.
     
   • O segundo busca os pedidos dessa conta.
     
3. Crie plugs para ambos os passos e faça os mapeamentos.
   
4. Adicione um Map Step e configure a resposta como TextContent.

Ativar o servidor MCP

1. Clique em Manage Activations no servidor MCP.
   
2. Selecione o data plane e ative o servidor.
   
3. Copie o link gerado. Ele será usado na configuração do assistente de IA.

Configurar o assistente de IA

Exemplo usando o Claude Desktop:

1. Instale o app e vá até Settings > Developer > Edit Config.
   
2. Edite o arquivo claude_desktop_config.json com o seguinte conteúdo:

{

 “preferences”: {

   “quickEntryShortcut”: “off”,

   “menuBarEnabled”: false

 },

 “mcpServers”: {

   “getContactInfo”: {

     “command”: “npx”,

     “args”: [

       “mcp-remote”,

       “[link copiado do servidor MCP]”

     ],

     “env”: {

       “NODE_TLS_REJECT_UNAUTHORIZED”: “0”

     }

   }

 }

}

3. Reinicie o Claude Desktop.

Interagindo com o assistente de IA

Agora você pode fazer perguntas como:

• “Qual o e-mail do João Silva?”
  
• “Me mostre os pedidos da Conta XPTO.”

A IA entende a pergunta, seleciona a ferramenta correta, extrai os dados, chama o Salesforce via API e entrega a resposta — tudo graças à estrutura configurada no servidor MCP do Fusion.

Você também pode expandir o projeto com novas ferramentas, fluxos mais complexos e lógica condicional para consultas multi-step.

Autor
Vincent Belfoure
Arquiteto Sênior de Soluções