Serwery MCP
Podłącz zewnętrzne narzędzia i usługi do AI SmartTalk za pomocą Model Context Protocol (MCP). MCP to otwarty standard, który pozwala asystentom AI na interakcję z zewnętrznymi systemami poprzez jednolity interfejs.
Przegląd
Integracja serwera MCP umożliwia:
- Podłączenie dowolnego serwera zgodnego z MCP
- Udostępnienie narzędzi do wywołania przez AI podczas rozmów
- Dostęp do zewnętrznych danych poprzez ustandaryzowane protokoły
- Rozszerzenie możliwości bez potrzeby tworzenia niestandardowych rozwiązań
Czym jest MCP? Model Context Protocol to otwarty standard (opracowany przez Anthropic), który pozwala systemom AI na bezpieczne łączenie się z zewnętrznymi źródłami danych i narzędziami.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Aktywne konto AI SmartTalk
- Dostęp do serwera MCP (samo-hostowanego lub zewnętrznego)
- URL serwera MCP oraz dane uwierzytelniające
- Zrozumienie, które narzędzia są udostępniane przez serwer MCP
Jak działa MCP
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Zapytanie │────▶│ AI SmartTalk │────▶│ Serwer MCP │
│ Użytkownika │ │ (Agent AI) │ │ │
│ "Sprawdź moje CRM" │ │ │ │ - narzędzia CRM│
│ │◀────│ Przetwarza zapytanie │◀────│ - zapytania DB │
│ Odpowiedź │ │ Wywołuje narzędzia MCP │ │ - dostęp do plików │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Użytkownik zadaje pytanie, które wymaga danych zewnętrznych
- AI SmartTalk rozpoznaje, że potrzebuje narzędzia MCP
- Serwer MCP jest wywoływany z odpowiednim narzędziem
- Odpowiedź jest zwracana i AI formułuje odpowiedź
Krok po Kroku Konfiguracja
Krok 1: Uzyskaj dostęp do integracji MCP
- Zaloguj się na swoje konto AI SmartTalk
- Przejdź do Ustawienia → Integracje
- Znajdź Serwery MCP i kliknij Dodaj serwer
Krok 2: Skonfiguruj serwer MCP
Wprowadź szczegóły swojego serwera MCP:
| Pole | Opis |
|---|---|
| Nazwa serwera | Przyjazna nazwa dla tego połączenia |
| URL serwera | Punkt końcowy serwera MCP (np. https://mcp.example.com) |
| Transport | SSE (Wydarzenia wysyłane przez serwer) lub WebSocket |
| Uwierzytelnianie | Klucz API, OAuth lub brak |
Krok 3: Przetestuj połączenie
- Kliknij Testuj połączenie
- AI SmartTalk wyśle zapytanie do serwera MCP
- Sprawdź, czy status pokazuje Połączono
Krok 4: Odkryj dostępne narzędzia
Po nawiązaniu połączenia AI SmartTalk pobiera listę dostępnych narzędzi:
| Narzędzie | Opis | Parametry |
|---|---|---|
search_crm | Wyszukaj rekordy klientów | query, limit |
create_ticket | Utwórz zgłoszenie wsparcia | title, description |
get_weather | Pobierz dane pogodowe | location |
Krok 5: Włącz narzędzia dla swojego AI
- Przejrzyj odkryte narzędzia
- Włącz narzędzia, które chcesz, aby Twoje AI używało
- Skonfiguruj wszelkie ustawienia specyficzne dla narzędzia
- Zapisz swoją konfigurację
Integracja SmartFlow
Narzędzia MCP mogą być również używane w przepływach SmartFlow:
Używanie narzędzi MCP w przepływach
- W SmartFlow znajdź MCP w bibliotece akcji
- Przeciągnij akcję MCP do swojego przepływu
- Wybierz Serwer MCP i Narzędzie
- Mapuj parametry wejściowe z kontekstu swojego przepływu
- Użyj odpowiedzi narzędzia w kolejnych akcjach
Przykład: Przepływ wyszukiwania klienta
Trigger: Usługa czatu (gdy użytkownik pyta o konto)
Actions:
1. Wywołanie narzędzia MCP:
Serwer: CRM firmy
Narzędzie: search_crm
Parametry:
query: {{user_email}}
2. Odpowiedź AI:
Kontekst: Wynik wyszukiwania CRM
Podpowiedź: Odpowiedz na pytanie użytkownika dotyczące konta
Przykłady użycia
Zarządzanie relacjami z klientami
Połącz swoje CRM przez MCP:
- "Wyszukaj klienta Johna Smitha"
- "Jaki jest status konta #12345?"
- "Ile mamy otwartych zgłoszeń wsparcia?"
Narzędzia wewnętrzne
Uzyskaj dostęp do systemów firmy:
- "Sprawdź stan magazynu dla produktu SKU-123"
- "Co jest zaplanowane na jutro?"
- "Wyszukaj nasze wewnętrzne wiki dla dokumentów dotyczących onboardingu"
Zewnętrzne źródła danych
Pobierz dane na żywo:
- "Jaka jest aktualna pogoda w Paryżu?"
- "Pobierz najnowszą cenę akcji dla AAPL"
- "Sprawdź status lotu UA123"
Narzędzia deweloperskie
Dla zespołów technicznych:
- "Jaki jest status najnowszej kompilacji?"
- "Wyszukaj nasze problemy na GitHubie dotyczące błędów uwierzytelniania"
- "Sprawdź stan serwerów produkcyjnych"
Przykłady serwerów MCP
Popularne serwery MCP
| Serwer | Cel | Link |
|---|---|---|
| Filesystem | Odczyt/zapis lokalnych plików | Wbudowany serwer referencyjny |
| PostgreSQL | Zapytania do baz danych | Serwer społecznościowy |
| GitHub | Zarządzanie repozytoriami | Serwer społecznościowy |
| Slack | Integracja wiadomości | Serwer społecznościowy |
Znajdź więcej: Odwiedź MCP Server Registry w celu uzyskania informacji o serwerach społecznościowych.
Samodzielne hostowanie serwerów MCP
Możesz stworzyć niestandardowe serwery MCP dla:
- Własnych systemów wewnętrznych
- Niestandardowej logiki biznesowej
- Bezpiecznego/prywatnego dostępu do danych
Rozważania dotyczące bezpieczeństwa
Uwierzytelnianie
| Metoda | Przypadek użycia |
|---|---|
| API Key | Prosta autoryzacja serwer-serwer |
| OAuth 2.0 | Dostęp delegowany przez użytkownika |
| mTLS | Środowiska o wysokim poziomie bezpieczeństwa |
Prywatność danych
- Żądania MCP mogą zawierać dane użytkowników
- Upewnij się, że twój serwer MCP obsługuje dane w odpowiedni sposób
- Rozważ wymagania dotyczące miejsca przechowywania danych
- Rejestruj i audytuj wywołania narzędzi MCP
Bezpieczeństwo sieci
- Używaj HTTPS dla wszystkich połączeń MCP
- Ogranicz dostęp do serwera MCP tylko do adresów IP AI SmartTalk
- Wprowadź ograniczenia prędkości na swoim serwerze MCP
Rozwiązywanie problemów
Problemy z połączeniem
| Problem | Rozwiązanie |
|---|---|
| "Połączenie odrzucone" | Sprawdź adres URL serwera i port |
| "Uwierzytelnienie nie powiodło się" | Zweryfikuj dane uwierzytelniające/API key |
| "Przekroczono czas oczekiwania" | Sprawdź łączność sieciową, zasady zapory |
| "Błąd SSL" | Upewnij się, że certyfikat SSL jest ważny |
Problemy z odkrywaniem narzędzi
| Problem | Rozwiązanie |
|---|---|
| "Nie znaleziono narzędzi" | Zweryfikuj, czy serwer MCP poprawnie udostępnia narzędzia |
| "Narzędzie niedostępne" | Sprawdź, czy narzędzie jest włączone po stronie serwera |
| "Niezgodność schematu" | Zaktualizuj AI SmartTalk, aby odświeżyć schematy narzędzi |
Problemy z działaniem
| Problem | Rozwiązanie |
|---|---|
| "Wywołanie narzędzia nie powiodło się" | Sprawdź logi serwera w poszukiwaniu błędów |
| "Nieoczekiwana odpowiedź" | Zweryfikuj, czy narzędzie zwraca oczekiwany format |
| "Ograniczenie prędkości" | Wprowadź mechanizm opóźnienia lub zwiększ limity |
Zarządzanie serwerami MCP
| Akcja | Jak |
|---|---|
| Dodaj serwer | Ustawienia → Integracje → MCP → Dodaj serwer |
| Edytuj serwer | Kliknij nazwę serwera, aby zmodyfikować |
| Wyłącz serwer | Wyłącz bez usuwania |
| Usuń serwer | Przycisk usunięcia (narzędzia stają się niedostępne) |
| Odśwież narzędzia | Kliknij Odśwież, aby ponownie odkryć narzędzia |
Najlepsze praktyki
- Zacznij prosto: Połącz jeden serwer, przetestuj dokładnie, a następnie rozszerzaj
- Dokumentuj narzędzia: Prowadź wewnętrzną dokumentację na temat działania każdego narzędzia
- Monitoruj użycie: Śledź, które narzędzia są wywoływane i ich wydajność
- Obsługuj błędy w sposób elegancki: AI powinno elegancko obsługiwać awarie narzędzi
- Zabezpiecz dane uwierzytelniające: Używaj zmiennych środowiskowych, a nie zakodowanych na stałe kluczy
- Wersjonuj swoje serwery: Serwery MCP powinny być wersjonowane dla stabilności