Salesforce MCP Server
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
Related MCP server: Salesforce MCP Server
Instalación
npm install -g @surajadsul02/mcp-server-salesforceConfiguració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-salesforceConfigurar 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-salesforceAñ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.jsonVentanas:
%APPDATA%\Claude Desktop\claude_desktop_config.jsonLinux:
~/.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 SalesforceSALESFORCE_PASSWORD: Su contraseña de SalesforceSALESFORCE_TOKEN: Su token de seguridad de SalesforceSALESFORCE_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 SalesforceSALESFORCE_PASSWORD: Su contraseña de SalesforceSALESFORCE_CONSUMER_KEY: La clave de consumidor de su aplicación conectadaSALESFORCE_CONSUMER_SECRET: El secreto del consumidor de su aplicación conectadaSALESFORCE_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 buildSolució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.
Available Tools
7 toolssalesforce_describe_objectA
Get detailed schema metadata including all fields, relationships, and field properties of any Salesforce object. Examples: 'Account' shows all Account fields including custom fields; 'Case' shows all Case fields including relationships to Account, Contact etc.
Inputs: objectName (required).
salesforce_dml_recordsA
Perform data manipulation operations on Salesforce records:
insert: Create new records
update: Modify existing records (requires Id)
delete: Remove records (requires Id)
upsert: Insert or update based on external ID field Examples: Insert new Accounts, Update Case status, Delete old records, Upsert based on custom external ID
Inputs: operation (required), objectName (required), records (required), externalIdField.
salesforce_manage_fieldA
Create new custom fields or modify existing fields on any Salesforce object:
Field Types: Text, Number, Date, Lookup, Master-Detail, Picklist etc.
Properties: Required, Unique, External ID, Length, Scale etc.
Relationships: Create lookups and master-detail relationships Examples: Add Rating__c picklist to Account, Create Account lookup on Custom Object Note: Changes affect metadata and require proper permissions
Inputs: operation (required), objectName (required), fieldName (required), label, +13 more.
salesforce_manage_objectA
Create new custom objects or modify existing ones in Salesforce:
Create: New custom objects with fields, relationships, and settings
Update: Modify existing object settings, labels, sharing model Examples: Create Customer_Feedback__c object, Update object sharing settings Note: Changes affect metadata and require proper permissions
Inputs: operation (required), objectName (required), label, pluralLabel, +5 more.
salesforce_query_recordsA
Query records from any Salesforce object using SOQL, including relationship queries.
Examples:
Parent-to-child query (e.g., Account with Contacts):
objectName: "Account"
fields: ["Name", "(SELECT Id, FirstName, LastName FROM Contacts)"]
Child-to-parent query (e.g., Contact with Account details):
objectName: "Contact"
fields: ["FirstName", "LastName", "Account.Name", "Account.Industry"]
Multiple level query (e.g., Contact -> Account -> Owner):
objectName: "Contact"
fields: ["Name", "Account.Name", "Account.Owner.Name"]
Related object filtering:
objectName: "Contact"
fields: ["Name", "Account.Name"]
whereClause: "Account.Industry = 'Technology'"
Note: When using relationship fields:
Use dot notation for parent relationships (e.g., "Account.Name")
Use subqueries in parentheses for child relationships (e.g., "(SELECT Id FROM Contacts)")
Custom relationship fields end in "__r" (e.g., "CustomObject__r.Name")
Inputs: objectName (required), fields (required), whereClause, orderBy, +1 more.
salesforce_search_allA
Search across multiple Salesforce objects using SOSL (Salesforce Object Search Language).
Examples:
Basic search across all objects: { "searchTerm": "John", "objects": [ { "name": "Account", "fields": ["Name"], "limit": 10 }, { "name": "Contact", "fields": ["FirstName", "LastName", "Email"] } ] }
Advanced search with filters: { "searchTerm": "Cloud*", "searchIn": "NAME FIELDS", "objects": [ { "name": "Account", "fields": ["Name", "Industry"], "orderBy": "Name DESC", "where": "Industry = 'Technology'" } ], "withClauses": [ { "type": "NETWORK", "value": "ALL NETWORKS" }, { "type": "SNIPPET", "fields": ["Description"] } ] }
Notes:
Use * and ? for wildcards in search terms
Each object can have its own WHERE, ORDER BY, and LIMIT clauses
Support for WITH clauses: DATA CATEGORY, DIVISION, METADATA, NETWORK, PRICEBOOKID, SNIPPET, SECURITY_ENFORCED
"updateable" and "viewable" options control record access filtering
Inputs: searchTerm (required), objects (required), searchIn, withClauses, +2 more.
salesforce_search_objectsA
Search for Salesforce standard and custom objects by name pattern. Examples: 'Account' will find Account, AccountHistory; 'Order' will find WorkOrder, ServiceOrder__c etc.
Inputs: searchPattern (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: describe_object for metadata, dml_records for data operations, manage_field/object for schema changes, query_records for SOQL, search_all for SOSL, and search_objects for object discovery. The descriptions explicitly differentiate their scopes, eliminating any confusion.
All tools follow a consistent 'salesforce_verb_noun' pattern with snake_case, such as salesforce_describe_object, salesforce_dml_records, and salesforce_query_records. This uniformity makes the toolset predictable and easy to navigate for an agent.
With 7 tools, the server is well-scoped for Salesforce operations, covering metadata, data manipulation, schema management, querying, and searching. Each tool serves a unique and essential function without redundancy, making the count ideal for the domain.
The toolset provides comprehensive coverage of Salesforce operations: metadata inspection (describe_object), full CRUD for data (dml_records), schema management (manage_field/object), querying (query_records), and searching (search_all/objects). There are no obvious gaps, supporting complete agent workflows from data to metadata.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Related MCP Servers
- AlicenseAqualityAmaintenanceAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.155,358 npm165MIT
- AlicenseAqualityDmaintenanceAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata.8MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server implementation that integrates Claude/VS Code with Salesforce, enabling natural language interactions with your Salesforce data and metadata.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides comprehensive access to Salesforce Tooling API for metadata management, SOQL queries, code analysis, and debugging through Claude and other AI assistants.48 npm5MIT