Claude cu HubSpot sau Salesforce prin MCP: ce verifici înainte să-l conectezi

Conectarea lui Claude cu HubSpot sau Salesforce prin MCP e partea ușoară a proiectului. Pentru HubSpot, varianta fără cod poate fi gata în sub trei minute, după estimările SyncGTM. Partea grea vine după. Claude intră într-un CRM cu câmpuri goale, stadii folosite diferit de fiecare om și drepturi date prea larg.

Ghidul acesta e pentru firmele al căror CRM nu este Zoho. Dacă lucrezi în Zoho, avem un ghid separat despre conectarea lui Claude la Zoho CRM prin MCP. Aici ne uităm la ce oferă HubSpot și Salesforce, la ce verifici înainte și la ordinea în care deschizi accesul.

Ideea de bază e simplă. Rezultatul depinde mai puțin de CRM-ul ales și mai mult de cât de curate sunt datele și de cine are voie să vadă și să schimbe ce. Un model bun citește la fel de sigur și o fișă corectă, și una greșită.

MCP (Model Context Protocol) este, în documentația Anthropic, o normă open source pentru integrările dintre AI și alte instrumente. Prin el, Claude se poate lega de sute de instrumente externe și surse de date. Un server MCP este bucata de software care stă între Claude și CRM și traduce cererile.

Un server MCP expune trei tipuri de lucruri, după descrierea din ghidul Coffee:

• Resources: date doar pentru citire.
• Tools: acțiuni, adică lucruri pe care Claude le poate face în CRM.
• Prompts: șabloane refolosibile.

Un connector este un server MCP gata configurat, pe care îl adaugi din setările lui Claude. Transportul contează și el. Documentația Claude Code recomandă serverele HTTP pentru conexiuni la distanță și spune că transportul SSE este depreciat. Serverele stdio rulează ca procese locale, pe calculatorul tău.

Mai e un avantaj practic. Odată ce există un server MCP pentru un instrument, toate aplicațiile AI din firmă îl pot refolosi, fără să refaci integrarea de fiecare dată. Asta face alegerea serverului o decizie pe termen lung, nu una de o zi.

HubSpot oferă un connector nativ pentru Claude, notează CData. SyncGTM descrie trei căi de conectare pentru Claude Code:

• HubSpot CLI oficial: cere versiunea 8.2.0 sau mai nouă și Node.js 18. Durează sub cinci minute.
• Un server open source din npm, de exemplu mcp-hubspot de pe GitHub: cel mai flexibil, 10 până la 15 minute.
• HubSpot Connector for Claude: fără terminal, sub trei minute, dar cere un abonament Anthropic plătit (Pro, Max, Team sau Enterprise).

Autentificarea se face cu un token de Private App sau prin OAuth, iar tu alegi ce portee (scopes) primește Claude. Doar un Super Admin sau cineva cu acces la App Marketplace poate crea Private Apps sau autoriza connectorul. Utilizatorii obișnuiți nu pot acorda portee.

Ce nu face connectorul

Limitele sunt cele care îți schimbă planul. Crearea sau actualizarea în masă merge doar câte 10 înregistrări odată. Obiectele personalizate nu sunt încă suportate. Datele nestructurate și activitățile asociate nu sunt accesibile. Și, foarte important, regulile de validare personalizate nu se aplică în timpul operațiilor făcute prin connector.

Ultima limită merită citită de două ori. Dacă firma ta se bazează pe reguli de validare ca să țină datele curate, Claude le ocolește. La asta se adaugă plafonul API: HubSpot permite 100 de cereri la 10 secunde pentru Private Apps.

La Salesforce, prima întrebare nu e tehnică, ci contractuală. CData spune că ediția Professional nu expune accesul API necesar pentru integrări terțe. Ai nevoie de Enterprise sau o ediție superioară. Verifică asta înainte să pierzi o zi cu configurarea.

A doua întrebare e cine face conectarea. Pentru Salesforce e nevoie de acces de System Administrator, iar pentru HubSpot de drepturi de Super Admin. Deci proiectul are nevoie de omul care deține administrarea CRM-ului, nu doar de cel care vrea rapoartele.

A treia întrebare e volumul. Ambele CRM-uri limitează câte cereri pot face instrumentele tale într-o anumită perioadă. Ca reper, CData dă exemplul unei organizații Salesforce Enterprise cu 50 de utilizatori, care primește aproximativ 1.000.000 de apeluri API pe zi. Dacă depășești limita, fluxurile AI se blochează sau cad cu totul.

CData mai listează trei probleme frecvente când legi Salesforce de Claude:

• diferențe de date între sisteme;
• limite de acces API după ediție;
• identificarea aceleiași persoane sau firme când unești înregistrări din mai multe platforme.

Niciuna nu ține de Claude. Toate țin de cum arată CRM-ul tău azi.

Regula de lucru e să nu dai lui Claude mai mult decât ar primi un om nou în echipă. La connectorii Google Workspace, Claude Help Center spune că Claude oglindește permisiunile existente: nu poți accesa prin el nimic la care nu ai deja acces. E un model bun de urmărit și în CRM.

Asta are o consecință directă. Dacă drepturile din CRM sunt prea largi azi, Claude le moștenește. Un vânzător care vede din greșeală toate contractele le va vedea și în răspunsurile lui Claude. Curățarea rolurilor vine înaintea conexiunii, nu după.

La HubSpot, connectorul dă implicit acces de citire la activități, iar accesul de scriere cere autorizare explicită. Păstrează-l așa la început. Când adaugi portee noi unei Private App, trebuie să regenerezi tokenul, pentru că cel vechi nu le moștenește. Iar tokenul generat apare o singură dată, deci îl copiezi imediat.

Tokenul nu stă într-un fișier oarecare. Coffee recomandă ca, în producție, cheile API să nu fie ținute în variabile de mediu, ci într-un manager de secrete, cum ar fi AWS Secrets Manager sau HashiCorp Vault.

La Svennis, înainte de orice conexiune, trecem în scris lista câmpurilor pe care Claude are voie să le scrie și numele omului care răspunde de fiecare. Fără lista asta, nu deschidem scrierea.

Maparea câmpurilor înseamnă să stabilești, pentru fiecare informație, în ce câmp stă și ce înseamnă. Pare birocratic, dar e punctul în care majoritatea conexiunilor reușesc sau eșuează. Claude nu știe că la voi „Data estimată” e completată doar de jumătate din echipă.

Într-o discuție pe r/hubspot, un utilizator avertizează că Claude poate personaliza foarte sigur pe sine pornind de la un context CRM greșit. Tot el spune că portalul trebuie să fie pregătit pentru agenți înainte de MCP. Lista lui de verificări e utilă:

• descrieri clare pentru fiecare proprietate;
• reguli pentru stadiile ciclului de viață al clientului;
• câmpurile care sunt sursa de adevăr;
• limitele de permisiuni;
• dacă rezultatele sunt revizuite înainte să fie scrise înapoi.

Un alt utilizator din aceeași discuție a observat că Claude lucrează mai bine cu semnale concrete, cum ar fi activitatea recentă pe site sau schimbările de stadiu, decât doar cu date demografice. Calitatea depinde, în cuvintele lui, de cât de bine ai segmentat datele de la început.

Formatul corect nu înseamnă conținut corect

Structured Outputs de la Anthropic forțează răspunsul să respecte o schemă JSON. Coffee atrage atenția că asta garantează forma și tipul datelor, nu și corectitudinea lor. Valorile pot fi greșite când sursa e ambiguă sau incompletă.

Ordinea sigură are patru trepte. Aceeași logică apare și în ghidul despre Claude și contabilitate, pentru că riscul e același: o scriere greșită se propagă.

1. Doar citire. Claude face rapoarte și liste. Tu verifici dacă ce spune se potrivește cu ce vezi în CRM.
2. Ciorne. Claude propune texte sau valori, dar nu scrie nimic. Un om le citește.
3. Scriere pe câmpuri de probă. Utilizatorul de pe r/hubspot descrie scrierea înapoi doar prin câmpuri aprobate sau câmpuri de staging, separate de cele oficiale.
4. Scriere reală, o înregistrare odată. CData recomandă să începi cu o singură actualizare, de exemplu schimbarea stadiului unui deal, înainte de modificări în masă.

Între trepte, întreabă-te cum afli ce s-a întâmplat dacă ceva merge prost. Un participant la aceeași discuție a pus exact întrebarea asta despre câmpurile de staging. Dacă nu poți reconstitui cine a schimbat ce și când, nu treci la treapta următoare.

Mai e un risc tehnic. Documentația Anthropic avertizează că serverele MCP care aduc conținut extern pot expune la injecție de prompt. Un câmp de note completat de un client poate conține instrucțiuni. Încă un motiv să ții scrierea închisă cât testezi.

Să luăm un manager de vânzări dintr-o firmă de distribuție care lucrează în HubSpot. Vrea o listă săptămânală cu deal-urile deschise care nu au dată de închidere. E un proces mic, măsurabil și care nu scrie nimic.

