Servidor MCP Salesforce

Una implementació de servidor MCP (Model Context Protocol) que integra Claude amb Salesforce, permetent interaccions en llenguatge natural amb les dades i metadades de Salesforce. Aquest servidor permet a Claude consultar, modificar i gestionar els objectes i registres de Salesforce utilitzant un llenguatge quotidian.

Funcionalitats

• Gestió d'objectes i camps: crear i modificar objectes i camps personalitzats amb llenguatge natural
• Cerca intel·ligent d'objectes: trobar objectes Salesforce amb coincidències parcials de nom
• Informació detallada del esquema: obtenir detalls complets de camps i relacions per a qualsevol objecte
• Consultes de dades flexibles: consultar registres amb suport de relacions i filtres complexos
• Manipulació de dades: inserir, actualitzar, esborrar i upsertar registres amb facilitat
• Cerca entre objectes: cercar entre diversos objectes amb SOSL
• Gestió de codi Apex: llegir, crear i actualitzar classes i triggers Apex
• Gestió d'errors intuïtiva: retroalimentació clara amb detalls d'errors específics de Salesforce

Instal·lació

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

Eines

salesforce_search_objects

Cerca d'objectes estàndard i personalitzats:

• Cerca per coincidències parcials de nom
• Troba tant objectes estàndard com personalitzats
• Exemple: "Find objects related to Account" troba Account, AccountHistory, etc.

salesforce_describe_object

Obtenir informació detallada del esquema d'un objecte:

• Definicions i propietats dels camps
• Detalls de les relacions
• Valors de les llistes de selecció
• Exemple: "Show me all fields in the Account object"

salesforce_query_records

Consultar registres amb suport de relacions:

• Relacions pare-hijo
• Relacions hijo-pare
• Condicions WHERE complexes
• Exemple: "Get all Accounts with their related Contacts"
• Nota: per a consultes amb GROUP BY o funcions agregades, utilitzeu salesforce_aggregate_query

salesforce_aggregate_query

Executar consultes agregades amb GROUP BY:

• GROUP BY camp o múltiples camps
• Funcions agregades: COUNT, COUNT_DISTINCT, SUM, AVG, MIN, MAX
• Clàusules HAVING per filtrar resultats agrupats
• Funcions de grup per a dates/hores
• Exemple: "Count opportunities by stage" o "Find accounts with more than 10 opportunities"

salesforce_dml_records

Realitzar operacions de dades:

• Insertar nous registres
• Actualitzar registres existents
• Esborrar registres
• Upsert amb IDs externs
• Exemple: "Update status of multiple accounts"

salesforce_manage_object

Crear i modificar objectes personalitzats:

• Crear nous objectes personalitzats
• Actualitzar propietats dels objectes
• Configurar opcions de compartició
• Exemple: "Create a Customer Feedback object"

salesforce_manage_field

Gestionar camps d'objectes:

• Afegeix nous camps personalitzats
• Modifica propietats dels camps
• Crear relacions
• Concedeix automàticament la Seguretat de nivell de camp a System Administrator per defecte
• Utilitza el paràmetre grantAccessTo per especificar perfils diferents
• Exemple: "Add a Rating picklist field to Account"

salesforce_manage_field_permissions

Gestionar la Seguretat de nivell de camp (Permisos de camp):

• Concedir o revocar accés de lectura/edició a camps per a perfils específics
• Veure permisos de camp actuals
• Actualització en bloc de permisos per a múltiples perfils
• Útil per gestionar permisos després de la creació de camps o per a camps existents
• Exemple: "Grant System Administrator access to Custom_Field__c on Account"

salesforce_search_all

Cerca entre múltiples objectes:

• Cerca basada en SOSL
• Suport per a objectes múltiples
• Fragments de camps
• Exemple: "Search for 'cloud' across Accounts and Opportunities"

salesforce_read_apex

Llegir classes Apex:

• Obtenir el codi font complet de classes específiques
• Llistar classes que coincideixin amb patrons de nom
• Veure metadades de la classe (versió API, estat, etc.)
• Suport per a comodins (* i ?) en patrons de nom
• Exemple: "Show me the AccountController class" o "Find all classes matching Account*Cont"

salesforce_write_apex

Crear i actualitzar classes Apex:

• Crear noves classes Apex
• Actualitzar implementacions de classes existents
• Especificar versions API
• Exemple: "Create a new Apex class for handling account operations"

salesforce_read_apex_trigger

Llegir triggers Apex:

• Obtenir el codi font complet de triggers específics
• Llistar triggers que coincideixin amb patrons de nom
• Veure metadades del trigger (versió API, objecte, estat, etc.)
• Suport per a comodins (* i ?) en patrons de nom
• Exemple: "Show me the AccountTrigger" o "Find all triggers for Contact object"

salesforce_write_apex_trigger

Crear i actualitzar triggers Apex:

• Crear noves triggers per a objectes específics
• Actualitzar implementacions de triggers existents
• Especificar versions API i operacions d'esdeveniment
• Exemple: "Create a new trigger for the Account object" o "Update the Lead trigger"

salesforce_execute_anonymous

Executar codi Apex anònim:

• Executar codi Apex sense crear una classe permanent
• Veure registres de depuració i resultats d'execució
• Útil per a operacions de dades no directament suportades per altres eines
• Exemple: "Execute Apex code to calculate account metrics" o "Run a script to update related records"

salesforce_manage_debug_logs

Gestionar registres de depuració per a usuaris de Salesforce:

• Habilitar registres de depuració per a usuaris específics
• Desactivar configuracions de registre de depuració actives
• Recuperar i veure registres de depuració
• Configurar nivells de registre (NONE, ERROR, WARN, INFO, DEBUG, FINE, FINER, FINEST)
• Exemple: "Enable debug logs for user@example.com" o "Retrieve recent logs for an admin user"

Configuració

Autenticació a Salesforce

Podeu connectar-vos a Salesforce amb un dels dos mètodes d'autenticació:

1. Autenticació amb Nom d'Usuari/Contrasenya (Per defect