Servidor MCP de Salesforce

Una implementación de servidor MCP (Protocolo de Contexto de Modelo) que integra Claude con Salesforce, lo que permite interacciones en lenguaje natural con sus datos y metadatos de Salesforce. Este servidor permite a Claude consultar, modificar y gestionar sus objetos y registros de Salesforce con lenguaje cotidiano.

Características

Gestión de objetos y campos : cree y modifique objetos y campos personalizados utilizando lenguaje natural
Búsqueda de objetos inteligentes : busque objetos de Salesforce mediante coincidencias de nombres parciales
Información detallada del esquema : obtenga detalles completos de campos y relaciones para cualquier objeto
Consultas de datos flexibles : consulte registros con soporte de relaciones y filtros complejos
Manipulación de datos : inserte, actualice, elimine y actualice registros con facilidad
Búsqueda entre objetos : busque entre varios objetos mediante SOSL
Administración de código Apex : lea, cree y actualice clases y activadores de Apex
Manejo intuitivo de errores : comentarios claros con detalles de errores específicos de Salesforce

Instalación

npm install -g @tsmztech/mcp-server-salesforce

Herramientas

objetos de búsqueda de salesforce

Búsqueda de objetos estándar y personalizados:

Búsqueda por coincidencias parciales de nombre
Encuentra objetos estándar y personalizados
Ejemplo: "Buscar objetos relacionados con Cuenta" encontrará Cuenta, Historial de cuenta, etc.

objeto de descripción de salesforce

Obtenga información detallada del esquema del objeto:

Definiciones y propiedades de los campos
Detalles de la relación
Valores de la lista de selección
Ejemplo: "Muéstrame todos los campos del objeto Cuenta"

registros de consulta de salesforce

Consultar registros con soporte de relaciones:

Relaciones entre padres e hijos
Relaciones entre padres e hijos
Condiciones WHERE complejas
Ejemplo: "Obtener todas las cuentas con sus contactos relacionados"

registros dml de salesforce

Realizar operaciones de datos:

Insertar nuevos registros
Actualizar registros existentes
Eliminar registros
Inserción mediante identificaciones externas
Ejemplo: "Actualizar el estado de varias cuentas"

objeto de gestión de salesforce

Crear y modificar objetos personalizados:

Crear nuevos objetos personalizados
Actualizar las propiedades del objeto
Configurar los ajustes de uso compartido
Ejemplo: "Crear un objeto de comentarios del cliente"

campo de gestión de salesforce

Administrar campos de objeto:

Agregar nuevos campos personalizados
Modificar propiedades de campo
Crear relaciones
Ejemplo: "Agregar un campo de lista de selección de calificación a la cuenta"

búsqueda_todo_en_salesforce

Buscar en múltiples objetos:

Búsqueda basada en SOSL
Compatibilidad con múltiples objetos
Fragmentos de campo
Ejemplo: "Buscar 'nube' en Cuentas y Oportunidades"

Salesforce_read_apex

Leer clases de Apex:

Obtenga el código fuente completo de clases específicas
Lista de clases que coinciden con patrones de nombres
Ver metadatos de la clase (versión de API, estado, etc.)
Compatibilidad con comodines (* y ?) en patrones de nombres
Ejemplo: "Muéstrame la clase AccountController" o "Buscar todas las clases que coincidan con Account Cont "

salesforce_write_apex

Crear y actualizar clases de Apex:

Crear nuevas clases de Apex
Actualizar las implementaciones de clases existentes
Especificar versiones de API
Ejemplo: "Crear una nueva clase Apex para gestionar las operaciones de la cuenta"

disparador de apex de lectura de salesforce

Leer los activadores de Apex:

Obtenga el código fuente completo de activadores específicos
Lista de desencadenadores que coinciden con patrones de nombres
Ver metadatos del disparador (versión de API, objeto, estado, etc.)
Compatibilidad con comodines (* y ?) en patrones de nombres
Ejemplo: "Muéstrame el disparador de cuenta" o "Buscar todos los disparadores para el objeto de contacto"

disparador de apex de escritura de salesforce

Crear y actualizar activadores de Apex:

Crear nuevos activadores de Apex para objetos específicos
Actualizar las implementaciones de activadores existentes
Especificar versiones de API y operaciones de eventos
Ejemplo: "Crear un nuevo disparador para el objeto Cuenta" o "Actualizar el disparador Cliente potencial"

ejecución anónima de salesforce

Ejecutar código Apex anónimo:

Ejecute el código Apex sin crear una clase permanente
Ver registros de depuración y resultados de ejecución
Útil para operaciones de datos que no son compatibles directamente con otras herramientas
Ejemplo: "Ejecutar código Apex para calcular las métricas de la cuenta" o "Ejecutar un script para actualizar los registros relacionados".

