Połącz HubSpot z Claude za pomocą MCP

HubSpotBezpłatny planStrumienie zapytańKlaudiusz

Zapytaj Claude po angielsku o swoje konto HubSpot: Agent działający już w Twojej sieci wykonuje zapytania SQL w trybie tylko do odczytu, a Twój klient AI nigdy nie przechowuje danych logowania. Zajmie to około dziesięciu minut, a plan Free w zupełności wystarczy.

Zacznij za darmo

Co z tego wyjdzie?

Claude, który może odpowiadać na pytania dotyczące Twojego konta HubSpot za pomocą zapytań w czasie rzeczywistym, tylko do odczytu, wyjaśniać znaczenie kolumn i odpowiadać na Twoje pytania – bez logowania do bazy danych i bez zmiany zapory sieciowej: agent już w Twojej sieci uruchamia zapytanie SQL i odsyła tylko wiersze. Po uruchomieniu agenta połączenie z Claude zajmuje około 90 sekund, jeśli nie przeszkadza Ci ekran ustawień. Na przykład:

Klaudiusz ChatGPT Kursor Kod Claude'a Kod VS Windsurf Interfejs wiersza poleceń Gemini JetBrains Kodeks+5 więcejTylko do odczytu

Co jest w środku hubspot.oferty na moim koncie HubSpot? Pokaż mi kilka wierszy i powiedz, co oznacza każda kolumna.

qs_get_table_schema qs_run_query inteligencja_schematu

Najpierw przyjrzałem się strukturze tabeli, a następnie uruchomiłem zapytanie tylko do odczytu przez Twojego agenta. Oto trzy wiersze hubspot.deals:

nazwa transakcji	scena transakcyjna	kwota
1042	Northwind Traders	Seattle
1057	Alpejskie wyposażenie	Denver
1063	Harbour Foods	Halifax

nazwa transakcji identyfikuje wiersz. scena transakcyjna oraz kwota są opisane w modelu inteligencji semantycznej, dzięki czemu mogę je filtrować według nazwy.

Które trzy kwota Wartości przyniosły największe przychody w tym kwartale i jak to wygląda w porównaniu z poprzednim kwartałem? Czy jest coś, na co powinienem zwrócić uwagę?

qs_get_relationships qs_run_query qs_run_query

Dołączyłem hubspot.oferty do zamówienia Na podstawie znalezionej relacji, Semantic Intelligence uruchomił agregację dla każdego kwartału. Oba zapytania były tylko do odczytu i zwróciły po 3 wiersze:

kwota	W tym kwartale	Ostatni kwartał	Zmiana
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	−26%

Denver historia jest taka: przychody wzrosły o 38% przy niemal takiej samej liczbie klientów, co przełożyło się na wzrost średniej wartości zamówienia. Halifax Spadek wyniósł 26%, a spadek dotyczy dwóch klientów, którzy zamawiali co miesiąc w zeszłym kwartale, a w tym wcale – warto zadzwonić przed końcem miesiąca. Seattle stoi w miejscu. Chcesz poznać nazwy dwóch kont Halifax?

Tylko SELECT, sprawdzane przez Agenta zalogowano na karcie Aktywność MCP Zwrócono 9 wierszy w 3 zapytaniach To samo połączenie u 14 klientów MCP

A może w ogóle nie podłączać klienta AI? W planie biznesowym Nova to asystent wbudowany w Query Streams. Korzysta z tego samego zestawu narzędzi agenta, co Twój klient AI, a dodatkowo z tego, czego nie robi klient zewnętrzny: tworzy i weryfikuje kod SQL w oparciu o model inteligencji semantycznej, przekształca odpowiedź w wykres i zapisuje wynik jako zapytanie, które Twój zespół może uruchomić z poziomu Excela, Arkuszy Google lub interfejsu REST API — bez klucza, bez konektora i bez instalacji. Użyj MCP, gdy Twoi pracownicy korzystają już z Claude, Cursor lub ChatGPT; użyj Nova, gdy chcesz uzyskać odpowiedzi w Portalu.

HubSpot przechowuje Twoje dane za pośrednictwem swojego API. Claude natomiast działa w przeglądarce lub terminalu i nic o tym nie wie. Typowy most polega na wklejeniu schematu do czatu i oczekiwaniu, lub przekazaniu serwerowi MCP z otwartym kodem źródłowym, hasła do HubSpot. Query Streams robi to inaczej: agent, który już ma dostęp do Twojego konta HubSpot, uruchamia zapisy SQL, które Claude zapisuje tylko do odczytu, a serwer MCP w międzyczasie sprawdza, kto pyta, co może zrobić i jak często. Claude otrzymuje odpowiedzi. Nigdy nie otrzymuje danych uwierzytelniających.

