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
Manejo intuitivo de errores : comentarios claros con detalles de errores específicos de Salesforce

Instalación

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

Configuración

Autenticación de Salesforce

Puede autenticarse con Salesforce mediante uno de dos métodos:

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

Configura tus credenciales de Salesforce
Obtenga su token de seguridad (Restablecer desde la configuración de Salesforce)
Configure las variables de entorno como se muestra en la sección de configuración

2. Autenticación OAuth2 con clave/secreto del consumidor

Configurar una aplicación conectada en Salesforce
Obtenga la clave del consumidor y el secreto del consumidor
Configure las variables de entorno como se muestra en la sección de configuración

Integración IDE

Configuración del IDE del cursor

Instalar el paquete globalmente:

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

Configurar el servidor MCP en Cursor IDE .cursor/mcp.json :

Uso del comando env

{
  "mcpServers": {
    "salesforce": {
      "command": "env",
      "args": [
        "SALESFORCE_USERNAME=your.actual.email@example.com",
        "SALESFORCE_PASSWORD=YourActualPassword123",
        "SALESFORCE_TOKEN=YourActualSecurityToken123",
        "SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
        "npx",
        "-y",
        "@surajadsul02/mcp-server-salesforce"
      ]
    }
  }
}

Para la autenticación OAuth2 en el cursor

{
  "mcpServers": {
    "salesforce": {
      "command": "env",
      "args": [
        "SALESFORCE_USERNAME=your.actual.email@example.com",
        "SALESFORCE_PASSWORD=YourActualPassword123",
        "SALESFORCE_TOKEN=YourActualSecurityToken123",
        "SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
        "SALESFORCE_CONSUMER_KEY=YourConsumerKey",
        "SALESFORCE_CONSUMER_SECRET=YourConsumerSecret",
        "npx",
        "-y",
        "@surajadsul02/mcp-server-salesforce"
      ]
    }
  }
}

Configuración del escritorio de Claude

Instalar el paquete globalmente (si aún no está instalado):

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

Añade a tu claude_desktop_config.json :

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

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@surajadsul02/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_USERNAME": "your_username",
        "SALESFORCE_PASSWORD": "your_password",
        "SALESFORCE_TOKEN": "your_security_token",
        "SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
      }
    }
  }
}

Para la autenticación OAuth2

{
  "mcpServers": {
    "salesforce": {
      "command": "npx",
      "args": ["-y", "@surajadsul02/mcp-server-salesforce"],
      "env": {
        "SALESFORCE_USERNAME": "your_username",
        "SALESFORCE_PASSWORD": "your_password",
        "SALESFORCE_CONSUMER_KEY": "your_consumer_key",
        "SALESFORCE_CONSUMER_SECRET": "your_consumer_secret",
        "SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
      }
    }
  }
}

Ubicación del archivo de configuración:
- macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude Desktop\claude_desktop_config.json
- Linux: ~/.config/Claude Desktop/claude_desktop_config.json

Variables de entorno requeridas

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

SALESFORCE_USERNAME : Su nombre de usuario/correo electrónico de Salesforce
SALESFORCE_PASSWORD : Su contraseña de Salesforce
SALESFORCE_TOKEN : Su token de seguridad de Salesforce
SALESFORCE_INSTANCE_URL : URL de su instancia de Salesforce (opcional, predeterminado: https://login.salesforce.com )

Para la autenticación OAuth2:

SALESFORCE_USERNAME : Su nombre de usuario/correo electrónico de Salesforce
SALESFORCE_PASSWORD : Su contraseña de Salesforce
SALESFORCE_CONSUMER_KEY : La clave de consumidor de su aplicación conectada
SALESFORCE_CONSUMER_SECRET : El secreto del consumidor de su aplicación conectada
SALESFORCE_INSTANCE_URL : URL de su instancia de Salesforce (opcional, predeterminado: https://login.salesforce.com )

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"

Desarrollo

Construyendo desde la fuente

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

# Navigate to directory
cd mcp-server-salesforce

# Install dependencies
npm install

# Build the project
npm run build

Solución de problemas

Errores de autenticación
- Verifique que sus credenciales sean correctas
- Para la autenticación con nombre de usuario y contraseña: asegúrese de que el token de seguridad sea correcto
- Para OAuth2: verificar la clave y el secreto del consumidor
Problemas de conexión
- Comprueba la URL de tu instancia de Salesforce
- Verificar la conectividad de la red
- Asegúrese de que los permisos de acceso a la API sean adecuados
Integración de Cursor IDE
- Reiniciar Cursor IDE después de los cambios de configuración
- Consulte las Herramientas para desarrolladores (Ayuda > Activar/desactivar herramientas para desarrolladores) para ver si hay mensajes de error
- Verificar que el paquete esté instalado globalmente
Integración de escritorio de Claude
- Verificar la ubicación del archivo de configuración
- Comprobar permisos de archivos
- Reiniciar Claude Desktop después de los cambios de configuración
- Asegúrese de que las variables de entorno estén configuradas correctamente

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.

Salesforce MCP Server

Integrations