MCP Salesforce Connector

MCP Salesforce Connector

Uma implementação de servidor Model Context Protocol (MCP) para integração com Salesforce, permitindo que LLMs interajam com dados do Salesforce por meio de consultas SOQL e pesquisas SOSL.

Recursos

• Executar consultas SOQL (Salesforce Object Query Language)
• Realizar pesquisas SOSL (Salesforce Object Search Language)
• Recuperar metadados de objetos Salesforce, incluindo nomes de campos, rótulos e tipos
• Listar todos os SObjects disponíveis - Descobrir objetos padrão e personalizados
• Recuperar, criar, atualizar e excluir registros
• Executar solicitações da Tooling API
• Executar solicitações Apex REST
• Fazer chamadas REST API diretas ao Salesforce

Configuração

Model Context Protocol

Para usar este servidor com o Model Context Protocol, você precisa configurá-lo no seu arquivo claude_desktop_config.json. Adicione a seguinte entrada à seção mcpServers:

{
    "mcpServers": {
        "salesforce": {
        "command": "uvx",
        "args": [
            "--from",
            "mcp-salesforce-connector",
            "salesforce"
        ],
        "env": {
            "SALESFORCE_ACCESS_TOKEN": "SALESFORCE_ACCESS_TOKEN",
            "SALESFORCE_INSTANCE_URL": "SALESFORCE_INSTANCE_URL",
            "SALESFORCE_DOMAIN": "SALESFORCE_DOMAIN"
            }
        }
    }
}

Ferramentas Disponíveis

Ferramentas de Consulta e Pesquisa

• run_soql_query - Executar consultas SOQL no Salesforce
• run_sosl_search - Realizar pesquisas SOSL entre objetos

Ferramentas de Metadados

• get_object_fields - Recuperar metadados de campos para objetos específicos
• list_sobjects - Listar todos os SObjects disponíveis (padrão e personalizados)

Operações de Registro Único

• get_record - Recuperar um registro específico por ID
• create_record - Criar um novo registro
• update_record - Atualizar um registro existente
• delete_record - Excluir um registro

Operações em Lote

• bulk_create_records - Criar vários registros em uma única operação
• bulk_update_records - Atualizar vários registros (deve incluir o campo Id)
• bulk_delete_records - Excluir vários registros usando IDs de registro

Ferramentas Avançadas de API

• tooling_execute - Executar solicitações da Tooling API
• apex_execute - Executar solicitações Apex REST
• restful - Fazer chamadas REST API diretas ao Salesforce

Observação sobre os Métodos de Autenticação do Salesforce

Este servidor suporta quatro métodos de autenticação:

• OAuth (Recomendado): Defina SALESFORCE_ACCESS_TOKEN e SALESFORCE_INSTANCE_URL como variáveis de ambiente.
• Credenciais de Cliente: Defina SALESFORCE_CLIENT_ID e SALESFORCE_CLIENT_SECRET para o fluxo de Credenciais de Cliente OAuth 2.0. Isso é útil para integrações servidor a servidor.
• Salesforce CLI (Org Padrão): Se nenhuma variável de ambiente OAuth estiver definida, o servidor tentará usar a org padrão ativa do Salesforce CLI do workspace atual (via sf org display --json ou sfdx force:org:display --json). Opcionalmente, defina SALESFORCE_CLI_TARGET_ORG para direcionar uma org específica.
• Nome de Usuário/Senha (Legado): Se SALESFORCE_ACCESS_TOKEN e SALESFORCE_INSTANCE_URL não estiverem definidos, o servidor usará SALESFORCE_USERNAME, SALESFORCE_PASSWORD e SALESFORCE_SECURITY_TOKEN como fallback.

Configuração de Ambiente

• SALESFORCE_DOMAIN (Opcional): Defina como test para conectar a um ambiente sandbox do Salesforce. Se não for definido ou ficar vazio, o servidor se conectará ao ambiente de produção.
• SALESFORCE_CLI_TARGET_ORG (Opcional): Ao usar o método de autenticação Salesforce CLI, defina isso para direcionar um alias ou nome de usuário de org específico em vez da org padrão.