Conector MCP para Salesforce

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la integración con Salesforce, que permite a los LLM 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: descubra objetos estándar y personalizados

• Recuperar, crear, actualizar y eliminar registros

• Ejecutar solicitudes de la Tooling API

• Ejecutar solicitudes de Apex REST

• Realizar llamadas directas a la API REST de Salesforce

Related MCP server: Salesforce MCP Integration

Configuración

Protocolo de Contexto de Modelo

Para utilizar este servidor con el Protocolo de Contexto de Modelo, debe configurarlo en su archivo claude_desktop_config.json. Añada 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 en Salesforce

• run_sosl_search - Realizar búsquedas SOSL en 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 con un solo registro

• 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 de API avanzadas

• tooling_execute - Ejecutar solicitudes de la Tooling API

• apex_execute - Ejecutar solicitudes de Apex REST

• restful - Realizar llamadas directas a la API REST de 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 de OAuth 2.0. Esto es útil para integraciones de servidor a servidor.

• Salesforce CLI (Organización predeterminada): Si no se establecen variables de entorno de OAuth, el servidor intentará utilizar la organización predeterminada de Salesforce CLI activa del espacio de trabajo actual (a través de sf org display --json o sfdx force:org:display --json). Opcionalmente, establezca SALESFORCE_CLI_TARGET_ORG para dirigirse 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á al uso de SALESFORCE_USERNAME, SALESFORCE_PASSWORD y SALESFORCE_SECURITY_TOKEN.

Configuración del entorno

• SALESFORCE_DOMAIN (Opcional): Establezca 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): Cuando utilice el método de autenticación de Salesforce CLI, establezca esto para dirigirse a un alias de organización o nombre de usuario específico en lugar de la organización predeterminada.