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

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)

1. Configura tus credenciales de Salesforce

2. Obtenga su token de seguridad (Restablecer desde la configuración de Salesforce)

2. Flujo de credenciales de cliente OAuth 2.0

1. Crear una aplicación conectada en Salesforce

2. Habilite la configuración de OAuth y seleccione "Flujo de credenciales del cliente".

3. Establezca alcances apropiados (normalmente, "api" es suficiente)

4. Guardar el ID del cliente y el secreto del cliente

5. 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:

Para el flujo de credenciales de cliente OAuth 2.0:

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

Obtención de información del esquema

Consulta de registros

Administrar objetos personalizados

Búsqueda entre objetos

Gestión del código Apex

Administración de activadores de Apex

Ejecución de código Apex anónimo

Administrar registros de depuración

Desarrollo

Construyendo desde la fuente

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 .