Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi HubSpot con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai lavorare la tua AI in HubSpot CRM: cerca e aggiorna contatti, aziende, trattative e ticket, vedi chi è collegato a cosa, controlla pipeline e proprietari e registra note e attività. Un solo account, tramite una service key che crei tu.
Prova a chiedere
Prompt di esempio per HubSpot
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → HubSpot, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
HubSpot
Fai lavorare la tua AI in HubSpot CRM: cerca e aggiorna contatti, aziende, trattative e ticket, vedi chi è collegato a cosa, controlla pipeline e proprietari e registra note e attività. Un solo account, tramite una service key che crei tu.
Setup
- In HubSpot apri Development nella barra laterale sinistra, poi Keys → Service keys, e clicca su Create service key. Devi essere super admin o un utente con accesso ai Developer tools.
- Dai un nome alla chiave (per esempio "AnythingMCP"), clicca su Add new scope, spunta gli scope elencati qui sotto, poi clicca su Update e su Create.
- Apri la chiave, clicca su Show e poi su Copy. Le service key iniziano con
pat-(per esempiopat-eu1-...). - Inserisci la chiave in
HUBSPOT_ACCESS_TOKEN, senza la parola Bearer, poi installa il connettore. - Comincia con
hubspot_get_account: mostra a quale account HubSpot (Hub ID) appartiene la chiave, con il suo fuso orario e la sua valuta.
App private legacy: gli account meno recenti possono avere ancora un'app privata (Development → Legacy apps, in precedenza Settings → Integrations → Private Apps). Il suo access token funziona allo stesso modo: inseriscilo in HUBSPOT_ACCESS_TOKEN.
Scope:
- Lettura:
crm.objects.contacts.read(copre anche note e attività),crm.objects.companies.read,crm.objects.deals.read,crm.objects.tickets.read,crm.objects.owners.read. - Scrittura:
crm.objects.contacts.write(serve anche per note e attività),crm.objects.companies.write,crm.objects.deals.write,crm.objects.tickets.write.
Solo lettura: assegna alla chiave solo gli scope di lettura e disattiva hubspot_create_object, hubspot_update_object, hubspot_associate_records, hubspot_create_note e hubspot_create_task.
Disattivati all'installazione: hubspot_archive_object. Attivalo solo se l'AI deve eliminare record. I record archiviati finiscono nel cestino di HubSpot e da lì si possono ripristinare per 90 giorni.
Impostazioni sulla privacy dei dati: se nel tuo account HubSpot è attiva la privacy dei dati (GDPR), HubSpot richiede su ogni nuovo contatto una base giuridica per il trattamento, la proprietà hs_legal_basis. Di' all'AI quale base giuridica usare quando crea contatti; senza, HubSpot risponde "The following required properties were missing".
Limiti: HubSpot consente 100 richieste ogni 10 secondi per chiave sui piani Free e Starter (di più su Professional ed Enterprise), 250.000 richieste al giorno per account e 5 ricerche al secondo. Oltre un limite HubSpot risponde 429: attendi qualche secondo e riprova.
Errori comuni: 401 significa che la chiave è sbagliata, scaduta o è stata ruotata: copiala di nuovo. 403 indica lo scope mancante: aggiungilo alla chiave in Edit. 404 significa id o tipo di oggetto sbagliato. 400 VALIDATION_ERROR indica la proprietà o il filtro non validi, per esempio un nome di proprietà sconosciuto o un valore di un menu a tendina che non è tra le sue opzioni.
Il connettore non gestisce email di marketing, moduli, liste, workflow, file, preventivi e prezzi delle righe di prodotto, unioni di record o scritture in batch.
Prerequisiti: HUBSPOT_ACCESS_TOKEN
Installazione locale del connettore
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli HubSpot e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
hubspot_list_owners | List the HubSpot users who can own records (owners): owner id, user id, email, first and last name, teams and whether archived |
hubspot_get_account | Get the HubSpot account the token belongs to: portal id (Hub ID), account type, time zone and UTC offset, company currency and additional… |
hubspot_search_objects | Search CRM records of one object type (contacts, companies, deals, tickets, notes, tasks, ...) by free text and/or property filters, with… |
hubspot_list_objects | List CRM records of one object type page by page, oldest id first, with the chosen properties and optionally the ids of associated records |
hubspot_get_object | Get one CRM record by id (or by a unique property such as a contact's email with id_property), with the chosen properties, optional… |
hubspot_create_object | Create a CRM record (contact, company, deal, ticket, ...) with property values, optionally associated with existing records |
hubspot_update_object | Change property values of one CRM record; only the given properties change, and an empty string clears a value |
hubspot_archive_object | Archive (delete) one CRM record: it moves to the recycling bin, where it can be restored for 90 days |
hubspot_get_associations | List the records of one type associated with a record, with their association types and labels, e.g. all deals of a company or all contacts… |
hubspot_associate_records | Link two existing records with HubSpot's default (unlabeled) association, e.g. a contact to a company or a deal to a contact |
hubspot_list_pipelines | List the pipelines of deals or tickets with their stages: pipeline id and label, and per stage its id, label, display order and metadata… |
hubspot_list_properties | List the properties of an object type, default and custom: internal name, label, type, field type, group, description, whether read-only… |
hubspot_create_note | Add a note to the CRM timeline, associated with contacts, companies, deals or tickets |
hubspot_create_task | Create a task (to-do, call or email reminder) with a due date, optionally assigned to an owner and associated with records |
Esempi di prompt
- "Quali trattative della pipeline di vendita dovrebbero chiudersi questo mese, e chi le segue?"
- "Trova il contatto [email protected] e mostrami la sua azienda e le sue trattative aperte."
- "Sposta la trattativa Acme Corp alla fase successiva e aggiungi una nota con un riepilogo della chiamata di oggi."
- "Crea per me un'attività di follow-up sulla trattativa Globex, con scadenza venerdì prossimo."
Prossimi passi
Questa guida ti è stata utile?