registros de depuración de salesforce_manage

Administrar registros de depuración para usuarios de Salesforce:

Habilitar registros de depuración para usuarios específicos
Deshabilitar configuraciones de registro de depuración activa
Recuperar y ver registros de depuración
Configurar los niveles de registro (NINGUNO, ERROR, ADVERTENCIA, INFORMACIÓN, DEPURACIÓN, FINO, MÁS FINO, EL MEJOR)
Ejemplo: "Habilitar registros de depuración para usuario@ejemplo.com " o "Recuperar registros recientes de un usuario administrador"

Configuración

Autenticación de Salesforce

Puede conectarse a Salesforce utilizando uno de dos métodos de autenticación:

1. Autenticación de nombre de usuario/contraseña (predeterminada)

Configura tus credenciales de Salesforce
Obtenga su token de seguridad (Restablecer desde la configuración de Salesforce)

2. Flujo de credenciales de cliente OAuth 2.0

Crear una aplicación conectada en Salesforce
Habilite la configuración de OAuth y seleccione "Flujo de credenciales del cliente".
Establezca alcances apropiados (normalmente, "api" es suficiente)
Guardar el ID del cliente y el secreto del cliente
Importante : Tenga en cuenta la URL de su instancia (por ejemplo, https://your-domain.my.salesforce.com ), ya que es necesaria para la autenticación.

Uso con Claude Desktop

Añade a tu claude_desktop_config.json :

Para la autenticación de nombre de usuario/contraseña:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@tsmztech/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_CONNECTION_TYPE": "User_Password",
        "SALESFORCE_USERNAME": "your_username",
        "SALESFORCE_PASSWORD": "your_password",
        "SALESFORCE_TOKEN": "your_security_token",
        "SALESFORCE_INSTANCE_URL": "org_url"        // Optional. Default value: https://login.salesforce.com
      }
    }
  }
}

Para el flujo de credenciales de cliente OAuth 2.0:

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@tsmztech/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_CONNECTION_TYPE": "OAuth_2.0_Client_Credentials",
        "SALESFORCE_CLIENT_ID": "your_client_id",
        "SALESFORCE_CLIENT_SECRET": "your_client_secret",
        "SALESFORCE_INSTANCE_URL": "https://your-domain.my.salesforce.com"  // REQUIRED: Must be your exact Salesforce instance URL
      }
    }
  }
}

Nota : Para el flujo de credenciales de cliente de OAuth 2.0, SALESFORCE_INSTANCE_URL debe ser la URL exacta de su instancia de Salesforce (p. ej., https://your-domain.my.salesforce.com ). El punto final del token se construirá como <instance_url>/services/oauth2/token .

Ejemplo de uso

Buscando objetos

"Find all objects related to Accounts"
"Show me objects that handle customer service"
"What objects are available for order management?"

Obtención de información del esquema

"What fields are available in the Account object?"
"Show me the picklist values for Case Status"
"Describe the relationship fields in Opportunity"

Consulta de registros

"Get all Accounts created this month"
"Show me high-priority Cases with their related Contacts"
"Find all Opportunities over $100k"

Administrar objetos personalizados

"Create a Customer Feedback object"
"Add a Rating field to the Feedback object"
"Update sharing settings for the Service Request object"

Búsqueda entre objetos

"Search for 'cloud' in Accounts and Opportunities"
"Find mentions of 'network issue' in Cases and Knowledge Articles"
"Search for customer name across all relevant objects"

Gestión del código Apex

"Show me all Apex classes with 'Controller' in the name"
"Get the full code for the AccountService class"
"Create a new Apex utility class for handling date operations"
"Update the LeadConverter class to add a new method"

Administración de activadores de Apex

"List all triggers for the Account object"
"Show me the code for the ContactTrigger"
"Create a new trigger for the Opportunity object"
"Update the Case trigger to handle after delete events"

Ejecución de código Apex anónimo

"Execute Apex code to calculate account metrics"
"Run a script to update related records"
"Execute a batch job to process large datasets"

Administrar registros de depuración

"Enable debug logs for user@example.com"
"Retrieve recent logs for an admin user"
"Disable debug logs for a specific user"
"Configure log level to DEBUG for a user"

Desarrollo

Construyendo desde la fuente

# Clone the repository
git clone https://github.com/tsmztech/mcp-server-salesforce.git

# Navigate to directory
cd mcp-server-salesforce

# Install dependencies
npm install

# Build the project
npm run build

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Problemas y soporte

Si encuentra algún problema o necesita ayuda, informe un problema en el repositorio de GitHub .

Integrations