# Collega l'IA a HubSpot

> Aggiornare le note delle trattative e ritrovare il contesto di un account toglie tempo alla vendita.

Questo setup è pensato per founder e piccoli team commerciali che gestiscono la pipeline in HubSpot e perdono tempo in attività amministrative. Claude legge contatti, aziende e trattative tramite il server MCP di HubSpot, riassume gli account e propone aggiornamenti che approvi tu. Ottieni una chat che risponde alle domande sulla pipeline e scrive follow-up basati sul contesto reale delle trattative.

## Passaggi

1. **Collega HubSpot in modo sicuro**: In HubSpot autorizza il server MCP remoto di HubSpot tramite OAuth oppure crea un'app privata in Impostazioni > Integrazioni > App private. Seleziona solo gli scope CRM che ti servono, di solito lettura e scrittura per contatti, aziende e trattative. Copia il token di accesso e conservalo in un posto sicuro.
   Consiglio: Se all'inizio vuoi solo dei riepiloghi, concedi gli scope di lettura e aggiungi quelli di scrittura più avanti.
2. **Registra il server MCP di HubSpot**: Apri il file di configurazione di Claude Desktop o esegui claude mcp add in Claude Code, poi aggiungi il server HubSpot con il token come variabile d'ambiente. Riavvia Claude Desktop perché legga la modifica. Controlla che gli strumenti HubSpot compaiano nel menu degli strumenti prima di andare avanti.
   Consiglio: Tieni il token in una variabile d'ambiente invece di incollarlo in un file di configurazione condiviso.
3. **Parti dalle attività di lettura**: Chiedi a Claude di riassumere un account che conosci bene, poi confronta la risposta con quello che mostra HubSpot. Prova una revisione della pipeline del mese in corso e verifica le fasi e gli importi delle trattative che riporta. Così capisci se scope e dati tornano prima di fare qualsiasi modifica.
   Consiglio: Scegli un account con note disordinate: è lì che gli errori saltano fuori per primi.
4. **Aggiungi il contesto delle email**: Aggiungi un server MCP di Google Workspace e accedi con l'account Google che usi per le email commerciali. Chiedi a Claude di scrivere un follow-up partendo dalle ultime note della trattativa e di lasciarlo nelle bozze di Gmail. Rileggi ogni bozza prima di inviarla.
   Consiglio: Chiedi solo bozze, così niente parte dalla tua casella senza di te.

## Prompt da provare

- Riassumi l'account Acme: trattative aperte, data dell'ultimo contatto e prossimo passo nelle note.
- Elenca le trattative in fase Proposta senza alcuna attività negli ultimi 14 giorni.
- Sposta la trattativa Northwind in Negoziazione e aggiungi una nota che dice che il prezzo è stato approvato nella chiamata di oggi.
- Scrivi un'email di follow-up al contatto principale della trattativa Globex partendo dall'ultima nota della riunione.
- Quali contatti nelle aziende segnate come Perse in questo trimestre potremmo ricontattare?

## Cosa ti serve

- Un account HubSpot con il permesso di creare app private o autorizzare app
- Claude Desktop o Claude Code
- Un account Google Workspace o Gmail per scrivere i follow-up
- Node.js installato se esegui il server HubSpot in locale

## Limiti

- Claude vede solo ciò che espongono gli scope del token e il tuo piano HubSpot: oggetti personalizzati o pipeline con restrizioni potrebbero mancare.
- I portali grandi possono restituire liste lunghe: chiedi viste filtrate invece dell'intera pipeline.
- Claude può fraintendere note scritte di fretta: controlla i riepiloghi prima di agire.

## Note di sicurezza

- Limita il token agli oggetti CRM.
- Approva ogni scrittura finché i risultati non sono affidabili.

## Server MCP

- [HubSpot MCP Server](https://developers.hubspot.com/mcp): crm-read, crm-write
- [Google Workspace MCP Server](https://github.com/taylorwilsdon/google_workspace_mcp): gmail-read, gmail-send, calendar-read, calendar-write

## Domande frequenti

**Di quale piano HubSpot ho bisogno?**

Le app private e l'API CRM sono disponibili anche sugli account HubSpot gratuiti, ma gli oggetti e le proprietà che puoi usare dipendono dal tuo piano. Verifica che i dati che ti servono, come gli oggetti personalizzati, esistano nel tuo piano prima di costruirci sopra i prompt.

**Claude può modificare le trattative senza chiedermelo?**

Claude Desktop e Claude Code chiedono la tua approvazione prima di ogni chiamata a uno strumento, a meno che tu non lo autorizzi in modo permanente. Lascia gli strumenti di scrittura in modalità richiesta finché non hai visto abbastanza aggiornamenti corretti da fidarti.

**Funziona in Claude Code come in Claude Desktop?**

Sì. Entrambi supportano i server MCP, e i server HubSpot e Workspace funzionano allo stesso modo in tutti e due. Claude Desktop è adatto ai commerciali, Claude Code a chi lavora già nel terminale.

**Cosa succede se il token viene diffuso?**

Chiunque abbia il token può leggere e modificare le schede CRM entro i limiti dei suoi scope. Revocalo o rigeneralo nelle impostazioni dell'app privata, poi aggiorna la configurazione MCP con quello nuovo.

## Strumenti

- **[HubSpot](https://suiteintent.com/t/hubspot?m=IT)**: CRM con hub per marketing, vendite e assistenza. · Ideale per: Team che condividono la scheda di ogni cliente · Piano gratuito · 90%
- **[Gmail](https://suiteintent.com/t/gmail?m=IT)**: Il servizio email di Google. · Ideale per: Email accanto a Google Calendar e Drive · Piano gratuito