Czego będziesz potrzebować

Konto Query Streams

MCP jest dostępny w każdym planie, w tym w planie darmowym. Plan darmowy obejmuje jeden klucz lub jedną powiązaną aplikację, czyli wszystko, czego potrzebujesz w tym przewodniku. Zarejestruj się na my.querystreams.com.

HubSpot połączony przez Agenta

Agent zainstalowany na dowolnym komputerze stale aktywnym, z połączeniem HubSpot dodanym w Agentach danych. Jeszcze nie skończyłeś? Najpierw połącz HubSpot; zajmie to około dziesięciu minut.

MCP włączony dla Ciebie

Twórcy, właściciele i administratorzy mają to od samego początku. Wszyscy inni potrzebują administratora, żeby to zmienić. MCP przełącznik obok ich imienia pod Konto → Kontrola dostępuDo tego czasu na stronie MCP będzie widniał komunikat „MCP jest wyłączony dla Twojego konta”.

Klient AI

Aplikacje do czatów, takie jak claude.ai, Claude Desktop i ChatGPT, łączą się bez klucza. Claude Code, Cursor, VS Code i około dziesięciu innych narzędzi używa klucza; Portal Połącz klienta AI przewodnik konfiguruje każdy z nich.

Skonfiguruj w czterech krokach

1. Otwórz MCP w portalu

   Zaloguj się na my.querystreams.com i otwórz Transmisje strumieniowe → Na żywo → MCPStrona ma cztery zakładki: Połączenia, Kontekst, Narzędzia i dla administratorów, DziałalnośćSprawdź panel Inteligencja semantyczna na Połączenia Skoro już tu jesteś: wyświetla Twój łącznik HubSpot i informację, czy uruchomiono na nim Semantic Intelligence. Pełne pokrycie pozwala Claude'owi pisać poprawne zapytania SQL do HubSpot za pierwszym razem.

   Otwórz MCP

   Widzisz komunikat „MCP jest wyłączony dla Twojego konta”? Twoja organizacja ma MCP, ale Twój użytkownik jest wyłączony. Administrator włącza go za pomocą MCP przełącznik obok swojego imienia pod Konto → Kontrola dostępuTwórcy, właściciele i administratorzy są obecni od samego początku.

2. Wybierz sposób połączenia

   Istnieją dwie drogi dojścia, które kończą się w tym samym miejscu:

   Aplikacje do czatów · bez klucza

   claude.ai, Claude Desktop, ChatGPT

   W claude.ai i Claude Desktop otwórz Lista strumieni zapytań w katalogu złączy Anthropic kliknij Łączyć i zatwierdź. Dodając go przez adres URL, https://mcp.querystreams.com/mcp, to rozwiązanie awaryjne. W ChatGPT dodajesz strumienie zapytań z aplikacji (na razie w trybie programistycznym) i logujesz się za pomocą strumieni zapytań. W obu przypadkach otworzy się strona strumieni zapytań: wybierz organizację i uprawnienia, a następnie kliknij Zatwierdź połączenie. Nic do kopiowania. Połączenie pojawia się na Połączenia kartę i można ją tam odwołać.

   Narzędzia programistyczne · klucz

   Claude Code, Cursor, VS Code i przyjaciele

   Na stronie MCP kliknij Połącz klienta AIPrzewodnik pyta W jaki sposób połączy się Twój klient AI?: wybierać Użyj klucza w pliku konfiguracyjnym, wybierz swoje narzędzie, a następnie Wygeneruj klucz dla to: a Nazwa klucza, Czytać oraz Uruchom zapytania zaznaczone, Wygaśnięcie (Nigdy, 30 dni, 90 dni lub 1 rok). Skonfiguruj to pokazuje fragment kodu z wypełnionym kluczem i Sprawdź połączenie czeka na pierwsze połączenie.

   Obie metody wykorzystują te same trzy uprawnienia, które wybierasz na ekranie zgody lub za pomocą klucza:

   Czytać

   Wyświetlaj łączniki, przeglądaj tabele i kolumny, odczytuj zapisane zapytania i reguły alertów. Nigdy nie zwraca danych wierszowych.

   Uruchom zapytania

   Uruchom zapytania SQL tylko do odczytu i zapisane zapytania za pośrednictwem agenta i zwróć wiersze. Bez tego klient AI może opisać dane, ale nie może na nie odpowiedzieć.

   Analizować

   Profiluj tabele, odkrywaj relacje i kolejkuj uruchomienie Inteligencji Semantycznej. Wykorzystuje kredyty Nova AI i limit danych, więc ekran zgody nigdy nie zaznacza go wstępnie.

   Zgubiłeś klucz? Jest on wymieniony na Połączenia patka: Pokaż pełny klucz pokazuje to ponownie i Skopiuj pełny klucz Kopiuje go. Cofnij go tam, jeśli laptop zginie; każdy klient, który go używa, straci połączenie przy następnym połączeniu, w ciągu około pięciu minut.