1. Super Adminul creează o Private App doar cu portee de citire pentru deal-uri. Copiază tokenul imediat, pentru că HubSpot îl arată o singură dată, și îl pune într-un manager de secrete.
2. Verifici versiunile. Pentru calea CLI ai nevoie de HubSpot CLI 8.2.0 sau mai nou și de Node.js 18.
3. Adaugi serverul în Claude Code cu transport HTTP, prin claude mcp add --transport http. Alegi porteea local, care îl face disponibil doar pentru tine, în proiectul curent. Porteea project l-ar împărți cu toată echipa prin fișierul .mcp.json, iar asta vine mai târziu.
4. Pui întrebarea în limbaj obișnuit: „Arată-mi deal-urile deschise fără dată de închidere, grupate pe responsabil.”
5. Compari cu CRM-ul. Deschizi trei deal-uri din listă și le verifici de mână.

Dacă lista e mare, Claude Code afișează un avertisment când răspunsul unui instrument MCP depășește 10.000 de tokeni și îl limitează implicit la 25.000. Cere liste pe echipe sau pe perioade, nu tot odată.

Abia după ce lista iese corectă de mai multe ori adaugi porteea de scriere. Regenerezi tokenul și testezi o singură schimbare de stadiu. Același flux poate fi folosit și în Claude Cowork, dacă echipa ta nu lucrează în terminal.

Tabelul de mai jos adună verificările din secțiunile anterioare. Treci prin el cu omul care administrează CRM-ul, înainte de prima conexiune.

Adaugă la listă patru întrebări care nu țin de CRM. Care sunt câmpurile sursă de adevăr? Cine revizuiește ce scrie Claude? Cum reconstitui o greșeală?

A patra întrebare e juridică. Avem, pentru planul Claude folosit, un contract de prelucrare conform art. 28 din GDPR și o bază pentru transferul datelor în afara SEE? Dacă una rămâne fără răspuns, conexiunea poate aștepta.

Pentru o firmă de aici, prima verificare e contractul. Dacă ești pe Salesforce Professional, drumul spre Claude trece mai întâi printr-o discuție despre ediție. La HubSpot, verifică cine din firmă are drepturi de Super Admin. De multe ori e o persoană care a plecat sau un furnizor extern.

A doua verificare ține de datele personale. Pentru orice firmă din România, datele persoanelor fizice din CRM, inclusiv numele și datele de contact ale oamenilor din firmele client, intră sub GDPR, indiferent de industrie. Coffee notează că firmele din industrii reglementate cer adesea furnizorilor certificări precum SOC 2 Type II și ISO 27001, ca cerință contractuală, nu legală.

Dacă Claude citește date personale din CRM, firma ta rămâne operator și are nevoie ca furnizorul să acționeze ca persoană împuternicită, pe baza unui contract conform art. 28 din GDPR, precum și de o bază pentru transferul datelor în afara SEE. Nu toate planurile Claude includ un astfel de acord, așa că verifică termenii planului folosit înainte să conectezi CRM-ul.

Pentru connectorii Google Workspace, Claude Help Center spune că datele aduse prin connector sunt stocate pe serverele Anthropic. Potrivit aceleiași pagini, datele sunt legate de conversație; verifică în documentația Anthropic cât timp sunt păstrate după ștergere. Merită să afli cum funcționează același lucru pentru CRM-ul tău, înainte să lași echipa să lucreze cu date de clienți.

A treia verificare e organizarea. Pe planurile Team și Enterprise, un Owner trebuie să activeze connectorii la nivel de organizație înainte ca utilizatorii să se poată autentifica, arată aceeași pagină pentru Google Workspace. Stabilește dinainte cine e acel Owner și ce aprobă.

Dacă nu ai încă un CRM ales, regula rămâne aceeași și pentru Zoho CRM: datele și drepturile contează mai mult decât marca.

Nu începe cu o integrare mare. Începe cu o întrebare pe care o pui des și la care răspunsul azi îți ia timp. Lista de deal-uri fără dată de închidere e un exemplu bun.

1. Programează o oră cu administratorul CRM-ului și treceți prin lista de control de mai sus.
2. Curăță rolurile și permisiunile care sunt azi prea largi.
3. Scrie descrieri pentru câmpurile pe care Claude le va citi și marchează sursa de adevăr.
4. Conectează doar pentru citire, pe porteea local, și compară rezultatele cu CRM-ul timp de câteva săptămâni.
5. Deschide scrierea pe un singur câmp, testată pe o singură înregistrare.

Dacă vrei să extinzi ce poate face Claude după primul proces, ghidul despre pluginurile Claude pentru o firmă mică te ajută să alegi ce adaugi. Iar când ajungi la oferte, poți urmări cum folosești prețurile reale din CRM într-un generator de oferte.