Zdalne serwery MCP w kampaniach
Podłącz własne serwery MCP, aby dać agentowi AI dostęp do CRM, dokumentacji wewnętrznej, analityki i innych narzędzi obsługujących Model Context Protocol.
Do czego służy połączenie
Agent outreach w Kit już bada każdego leada za pomocą wyszukiwania w sieci, źródłowych URL-i i bazy wiedzy kampanii. Czasem potrzebujesz, aby sięgnął również po dane dostępne tylko dla twojego zespołu: etap transakcji z CRM, wskaźnik kondycji klienta z hurtowni danych czy wewnętrzny podręcznik z wiki. Podłącz zgodny serwer MCP, aby udostępnić agentowi te dane przez jego narzędzia. Wymagania połączenia opisano poniżej.
Czym jest zdalny serwer MCP
Model Context Protocol to otwarty standard udostępniania narzędzi agentom AI przez JSON-RPC. Jeśli możesz hostować punkt końcowy HTTPS odpowiadający na tools/list i tools/call, agent outreach może z niego korzystać. Kit łączy się z serwerem i udostępnia wybrane narzędzia agentowi.
Typowe zastosowania:
| Zastosowanie | Przykład |
|---|---|
| Wyszukiwanie w CRM | „Czy ten lead miał wcześniej z nami kontakt?” |
| Dokumentacja wewnętrzna | „Znajdź odpowiednie case study dla kupującego z branży fintech.” |
| Własna hurtownia danych | „Sprawdź MRR firmy tego leada.” |
| Własny scoring | „Oceń tego leada na podstawie naszego modelu ICP.” |
Wymagania
Aby Kit mógł połączyć się ze zdalnym serwerem MCP, serwer musi:
- Być publicznie dostępny przez HTTPS. Punkty końcowe HTTP i prywatne zakresy IP są odrzucane ze względów bezpieczeństwa. Certyfikaty samopodpisane nie są obsługiwane.
- Być zgodny z JSON-RPC 2.0 zgodnie ze specyfikacją MCP.
-
Być uwierzytelniony tokenem bearer (opcjonalnie). Jeśli serwer wymaga uwierzytelniania, podaj token przy łączeniu. Kit wyśle go jako
Authorization: Bearer <token>przy każdym żądaniu. - Mieścić się w limitach. Kit ogranicza odpowiedzi do 512 KB, a listę narzędzi do 50 na serwer. Każde konto może podłączyć do 10 serwerów.
Podłączanie serwera
- Otwórz Integrations > MCP Servers i kliknij Dodaj serwer.
- Podaj rozpoznawalną nazwę (to właśnie ją AI widzi na liście narzędzi), adres URL punktu końcowego HTTPS oraz opcjonalny token bearer.
- Zapisz. Kit zleca pobranie listy narzędzi w tle. Wywołuje wtedy
tools/listna serwerze, zapisuje schemat w pamięci podręcznej i oznacza serwer jako Aktywny.
Pobieranie listy odbywa się w tle. Do momentu zakończenia serwer ma status Odkrywanie… i nie jest jeszcze dostępny do wyboru w kampanii. Jeśli odkrywanie się nie powiedzie, serwer przechodzi w stan Niepowodzenie z komunikatem błędu z serwera. Po trzech kolejnych niepowodzeniach Kit automatycznie wyłącza serwer i powiadamia administratora konta.
Wybór serwerów w kampanii
Otwórz dowolną kampanię, edytuj jej konfigurację i znajdź sekcję Zdalne serwery MCP. Każdy aktywny serwer na twoim koncie pojawia się z polem wyboru, adresem URL punktu końcowego i liczbą udostępnianych narzędzi. Zaznacz serwery tylko wtedy, gdy chcesz ograniczyć kampanię do wybranych.
Kilka uwag:
- Bez zaznaczenia działają wszystkie. Kampania korzysta wtedy z każdego aktywnego serwera na koncie. Gdy zaznaczysz konkretne, zostaną tylko one.
- Serwery wybierasz osobno dla każdej kampanii. Różne kampanie mogą korzystać z różnych kombinacji serwerów.
- Widoczne są tylko aktywne serwery. Serwery w trakcie odkrywania lub w stanie awarii są podsumowane w komunikacie pod listą.
-
Nazwy narzędzi mają przestrzenie nazw. Gdy AI widzi zdalne narzędzie, pojawia się ono jako
mcp__<server_id>__<tool_name>, więc dwa serwery z pokrywającymi się nazwami narzędzi nie kolidują.
Jak agent korzysta z narzędzi
Podczas badania agent AI otrzymuje sumę wbudowanych narzędzi Kit i narzędzi z serwerów, z których korzysta kampania: zaznaczonych, a jeśli nic nie zaznaczysz, wszystkich aktywnych. Wybiera narzędzie do wywołania na podstawie opisu narzędzia, więc jakość opisów zdalnych narzędzi bezpośrednio wpływa na częstotliwość ich wykorzystania. Opisuj precyzyjnie, co każde narzędzie robi i jakich argumentów oczekuje.
Wywołania narzędzi są zapisywane przy wiadomości i widoczne podczas przeglądania szkiców. Możesz zobaczyć dokładnie, co agent wywołał, z jakimi argumentami i co otrzymał w odpowiedzi.
Model bezpieczeństwa
Zdalne serwery MCP działają na twojej infrastrukturze i z twoim uwierzytelnianiem. Kit działa wyłącznie jako klient:
- Kit łączy się z serwerem podczas pobierania listy narzędzi oraz wywoływania narzędzi przez agenta w skonfigurowanej kampanii. Nie udostępnia serwera bezpośrednio leadom.
- Token bearer jest szyfrowany w spoczynku i nigdy nie jest udostępniany modelowi AI.
- Kit weryfikuje, czy nazwa hosta punktu końcowego rozwiązuje się do publicznego adresu IP przed każdym żądaniem, chroniąc przed SSRF.
- Argumenty narzędzi są przekazywane w postaci przygotowanej przez AI, więc walidacja danych wejściowych po stronie serwera to twoja odpowiedzialność.
Reguły określające, kto i kiedy może wywołać narzędzie, egzekwuj na serwerze MCP.
Rozwiązywanie problemów
| Objaw | Prawdopodobna przyczyna | Co zrobić |
|---|---|---|
| Serwer utknął w stanie Odkrywanie… | Zadanie odkrywania narzędzi jeszcze nie zostało uruchomione | Poczekaj minutę, odśwież stronę integracji |
| Serwer w stanie Niepowodzenie z HTTP 401 | Brak tokena bearer lub nieprawidłowy token | Edytuj połączenie i zaktualizuj token |
| Serwer w stanie Niepowodzenie z „Hostname resolves to private IP” | Punkt końcowy wskazuje na sieć prywatną | Udostępnij serwer przez publiczną nazwę hosta |
| Aktywny serwer zgłasza 0 narzędzi | Serwer zwrócił pustą listę tools/list
|
Upewnij się, że serwer rejestruje narzędzia i ponów odkrywanie |
| Serwer jest Aktywny, ale AI nigdy nie wywołuje jego narzędzi | Opisy narzędzi są zbyt ogólnikowe | Przepisz opisy, aby jasno wskazywały, co każde narzędzie robi |
| Serwer Wyłączony automatycznie | Trzy kolejne niepowodzenia | Napraw podstawowy problem, a następnie ponownie włącz serwer |
W skrócie
- Twój serwer MCP jest dostępny przez publiczne HTTPS
- Połączenie zostało utworzone w Integrations > MCP Servers
- Serwer jest w stanie Aktywny z co najmniej jednym narzędziem
- W kampanii ten serwer jest zaznaczony albo nie jest zaznaczony żaden (wtedy działają wszystkie aktywne)
- Opisy narzędzi są wystarczająco konkretne, aby AI wiedziało, kiedy je wywoływać
Co dalej
- MCP Tools Reference: zobacz wbudowane narzędzia, które agent AI ma domyślnie
- Badania AI i baza wiedzy: jak badania i baza wiedzy współpracują z narzędziami MCP