Integrazione Salesforce MCP Server

Cosa fa il “Salesforce” MCP Server?

Il Salesforce MCP Server è un’implementazione del Model Context Protocol (MCP) che collega assistenti AI, come Claude, con Salesforce. Permette interazioni in linguaggio naturale con dati e metadata Salesforce, consentendo agli utenti di interrogare, modificare e gestire oggetti e record Salesforce senza soluzione di continuità. Esponendo le potenti API di Salesforce tramite strumenti standard MCP, il server permette ai client AI di eseguire query su database, gestire oggetti, lavorare con codice Apex e automatizzare workflow direttamente dagli ambienti di sviluppo. Gli sviluppatori beneficiano così di un accesso semplificato alle risorse Salesforce, maggiore produttività e la possibilità di creare integrazioni e automazioni robuste, guidate dall’AI, su diverse piattaforme.

Elenco dei Prompt

Nessun template di prompt esplicito è elencato nel repository.

Elenco delle Risorse

Nessuna risorsa MCP esplicita è elencata nel repository.

Elenco degli Strumenti

• salesforce_search_objects
  Cerca oggetti standard e personalizzati in Salesforce utilizzando corrispondenze parziali del nome.
• salesforce_describe_object
  Recupera informazioni dettagliate sullo schema, inclusi campi, relazioni e picklist di un oggetto.
• salesforce_query_records
  Interroga i record con supporto per relazioni e condizioni complesse.
• salesforce_aggregate_query
  Esegue query di aggregazione con GROUP BY, HAVING e varie funzioni di aggregazione.
• salesforce_dml_records
  Inserisce, aggiorna, elimina o upsert i record Salesforce.
• salesforce_manage_object
  Crea e modifica oggetti personalizzati e ne regola le proprietà.
• salesforce_manage_field
  Aggiunge o modifica campi personalizzati, inclusi campi di relazione e permessi di accesso.
• salesforce_manage_field_permissions
  Concede/revoca/legge permessi di sicurezza a livello di campo per profili specifici.
• salesforce_search_all
  Cerca tra più oggetti Salesforce usando query SOSL.
• salesforce_read_apex
  Legge classi Apex, le elenca per pattern e ne recupera codice sorgente e metadata.
• salesforce_write_apex
  Crea o aggiorna classi Apex, specificando codice e versioni API.
• salesforce_read_apex_trigger
  Legge trigger Apex, elenca i trigger e ne recupera metadata/codice sorgente.
• salesforce_write_apex_trigger
  Crea o aggiorna trigger Apex per oggetti specifici, specificando eventi e versioni API.
• salesforce_execute_anonymous
  Esegue codice Apex anonimo e visualizza log di debug e risultati.

Casi d’Uso di questo MCP Server

• Gestione Database Salesforce
  Esegui operazioni CRUD sui record Salesforce, semplifica la manipolazione dati e automatizza compiti ripetitivi tramite istruzioni guidate dall’AI.
• Esplorazione Schema e Metadata
  Recupera rapidamente schemi oggetto, dettagli dei campi e relazioni per aiutare nelle integrazioni o comprendere strutture org complesse.
• Reportistica Avanzata e Aggregazione
  Esegui query di aggregazione per generare riepiloghi, eseguire analisi e filtrare risultati raggruppati, supportando le esigenze di business intelligence.
• Gestione Codice e Trigger Apex
  Leggi, crea e aggiorna classi o trigger Apex direttamente dal tuo ambiente di sviluppo, accelerando i cicli di deployment e manutenzione.
• Ricerca Trasversale e Scoperta Dati
  Utilizza ricerche SOSL per trovare informazioni su più oggetti, facilitando l’individuazione di record e relazioni in grandi org Salesforce.

Come configurarlo

Windsurf

1. Assicurati che Node.js sia installato sul tuo sistema.
2. Installa il Salesforce MCP Server:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Individua il file di configurazione Windsurf (es: windsurf.config.json).
4. Aggiungi il Salesforce MCP Server usando questo snippet JSON:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Salva il file e riavvia Windsurf.
6. Verifica che il server sia attivo nella dashboard MCP.

Claude

1. Assicurati che Node.js sia installato.
2. Installa il Salesforce MCP Server:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Modifica il file di configurazione dell’integrazione Claude.
4. Aggiungi la seguente sezione a mcpServers:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Salva e riavvia Claude.
6. Conferma la disponibilità di Salesforce MCP nel tuo workspace Claude.

Cursor

1. Installa Node.js.
2. Installa Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Apri il file di configurazione Cursor.
4. Aggiungi il Salesforce MCP Server come segue:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Salva le modifiche e riavvia Cursor.
6. Testa la connettività del server nel pannello integrazioni MCP.

Cline

1. Assicurati che Node.js sia installato.
2. Installa il pacchetto:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. Trova e apri il file di configurazione di Cline.
4. Inserisci il Salesforce MCP Server:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. Salva e riavvia Cline.
6. Controlla lo stato del server MCP nel menu strumenti.

Sicurezza delle API Key:
Utilizza sempre variabili d’ambiente per le credenziali sensibili. Nella configurazione, aggiungi i campi necessari all’oggetto env come sopra indicato.
Per passare input aggiuntivi, puoi usare:

{
  "mcpServers": {
    "salesforce-mcp": {
      "command": "mcp-server-salesforce",
      "args": [],
      "env": {
        "SALESFORCE_CLIENT_ID": "your-client-id"
      },
      "inputs": {
        "instanceUrl": "https://your-instance.salesforce.com"
      }
    }
  }
}

Come usare questo MCP nei flussi

Utilizzo di MCP in FlowHunt

Per integrare i server MCP nel tuo workflow FlowHunt, inizia aggiungendo il componente MCP al tuo flow e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo MCP server usando questo formato JSON:

{
  "salesforce-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una volta configurato, l’agente AI sarà in grado di utilizzare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricorda di cambiare “salesforce-mcp” con il vero nome del tuo MCP server e sostituire l’URL con quello del tuo server MCP.

Panoramica

Tra queste due tabelle, il Salesforce MCP Server offre un’ottima documentazione su strumenti e setup, ma manca di documentazione su template di prompt, risorse, radici o sampling. Il suo punto di forza è il robusto set di strumenti Salesforce e le istruzioni di setup chiare. In base a ciò, darei al repository un 7/10 per integrazione MCP pratica e usabilità per sviluppatori.

Punteggio MCP