Integração do Servidor Salesforce MCP

O que faz o Servidor “Salesforce” MCP?

O Servidor Salesforce MCP é uma implementação do Model Context Protocol (MCP) que conecta assistentes de IA, como Claude, ao Salesforce. Ele permite interações em linguagem natural com dados e metadados do Salesforce, possibilitando ao usuário consultar, modificar e gerenciar objetos e registros do Salesforce de forma fluida. Ao expor as poderosas APIs do Salesforce por meio de ferramentas padrão MCP, o servidor capacita clientes de IA a realizar consultas em banco de dados, gerenciar objetos, lidar com código Apex e automatizar fluxos de trabalho diretamente de ambientes de desenvolvimento. Desenvolvedores se beneficiam com acesso simplificado aos recursos do Salesforce, maior produtividade e a possibilidade de construir integrações e automações robustas orientadas por IA em diversas plataformas.

Lista de Prompts

Nenhum template de prompt explícito está listado no repositório.

Lista de Recursos

Nenhum recurso MCP explícito está listado no repositório.

Lista de Ferramentas

• salesforce_search_objects
  Pesquise objetos padrão e personalizados no Salesforce usando correspondência parcial de nomes.
• salesforce_describe_object
  Recupere informações detalhadas de esquema, incluindo campos, relacionamentos e picklists de um objeto.
• salesforce_query_records
  Consulte registros com suporte a relacionamentos e condições complexas.
• salesforce_aggregate_query
  Execute consultas agregadas com GROUP BY, HAVING e várias funções de agregação.
• salesforce_dml_records
  Insira, atualize, exclua ou faça upsert de registros do Salesforce.
• salesforce_manage_object
  Crie e modifique objetos personalizados e ajuste suas propriedades.
• salesforce_manage_field
  Adicione ou modifique campos personalizados, incluindo campos de relacionamento e permissões de acesso.
• salesforce_manage_field_permissions
  Conceda, revogue ou leia permissões de segurança em nível de campo para perfis específicos.
• salesforce_search_all
  Pesquise em múltiplos objetos do Salesforce usando consultas SOSL.
• salesforce_read_apex
  Leia classes Apex, liste por padrão e recupere seu código fonte e metadados.
• salesforce_write_apex
  Crie ou atualize classes Apex, especificando código e versões de API.
• salesforce_read_apex_trigger
  Leia triggers Apex, liste triggers e recupere seus metadados/código fonte.
• salesforce_write_apex_trigger
  Crie ou atualize triggers Apex para objetos específicos, especificando eventos e versões de API.
• salesforce_execute_anonymous
  Execute código Apex anônimo e visualize logs de depuração e resultados.

Casos de Uso deste Servidor MCP

• Gestão de Banco de Dados Salesforce
  Realize operações CRUD em registros do Salesforce, simplifique manipulação de dados e automatize tarefas repetitivas via instruções orientadas por IA.
• Exploração de Esquema e Metadados
  Recupere rapidamente esquemas de objetos, detalhes de campos e relacionamentos para ajudar na construção de integrações ou entender estruturas organizacionais complexas.
• Relatórios Avançados e Agregação
  Execute consultas agregadas para gerar resumos, realizar análises e filtrar resultados agrupados, apoiando necessidades de inteligência de negócios.
• Gestão de Código e Triggers Apex
  Leia, crie e atualize classes ou triggers Apex diretamente do seu ambiente de desenvolvimento, acelerando ciclos de implantação e manutenção.
• Pesquisa Entre Objetos e Descoberta de Dados
  Use busca baseada em SOSL para encontrar informações em múltiplos objetos, facilitando a localização de registros e relacionamentos em grandes orgs Salesforce.

Como configurar

Windsurf

1. Certifique-se de que o Node.js esteja instalado no seu sistema.
2. Instale o Servidor Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Localize seu arquivo de configuração do Windsurf (por exemplo, windsurf.config.json).
4. Adicione o Servidor Salesforce MCP usando o seguinte trecho JSON:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "seu-client-id",
           "SALESFORCE_CLIENT_SECRET": "seu-client-secret",
           "SALESFORCE_USERNAME": "seu-username",
           "SALESFORCE_PASSWORD": "sua-password",
           "SALESFORCE_TOKEN": "seu-security-token"
         }
       }
     }
   }
   

5. Salve o arquivo e reinicie o Windsurf.
6. Verifique se o servidor está rodando no painel MCP.

Claude

1. Certifique-se de que o Node.js esteja instalado.
2. Instale o Servidor Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Edite seu arquivo de configuração de integração do Claude.
4. Adicione o seguinte na seção mcpServers:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "seu-client-id",
           "SALESFORCE_CLIENT_SECRET": "seu-client-secret",
           "SALESFORCE_USERNAME": "seu-username",
           "SALESFORCE_PASSWORD": "sua-password",
           "SALESFORCE_TOKEN": "seu-security-token"
         }
       }
     }
   }
   

5. Salve e reinicie o Claude.
6. Confirme a disponibilidade do Salesforce MCP em seu ambiente Claude.

Cursor

1. Instale o Node.js.
2. Instale o Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Abra o arquivo de configuração do Cursor.
4. Adicione o Servidor Salesforce MCP conforme mostrado:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "seu-client-id",
           "SALESFORCE_CLIENT_SECRET": "seu-client-secret",
           "SALESFORCE_USERNAME": "seu-username",
           "SALESFORCE_PASSWORD": "sua-password",
           "SALESFORCE_TOKEN": "seu-security-token"
         }
       }
     }
   }
   

5. Salve as alterações e reinicie o Cursor.
6. Teste a conectividade do servidor no painel de integrações MCP.

Cline

1. Certifique-se de que o Node.js esteja instalado.
2. Instale o pacote:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Localize e abra o arquivo de configuração do Cline.
4. Insira o Servidor Salesforce MCP:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "seu-client-id",
           "SALESFORCE_CLIENT_SECRET": "seu-client-secret",
           "SALESFORCE_USERNAME": "seu-username",
           "SALESFORCE_PASSWORD": "sua-password",
           "SALESFORCE_TOKEN": "seu-security-token"
         }
       }
     }
   }
   

5. Salve e reinicie o Cline.
6. Verifique o status do servidor MCP no menu de ferramentas.

Protegendo API Keys:
Sempre utilize variáveis de ambiente para credenciais sensíveis. Na sua configuração, adicione os campos necessários ao objeto env como mostrado acima.
Para passar entradas adicionais, você pode usar:

{
  "mcpServers": {
    "salesforce-mcp": {
      "command": "mcp-server-salesforce",
      "args": [],
      "env": {
        "SALESFORCE_CLIENT_ID": "seu-client-id"
      },
      "inputs": {
        "instanceUrl": "https://sua-instancia.salesforce.com"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "salesforce-mcp": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparamcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de alterar “salesforce-mcp” para o nome real do seu servidor MCP e substituir a URL pela URL do seu servidor MCP.

Visão Geral

Entre estas duas tabelas, o Servidor Salesforce MCP oferece excelente documentação de ferramentas e configuração, mas carece de documentação sobre templates de prompt, recursos, raízes ou amostragem. Sua principal força está no conjunto robusto de ferramentas para Salesforce e instruções de configuração claras. Com base nisso, eu avaliaria o repositório em 7/10 para integração MCP prática e usabilidade para desenvolvedores.

Pontuação MCP