3. Połącz Claude'a

   Wybierz przepis na Claude'a, którego używasz. Adres serwera jest wszędzie taki sam: https://mcp.querystreams.com/mcp.

   Claude w sieci, Claude na komputerze i urządzeniu mobilnym bez klucza

   1. Otwórz Lista strumieni zapytań w katalogu złączy Anthropic i kliknij Łączyć. Na pulpicie znajduje się pod + → Konektory.
   2. Rozwiązanie awaryjne, jeśli Twoja organizacja ukrywa łączniki katalogowe: Ustawienia → Łączniki → Dodaj niestandardowy łącznik, nazwa Strumienie zapytań, adres URL https://mcp.querystreams.com/mcp, Pola OAuth puste, Dodaj; następnie na czacie + → Strumienie zapytań → Łączyć.
   3. Otworzy się karta „Strumienie zapytań”. Zaloguj się, jeśli zostaniesz o to poproszony, wybierz organizację i sprawdź Czytać oraz Uruchom zapytania, opcjonalnie Ogranicz do określonych złączyi kliknij Zatwierdź połączenie.
   4. W Claude widzisz „Połączono ze strumieniami zapytań”. Za pierwszym razem, gdy Claude używa narzędzia, pojawia się pytanie: wybierz Zawsze pozwalaj.

   Jeśli dodasz go ręcznie w Claude Desktop, użyj Ustawienia → Łączniki → Dodaj, nie na czacie Dodaj rynek Opcja, która oczekuje repozytorium Git. Konektory synchronizują się z kontem Claude, więc aplikacje mobilne i pulpit automatycznie je wychwytują. Nazwy menu są Anthropic i można je przenosić.

   Kod Claude'a klawisz

   Jedno polecenie z kluczem z zakładki Połączenia:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "Klucz X-MCP: qsmcp_WKLEJ_TUTAJ_SWÓJ_KLUCZ"

   To pisze obecny projekt .mcp.json. Dodać --scope użytkownik mieć strumienie zapytań w każdym projekcie. Uruchom /mcp wewnątrz Claude Code, aby zobaczyć połączenie.

   Kursor klawisz

   Otwórz Ustawienia kursora → MCP → Dodaj nowy serwer MCPlub edytuj .kursor/mcp.json u podstaw Twojego miejsca pracy:

   .kursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "Klucz X-MCP": "qsmcp_WKLEJ_TUTAJ_SWÓJ_KLUCZ" } } } }

   Uruchom ponownie kursor lub uruchom MCP: Uruchom ponownie serwery; A strumienie zapytań Odznaka pojawia się na pasku stanu MCP.

   Używasz czegoś innego? Portalu Połącz klienta AI przewodnik zawiera gotowe do wklejenia przepisy dla ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev i JetBrains AI, a także Wklej i scal narzędzie, które upuszcza strumienie zapytań wpis do pliku konfiguracyjnego, który już posiadasz. Każdy klient obsługujący protokół MCP przez HTTP działa: serwer https://mcp.querystreams.com/mcp, nagłówek Klucz X-MCP (jakiś Autoryzacja: Posiadacz nagłówek z tym samym kluczem również działa).

4. Zadaj swoje pierwsze pytanie

   Zacznij od czegoś, na co już znasz odpowiedź, żeby Claude sięgnął po odpowiednie narzędzie. Trzy, które dobrze współpracują z Twoim kontem HubSpot:

   „Jakie dane mam na swoim koncie HubSpot?”

   Claude wyświetla listę tabel, które widzi, mówi, które z nich mają inteligencję semantyczną i pyta, na co chcesz spojrzeć.

   „Pokaż mi dziesięć wierszy z hubspot.deals i wyjaśnij każdą kolumnę.”

   Claude najpierw odczytuje strukturę tabeli (Odczyt), następnie uruchamia jedno zapytanie SELECT za pośrednictwem agenta (Uruchom zapytania) i opisuje znaczenie dealtage i amount.

   „Ile wierszy na kwotę ma hubspot.deals? Która kwota ma najwięcej?”

   Claude wpisuje komendę GROUP BY w dialekcie HubSpota, uruchamia ją i odpowiada jednym zdaniem, używając małej tabeli. Kontynuuj na tym samym czacie; zachowuje to kontekst.

   Aby potwierdzić okablowanie, zapytaj „Jakie mam łączniki Query Streams?”. Claude dzwoni qs_list_connectors, przewodnik po portalu Sprawdź połączenie krok mówi Połączonyi klucz lub aplikację na Połączenia karta pokazuje swoje Ostatnio używane w ciągu kilku sekund.

