Serwer HubSpot MCP: którą drogę wybrać, co potrafi i gdzie się kończy

Serwer HubSpot MCP: którą drogę wybrać, co potrafi i gdzie się kończy

Tak, HubSpot MCP istnieje jako oficjalny serwer. Zdalny serwer pod adresem https://mcp.hubspot.com pozwala Claude'owi, ChatGPT i innym klientom MCP odczytywać i zmieniać rekordy na Twoim koncie HubSpot, a od 13 kwietnia 2026 jest ogólnie dostępny dla wszystkich kont HubSpot. Jeśli używasz Claude'a lub ChatGPT, nie budujesz niczego: instalujesz gotowy konektor HubSpot i się logujesz. Własny konektor MCP w HubSpot tworzysz dopiero wtedy, gdy łączysz innego klienta.

HubSpot udostępnia też drugi, niezwiązany z pierwszym serwer dla deweloperów, który działa lokalnie przez HubSpot CLI, czyli w terminach protokołu lokalny serwer MCP. Większość zamieszania wokół „HubSpot MCP” bierze się z mylenia tych dwóch albo z mylenia serwera HubSpot z licznymi serwerami społeczności na GitHubie.

Ujawnienie: ten poradnik publikuje Customermates, CRM open source z własnym serwerem MCP. Szczegóły o HubSpot sprawdziliśmy 8 października 2026 na stronach samego HubSpot, podlinkowanych w wierszu źródeł na końcu.

W skrócie

Serwer zdalny

Hostowany przez HubSpot pod adresem mcp.hubspot.com. Odczytuje i zapisuje rekordy CRM, aktywności i treści marketingowe, zawsze w ramach uprawnień zalogowanego użytkownika w HubSpot.

Najszybsza droga

Claude i ChatGPT: zainstaluj konektor HubSpot i zaloguj się przez OAuth. HubSpot podaje, że konektor dla Claude jest darmowy w każdym planie HubSpot.

Inni klienci

Utwórz konektor MCP w sekcji Development w HubSpot, a potem użyj jego identyfikatora klienta i sekretu w kliencie obsługującym OAuth z PKCE.

Główne limity

Dane o aktywnościach i rozmowach są blokowane, gdy włączone jest Sensitive Data, udokumentowany dostęp do zapisu nie obejmuje usuwania, a część narzędzi wymaga płatnych hubów.

Najpierw wybierz drogę

Na pytanie „jak połączyć HubSpot MCP” są cztery różne odpowiedzi, zależnie od klienta i zadania.

Piątą opcją są serwery firm trzecich. Zapier na przykład oferuje akcje HubSpot przez własny serwer MCP pod adresem mcp.zapier.com, a na GitHubie jest kilka serwerów HubSpot tworzonych przez społeczność, które uruchamiasz samodzielnie. Przydają się, gdy chcesz mieć jeden serwer MCP dla wielu aplikacji. To nie jest serwer HubSpot, więc jego zakres, utrzymanie i obsługa danych zależą od decyzji jego autora.

Co zdalny serwer może czytać i zapisywać

Przewodnik integracji HubSpot szczegółowo wymienia zakres dostępu. W skrócie:

Dwa szczegóły mają znaczenie przy planowaniu. Serwer jest zbudowany na API wyszukiwania CRM w HubSpot, które według HubSpot nie ma wyszukiwania wektorowego, więc AI znajduje rekordy po filtrach i właściwościach, a nie po znaczeniu. A gdy rekord jest tworzony lub aktualizowany, serwer stosuje logikę warunkowych pól konta i walidacje etapów pipeline, więc AI nie może pominąć wymaganego pola, którego nie mógłby pominąć człowiek.

Limity, które dokumentuje HubSpot

• Sensitive Data blokuje aktywności. Jeśli na Twoim koncie włączone jest Sensitive Data, połączenia, e-maile, spotkania, notatki, zadania i rozmowy są przez serwer MCP blokowane. HubSpot zaznacza, że dotyczy to tylko MCP, a nie jego standardowych API CRM.
• Brak usuwania. Udokumentowany dostęp do zapisu obejmuje tworzenie, edycję, rejestrowanie i publikowanie. Usuwania rekordów nie wymieniono, więc sprzątanie pozostaje ręczną pracą w HubSpot.
• Uprawnienia się przenoszą. Każde wywołanie działa jako zalogowany użytkownik i respektuje jego uprawnienia w HubSpot. Dostęp do skrzynki ograniczony do wybranych użytkowników lub zespołów jest ograniczony także przez MCP.
• Zakresy uprawnień są ustalone przy instalacji. Nie wybierasz ich sam. Wynikają z narzędzi dostępnych w chwili instalacji i uprawnień przyznanych przez użytkownika. Gdy HubSpot dodaje narzędzia, dotychczasowi użytkownicy muszą zainstalować konektor ponownie, żeby przyznać nowe zakresy.
• Część narzędzi wymaga płatnych hubów. Metryki AEO i śledzone prompty wymagają Marketing Hub Professional lub Enterprise; oferty cenowe wymagają Revenue Hub Professional lub Enterprise.
• Analiza jest ograniczona. Narzędzie zapytań SQL obsługuje filtrowanie, agregację i sortowanie, ale HubSpot podaje, że nie ma złączeń, podzapytań, przechodzenia po powiązaniach ani przeliczania walut. Pytania w rodzaju „wskaźnik wygranych według przejść między etapami w ostatnim kwartale” mogą wymagać kilku wywołań albo raportu zbudowanego w HubSpot.

