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

Clonar este repositorio:
git clone <repository-url> cd <repository-directory>
Instalar dependencias:
npm install
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:

node server.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:

SELECT Id, Name, Status FROM Account LIMIT 5

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:

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

Errores de consulta

Si sus consultas SOQL fallan:

Compruebe la sintaxis SOQL
Verifique que los objetos y campos existan en su organización
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.

Salesforce MCP Integration

Integrations