Salesforce MCP Integration

Integración de Salesforce MCP

Este proyecto proporciona un servidor de Protocolo de contexto de modelo (MCP) para la integración de Salesforce, lo que le permite ejecutar consultas SOQL e interactuar con datos de Salesforce a través de una interfaz estandarizada.

Características

• Conectarse a organizaciones de Salesforce mediante variables de entorno
• Ejecutar consultas SOQL contra datos de Salesforce
• Recuperar y procesar registros de Salesforce
• Gestión segura de credenciales mediante variables de entorno

Prerrequisitos

• Node.js (v14 o superior)
• npm (Administrador de paquetes de Node)
• Organización de Salesforce con acceso a API
• Credenciales de Salesforce (nombre de usuario, contraseña y token de seguridad)

Instalación

1. Clonar este repositorio:
   git clone <repository-url> cd <repository-directory>
2. Instalar dependencias:
   npm install
3. Cree un archivo .env en el directorio raíz con sus credenciales de Salesforce:
   SF_LOGIN_URL=https://your-instance.salesforce.com/ SF_USERNAME=your_username SF_PASSWORD=your_password SF_SECURITY_TOKEN=your_security_token PORT=3000
   Nota: Para entornos sandbox, utilice https://test.salesforce.com/ como URL de inicio de sesión.

Uso

Iniciando el servidor MCP

Ejecute el servidor usando Node.js:

El servidor se conectará a Salesforce utilizando las credenciales en su archivo .env y comenzará a escuchar solicitudes de MCP.

Ejecución de consultas SOQL

Una vez que el servidor esté en ejecución, puede ejecutar consultas SOQL a través de la interfaz MCP. El servidor proporciona una herramienta soqlQuery que acepta consultas SOQL y devuelve los resultados.

Ejemplo de consulta SOQL:

Estructura del proyecto

• server.js - Implementación del servidor MCP principal
• .env - Variables de entorno para las credenciales de Salesforce
• package.json - Dependencias y scripts del proyecto

Consideraciones de seguridad

• Nunca envíe su archivo .env al control de versiones
• Añade .env a tu archivo .gitignore
• Utilice variables de entorno para toda la información confidencial
• Considere utilizar un método de autenticación más seguro para entornos de producción

Solución de problemas

Problemas de conexión

Si encuentra problemas de conexión:

1. Verifique sus credenciales de Salesforce en el archivo .env
2. Compruebe que su organización de Salesforce sea accesible
3. Asegúrese de que su dirección IP esté en la lista blanca de Salesforce (si es necesario)
4. Verifique que su usuario de Salesforce tenga acceso a la API

Errores de consulta

Si sus consultas SOQL fallan:

1. Compruebe la sintaxis SOQL
2. Verifique que los objetos y campos existan en su organización
3. Asegúrese de que su usuario tenga permiso para acceder a los objetos y campos

Licencia

Licencia MIT

Contribuyendo

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