Podłączenie: własna droga krok po kroku

Dla Claude'a i ChatGPT wszystko poniżej załatwia konektor. Dla każdego innego klienta przewodnik HubSpot opisuje takie kroki:

1. Utwórz konektor MCP

   W HubSpot przejdź do Development, potem MCP Connectors, potem Create MCP connector. Wpisz nazwę, opcjonalny opis i adres przekierowania, którego używa Twój klient. Do testów z MCP Inspector HubSpot prosi o dodanie http://localhost:6274/oauth/callback/debug.

2. Skopiuj dane uwierzytelniające

   Strona szczegółów konektora pokazuje identyfikator klienta, sekret klienta i adresy przekierowania. Adres przekierowania musi dokładnie odpowiadać temu skonfigurowanemu w Twoim kliencie.

3. Wskaż klientowi serwer

   Skonfiguruj klienta z adresem https://mcp.hubspot.com i danymi uwierzytelniającymi. Klient musi przeprowadzić przepływ OAuth z PKCE. MCP Inspector robi to automatycznie; we własnej integracji implementujesz to sam.

4. Autoryzuj i sprawdź

   Wybierz konto HubSpot, przyznaj uprawnienia i autoryzuj. Potem wywołaj get_user_details: HubSpot zaleca to, żeby zobaczyć, z jakich narzędzi i obiektów Twoje konto naprawdę może korzystać.

Gdy połączenie nie działa: najczęstsze przyczyny

Problemy z HubSpot MCP wynikają zwykle z kilku powtarzalnych źródeł. Zanim zaczniesz szukać dalej, sprawdź je po kolei:

• Błąd uwierzytelniania. Klient musi przeprowadzić przepływ OAuth z PKCE. Jeśli logowanie kończy się błędem, sprawdź najpierw, czy Twój klient w ogóle obsługuje PKCE, a potem, czy adres przekierowania w kliencie dokładnie odpowiada temu zapisanemu w konektorze MCP w HubSpot.
• Klient przestał działać po przerwie. Zwykle winne jest odświeżanie tokenu. Klient musi użyć tokenu odświeżania z pierwszego logowania; jeśli i ten wygasł, przeprowadź przepływ OAuth od nowa.
• Brakuje połączeń, e-maili i notatek. Sprawdź, czy na koncie nie jest włączone Sensitive Data; wtedy HubSpot blokuje dane o aktywnościach i rozmowach przez MCP.
• Narzędzie jest, ale nie ma do niego dostępu. Wywołaj get_user_details, żeby zobaczyć, z czego Twoje konto naprawdę może korzystać, i porównaj z uprawnieniami użytkownika w HubSpot oraz planem płatnych hubów.
• Nowe narzędzia nie pojawiają się u dotychczasowych użytkowników. Zakresy uprawnień są ustalane przy instalacji, więc po dodaniu narzędzi przez HubSpot trzeba zainstalować konektor ponownie.

Serwer MCP HubSpot dla deweloperów

Serwer MCP dla deweloperów działa na Twoim komputerze i konfiguruje się go poleceniem hs mcp setup (HubSpot CLI w wersji 8.2.0 lub nowszej). Współpracuje z Claude Code, Codex CLI, Cursorem, Gemini CLI, VS Code i Windsurf, a w nich widnieje jako „HubSpotDev”. HubSpot opisuje go jako narzędzia do zadań związanych z tworzeniem aplikacji i CMS. To nie jest droga dla zespołu sprzedaży, który chce pracować z rekordami CRM; do tego służy serwer zdalny.

Lista kontrolna wdrożenia dla małego zespołu

