MCP Salesforce Connector

MCP Salesforce Connector

Una implementación de servidor de Model Context Protocol (MCP) para la integración con Salesforce, que permite a los LLMs interactuar con datos de Salesforce mediante consultas SOQL y búsquedas SOSL.

Características

• Ejecutar consultas SOQL (Salesforce Object Query Language)
• Realizar búsquedas SOSL (Salesforce Object Search Language)
• Recuperar metadatos de objetos de Salesforce, incluidos nombres de campos, etiquetas y tipos
• Listar todos los SObjects disponibles: descubrir objetos estándar y personalizados
• Recuperar, crear, actualizar y eliminar registros
• Ejecutar solicitudes de Tooling API
• Ejecutar solicitudes Apex REST
• Realizar llamadas REST API directas a Salesforce

Configuración

Model Context Protocol

Para usar este servidor con el Model Context Protocol, debe configurarlo en su archivo claude_desktop_config.json. Agregue la siguiente entrada a la sección 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"
            }
        }
    }
}

Herramientas Disponibles

Herramientas de Consulta y Búsqueda

• run_soql_query - Ejecutar consultas SOQL contra Salesforce
• run_sosl_search - Realizar búsquedas SOSL entre objetos

Herramientas de Metadatos

• get_object_fields - Recuperar metadatos de campos para objetos específicos
• list_sobjects - Listar todos los SObjects disponibles (estándar y personalizados)

Operaciones de Registro Individual

• get_record - Recuperar un registro específico por ID
• create_record - Crear un nuevo registro
• update_record - Actualizar un registro existente
• delete_record - Eliminar un registro

Operaciones Masivas

• bulk_create_records - Crear múltiples registros en una sola operación
• bulk_update_records - Actualizar múltiples registros (debe incluir el campo Id)
• bulk_delete_records - Eliminar múltiples registros usando IDs de registro

Herramientas API Avanzadas

• tooling_execute - Ejecutar solicitudes de Tooling API
• apex_execute - Ejecutar solicitudes Apex REST
• restful - Realizar llamadas REST API directas a Salesforce

Nota sobre los Métodos de Autenticación de Salesforce

Este servidor admite cuatro métodos de autenticación:

• OAuth (Recomendado): Establezca SALESFORCE_ACCESS_TOKEN y SALESFORCE_INSTANCE_URL como variables de entorno.
• Credenciales de Cliente: Establezca SALESFORCE_CLIENT_ID y SALESFORCE_CLIENT_SECRET para el flujo de Credenciales de Cliente OAuth 2.0. Esto es útil para integraciones de servidor a servidor.
• Salesforce CLI (Organización Predeterminada): Si no se establecen variables de entorno OAuth, el servidor intentará usar la organización predeterminada activa de Salesforce CLI del espacio de trabajo actual (mediante sf org display --json o sfdx force:org:display --json). Opcionalmente, establezca SALESFORCE_CLI_TARGET_ORG para apuntar a una organización específica.
• Nombre de Usuario/Contraseña (Legado): Si SALESFORCE_ACCESS_TOKEN y SALESFORCE_INSTANCE_URL no están establecidos, el servidor recurrirá a usar SALESFORCE_USERNAME, SALESFORCE_PASSWORD y SALESFORCE_SECURITY_TOKEN.

Configuración del Entorno

• SALESFORCE_DOMAIN (Opcional): Establézcalo en test para conectarse a un entorno sandbox de Salesforce. Si no se establece o se deja vacío, el servidor se conectará al entorno de producción.
• SALESFORCE_CLI_TARGET_ORG (Opcional): Al usar el método de autenticación de Salesforce CLI, establézcalo para apuntar a un alias de organización o nombre de usuario específico en lugar de la organización predeterminada.