Co Claude może zrobić po połączeniu

Twój klient AI widzi narzędzia Query Streams i wybiera odpowiednie dla Twojego pytania. Portal Narzędzia zakładka zawiera listę wszystkich narzędzi i trybów dostępnych w ramach Twojego planu. Query Streams prosi klienta AI o odczytanie kolumn każdej tabeli przed wykonaniem zapytania, dzięki czemu używa prawdziwych nazw zamiast zgadywać. W każdym planie, także Free:

Zestaw narzędzi analitycznych. W przypadku planów płatnych Agent wykonuje pracę u podstaw, gdzie znajduje się Twoje konto HubSpot, więc Twój klient AI skupia się na myśleniu. Wersja darmowa działa tak jak zawsze.

Domyślne ustawienia są dostępne na Kontekst zakładka: limit liczby komórek tekstowych, widok schematu, rozmiar wyniku, domyślne ustawienia analizy i wstrzymane wyniki.

Dlaczego inteligencja semantyczna ma tu znaczenie

Każda odpowiedź, którą otrzymuje Claude, jest oznaczona informacją o źródle struktury, a Claude dostosowuje stopień zaufania do tego, co widzi.

Jeśli baza danych ma znaczenie, uruchom na niej inteligencję semantyczną raz Nova → Inteligencja. Ten Połączenia Karta pokazuje panel pokrycia dla każdego złącza. Jak działa inteligencja semantyczna.

Co pozwalają plany

Usługa MCP jest dostępna w każdym planie, w tym w planie darmowym, bez dodatkowych opłat. Każdy plan określa liczbę kluczy lub podłączonych aplikacji, które możesz przytrzymać, oraz liczbę połączeń na minutę, jakie może wykonać Twój klient AI:

Połączona aplikacja jest liczona jako klucz. Oprócz liczby zapytań na minutę, każdy klucz może wykonać maksymalnie 10 zapytań na minutę. Zapytanie trwa do 60 sekund, chyba że klient AI poprosi o więcej, maksymalnie pięć minut. Plan określa również liczbę wierszy zwracanych przez jedno zapytanie oraz, za pomocą zestawu narzędzi analitycznych, czas trwania i rozmiar przechowywanego wyniku. pełny przewodnik MCP wyświetla wszystkie plany. To, co otrzymuje Twój klient AI, jest wliczane do limitu Data Realm, czyli tej samej puli, z której korzystają zapytania Excel i Sheets: użycie agenta AI (MCP) obejmuje każdy bajt dostarczony do klienta AI — wyniki, odczyty schematu i strony z zatrzymanymi wynikami — przed kompresją transportową uzgodnioną przez klienta. W przypadku zapytań arkuszy kalkulacyjnych liczony jest skompresowany wynik dostarczony przez agenta Network Agent. Uruchomienia Semantic Intelligence rozpoczęte z poziomu klienta AI zużywają kredyty Nova AI, tak samo jak uruchomienia z poziomu Portalu. Zobacz stronę z cennikiem za dodatki.

Dbanie o bezpieczeństwo

Dobre następne ruchy

• Zapisz zapytania, które uważasz za kanoniczne w Kreatorze zapytań. Claude najpierw sięga po zapisane zapytania, więc „aktywni klienci” oznaczają to, co mówi Twój zespół.
• Użyj projektu Claude z dołączonymi strumieniami zapytań i umieść w instrukcjach swoje zasady domowe: która baza danych HubSpot ma być używana domyślnie, które zapisane zapytania są oficjalnymi definicjami.
• Udziel opcji Analize, jeśli chcesz uzyskać głębsze odpowiedzi. Profilowanie kolumny przed filtrowaniem jej według to różnica między odgadnięciem kodu statusu a użyciem właściwego. Wykorzystuje to kredyty Nova AI, więc filtr jest wyłączony, dopóki nie zdecydujesz.
• Poproś o wykres. claude.ai rysuje wykresy na podstawie wierszy otrzymanych przez Claude'a.

Kiedy coś nie działa

Pytania, które zadają ludzie

Powiązane przewodniki

• Połącz Stripe z Claude za pomocą MCP
• Połącz Shopify z Claude za pomocą MCP
• Połącz Google Analytics 4 z Claude za pomocą MCP
• Połącz Google Search Console z Claude za pomocą MCP
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Jak połączyć HubSpot z Arkuszami Google
• Wszystkie przewodniki MCP