1. Najpierw sprawdź Sensitive Data. Jeśli jest włączone, MCP nie zobaczy aktywności ani rozmów, co odbiera większość przydatnych pytań o szansę sprzedaży. Lepiej wiedzieć o tym, zanim ktokolwiek zacznie próbować.
2. Przejrzyj uprawnienia użytkowników w HubSpot. AI widzi dokładnie to, co użytkownik. Jeśli użytkownik może edytować każdą szansę, może to także jego podłączony klient.
3. Zacznij od odczytu. Dobre pierwsze polecenia: „Streść ostatnie pięć aktywności przy szansie Acme”, „Które otwarte szanse na etapie Proposal nie mają aktywności od 14 dni?”, „Wypisz kontakty w Acme i ich ostatnie spotkanie”.
4. Potem pozwól na rejestrowanie. „Zapisz notatkę przy szansie Acme: rozmowa we wtorek, budżet zatwierdzony, wysłać projekt umowy”. Sprawdź potem notatkę w HubSpot.
5. Publikowanie zostaw ludziom. Serwer może publikować strony docelowe i wpisy na blogu. Zdecyduj, kto może prosić AI o takie działanie, zanim ktoś zrobi to przez przypadek.
6. Ogranicz konta tam, gdzie się da. HubSpot zwraca uwagę, że administratorzy Claude Enterprise mogą ograniczyć konektor do kont przydzielonych przez firmę, z weryfikowanymi ograniczeniami domen.

Jeszcze jedna uwaga dla zespołów z UE: wszystko, co klient AI odczyta z HubSpot, jest przetwarzane przez dostawcę AI tego klienta. Twoje warunki przetwarzania danych z HubSpot nie obejmują tego etapu, więc przed podłączeniem danych klientów sprawdź warunki dostawcy AI i własny rejestr czynności przetwarzania. Opis konektora HubSpot dla ChatGPT zaznacza też, że czat w konektorze nie jest obecnie dostępny w planie ChatGPT Pro dla użytkowników w EOG, Szwajcarii i Wielkiej Brytanii.

Gdy sam CRM ma serwer MCP

Jeśli wybierasz CRM, a nie łączysz istniejący, alternatywą jest serwer MCP wbudowany w CRM. Customermates to jeden z przykładów: punkt końcowy pod adresem /api/v1/mcp jest częścią każdego planu w chmurze i instalacji self-hosted. W Claude i ChatGPT dodajesz go jako własny konektor i się logujesz (instrukcja konfiguracji); Claude Code, Codex, Cursor i Gemini CLI łączą się kluczem API (konfiguracja CLI). Podłączony klient wykrywa 59 narzędzi, a zestaw możesz zawęzić parametrem w adresie URL, jak opisuje dokumentacja MCP.

Możliwość usuwania i wysyłania działa w obie strony. Serwer Customermates mówi podłączonym klientom, żeby przed usunięciem lub wysłaniem prosili o potwierdzenie, ale to wskazówka dla klienta, a nie bramka w serwerze: gdy autoryzowany klient wywoła narzędzie, ono się wykonuje. Sprawdź, jak Twój klient obsługuje zatwierdzanie narzędzi, i zacznij od odczytu i szkiców, tak samo jak w HubSpot.

Koszty też wyglądają inaczej. MCP jest wliczone w każdy plan, także w plan darmowy z limitem zapytań; plany płatne zaczynają się od 12 € za użytkownika miesięcznie, a narzędzia skrzynki odbiorczej wymagają planu Pro za 29 €. Zewnętrzny klient AI korzysta z Twojej własnej subskrypcji AI, a nie z kredytów Customermates. Customermates Cloud ma też Mate, asystenta w aplikacji korzystającego z kredytów AI w chmurze, jeśli wolisz w ogóle nie łączyć zewnętrznego klienta (dokumentacja Mate).

To, co Twój własny agent z tym robi, to follow-up. Gdy w Customermates Cloud od planu Pro podłączysz LinkedIn i e-mail, rozmowy z klientami leżą przy rekordzie klienta, jeśli dane kontaktowe się zgadzają albo sam je powiążesz, a Claude, ChatGPT lub Mate przygotowuje szkic odpowiedzi i następnego kroku do Twojego sprawdzenia i wysłania. Żeby to wypróbować, rozpocznij okres próbny: 14 dni planu Pro, bez karty kredytowej.

Customermates to zły wybór, jeśli polegasz na narzędziach marketingowych, help desk albo obiektach przychodowych HubSpot; nie ma żadnego z nich. Jeśli zostajesz przy HubSpot, używaj serwera HubSpot. Jeśli rozważasz zmianę, porównanie alternatyw dla HubSpot omawia kompromisy, a poradnik o Salesforce MCP wyjaśnia równoważne serwery w Salesforce. Jak serwer HubSpot wypada na tle serwerów Pipedrive, Attio, Salesforce i dostawców poczty, pokazuje ranking najlepszych serwerów MCP dla sprzedaży.

Najczęstsze pytania

Źródła: dane o HubSpot sprawdzone 8 października 2026 w przewodniku integracji zdalnego serwera MCP, dzienniku zmian o ogólnej dostępności, przewodniku konfiguracji serwera MCP dla deweloperów, stronie konektora HubSpot dla Claude, opisie konektora HubSpot dla ChatGPT, narzędziach AI HubSpot i stronie Zapier o HubSpot MCP.