Serwery MCP
Połącz zewnętrzne narzędzia i usługi z AI SmartTalk za pomocą Model Context Protocol (MCP). MCP to otwarty standard, który pozwala Twojemu asystentowi AI na interakcję z zewnętrznymi systemami za pośrednictwem jednolitego interfejsu.
Przegląd
Integracja serwera MCP umożliwia Ci:
- Jednoczesne połączenie wielu serwerów MCP
- Udostępnienie zewnętrznych narzędzi do wywołania przez Twoje AI podczas rozmów
- Uwierzytelnienie za pomocą niestandardowych nagłówków HTTP (klucze API, tokeny itp.)
- Testowanie połączeń przed uruchomieniem
- Rozszerzanie możliwości bez potrzeby tworzenia niestandardowego rozwiązania
Czym jest MCP? Model Context Protocol to otwarty standard (opracowany przez Anthropic), który umożliwia systemom AI bezpieczne łączenie się z zewnętrznymi źródłami danych i narzędziami. Dowiedz się więcej na modelcontextprotocol.io.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Aktywne konto AI SmartTalk
- Dostęp do jednego lub więcej serwerów zgodnych z MCP
- URL serwera dla każdego serwera MCP
- Wszelkie wymagane dane uwierzytelniające (klucze API, tokeny)
Jak działa MCP
- Użytkownik zadaje pytanie, które wymaga danych zewnętrznych
- AI SmartTalk rozpoznaje, że potrzebne jest narzędzie MCP
- Wywoływany jest odpowiedni serwer MCP z odpowiednim narzędziem
- Odpowiedź jest zwracana i AI formułuje odpowiedź w języku naturalnym
AI SmartTalk obsługuje wiele serwerów MCP jednocześnie. Narzędzia z różnych serwerów są automatycznie przestrzenne nazw, aby zapobiec konfliktom.
Instrukcja krok po kroku
Krok 1: Uzyskaj dostęp do integracji MCP
- Zaloguj się na swoje konto AI SmartTalk
- Przejdź do Administracja → Moi Asystenci → [Nazwa Twojego Asystenta]
- Kliknij na Łączniki w lewym pasku bocznym
- Zlokalizuj Serwery MCP i kliknij na nie
Krok 2: Dodaj serwer MCP
Kliknij Dodaj serwer, aby otworzyć formularz konfiguracji serwera. Wypełnij następujące pola:
| Pole | Wymagane | Opis |
|---|---|---|
| Nazwa serwera | Tak | Przyjazna nazwa do identyfikacji tego serwera (np. "CRM firmy", "Wewnętrzna Wiki") |
| URL serwera | Tak | URL punktu końcowego serwera MCP (np. https://mcp.example.com) |
| Nagłówki HTTP | Nie | Niestandardowe nagłówki do uwierzytelnienia lub innych wymagań |
AI SmartTalk automatycznie dodaje /mcp do Twojego URL, jeśli nie kończy się na nim. Na przykład, https://example.com staje się https://example.com/mcp. Jeśli Twój serwer używa innej ścieżki punktu końcowego, uwzględnij ją w URL (np. https://example.com/api/mcp).
Krok 3: Dodaj nagłówki uwierzytelniające (opcjonalnie)
Jeśli Twój serwer MCP wymaga uwierzytelnienia, kliknij Dodaj nagłówki, aby skonfigurować niestandardowe nagłówki HTTP:
| Typowy nagłówek | Zastosowanie |
|---|---|
Authorization | Tokeny Bearer (np. Bearer sk-xxx...) |
X-API-Key | Uwierzytelnienie za pomocą klucza API |
X-Auth-Token | Niestandardowe uwierzytelnienie tokenem |
Dla każdego nagłówka podaj:
- Klucz: Nazwa nagłówka (wybierz z typowych nagłówków lub wpisz niestandardowy)
- Wartość: Wartość nagłówka (wrażliwe wartości są automatycznie maskowane w interfejsie)
Możesz dodać wiele nagłówków dla serwera. Nagłówki zawierające "secret", "password", "token" lub "auth" w nazwie klucza są automatycznie ukrywane dla bezpieczeństwa.
Krok 4: Przetestuj połączenie
Przed zapisaniem kliknij Testuj połączenie, aby zweryfikować, czy Twój serwer jest osiągalny:
- AI SmartTalk wysyła żądanie inicjalizacji JSON-RPC do Twojego serwera
- Test sprawdza wiele punktów końcowych w kolejności:
/mcp,/health, a następnie URL bazowy - Wyniki pokazują status połączenia, czas odpowiedzi i informacje o serwerze
| Wynik testu | Znaczenie |
|---|---|
| Połączono | Serwer odpowiedział pomyślnie z protokołem MCP |
| Uwierzytelnienie nie powiodło się | Sprawdź swój klucz API lub token w nagłówkach |
| Serwer nie znaleziony | Zweryfikuj, czy URL jest poprawny |
| Połączenie odrzucone | Serwer może być wyłączony lub zapora blokuje dostęp |
| Przekroczenie limitu czasu | Serwer zajął zbyt dużo czasu na odpowiedź (limit 10s) |
| Błąd SSL | Sprawdź, czy serwer ma ważny certyfikat SSL |
Krok 5: Zapisz konfigurację
- Kliknij Dodaj, aby dodać serwer do swojej listy
- Powtórz kroki 2-4, aby dodać więcej serwerów MCP w razie potrzeby
- Kliknij Zapisz integrację, aby aktywować wszystkie skonfigurowane serwery
Obsługa wielu serwerów
AI SmartTalk obsługuje jednoczesne łączenie wielu serwerów MCP. Umożliwia to łączenie narzędzi z różnych źródeł:
Przestrzenne nazewnictwo narzędzi
Narzędzia z każdego serwera są automatycznie prefiksowane nazwą serwera, aby zapobiec konfliktom nazw. Na przykład:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Oznacza to, że możesz bezpiecznie łączyć serwery, które udostępniają narzędzia o tej samej nazwie.
Zarządzanie wieloma serwerami
Panel integracji pokazuje wszystkie skonfigurowane serwery z:
- Nazwą serwera i URL dla łatwej identyfikacji
- Licznikiem nagłówków jeśli skonfigurowano niestandardowe nagłówki
- Wskaźnikiem statusu (Skonfigurowany / Niekompletny)
- Przyciskami akcji: Testuj połączenie, Edytuj lub Usuń poszczególne serwery
Odkrywanie narzędzi
Gdy Twoje serwery MCP są połączone, AI SmartTalk automatycznie odkrywa wszystkie dostępne narzędzia udostępnione przez każdy serwer. Te narzędzia stają się natychmiast dostępne dla Twojego asystenta AI.
Asystent AI:
- Zobaczy listę wszystkich dostępnych narzędzi ze wszystkich połączonych serwerów
- Automatycznie wybierze odpowiednie narzędzie na podstawie zapytań użytkownika
- Wywoła narzędzie z odpowiednimi parametrami
- Przetworzy odpowiedź i dostarczy odpowiedź w języku naturalnym
Nie musisz ręcznie konfigurować ani włączać poszczególnych narzędzi. Wszystkie narzędzia udostępnione przez połączony serwer MCP są automatycznie dostępne dla Twojego asystenta AI.
Przykłady użycia
Zarządzanie relacjami z klientami
Połącz swoje CRM za pomocą MCP:
- "Znajdź 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?"
- "Przeszukaj naszą wewnętrzną wiki w poszukiwaniu dokumentów onboardingowych"
Zewnętrzne źródła danych
Pobierz dane na żywo:
- "Jaka jest aktualna pogoda w Paryżu?"
- "Podaj najnowszą cenę akcji AAPL"
- "Sprawdź status lotu UA123"
Narzędzia deweloperskie
Dla zespołów technicznych:
- "Jaki jest status najnowszej kompilacji?"
- "Przeszukaj nasze problemy na GitHubie w poszukiwaniu błędów uwierzytelnienia"
- "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 |
| Google Drive | Zarządzanie plikami | Serwer społecznościowy |
| Brave Search | Wyszukiwanie w sieci | Serwer społecznościowy |
Znajdź więcej: Odwiedź Rejestr serwerów MCP w celu uzyskania rosnącej listy serwerów MCP społeczności.
Samodzielne hostowanie serwerów MCP
Możesz stworzyć niestandardowe serwery MCP dla:
- Własnych systemów wewnętrznych
- Niestandardowej logiki biznesowej
- Bezpiecznego lub prywatnego dostępu do danych
Użyj dowolnego SDK MCP (TypeScript, Python), aby zbudować własny serwer.
Rozważania dotyczące bezpieczeństwa
Uwierzytelnianie
Skonfiguruj uwierzytelnianie za pomocą Nagłówków HTTP w konfiguracji serwera:
| Metoda | Przykład nagłówka |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Prywatność danych
- Żądania MCP mogą zawierać dane rozmów użytkowników
- Upewnij się, że twój serwer MCP obsługuje dane zgodnie z twoimi politykami prywatności
- Rozważ wymagania dotyczące miejsca przechowywania danych
- AI SmartTalk maskuje wrażliwe wartości nagłówków w interfejsie użytkownika
Bezpieczeństwo sieci
- Używaj HTTPS dla wszystkich połączeń MCP
- Ogranicz dostęp do serwera MCP do zaufanych adresów IP
- Wprowadź ograniczenia liczby żądań na swoim serwerze MCP
- Upewnij się, że ważne certyfikaty SSL są dostępne
Rozwiązywanie problemów
Problemy z połączeniem
| Problem | Rozwiązanie |
|---|---|
| "Połączenie odrzucone" | Sprawdź adres URL serwera i port. Upewnij się, że serwer działa |
| "Uwierzytelnienie nie powiodło się" (401) | Zweryfikuj swój klucz API lub token w konfiguracji nagłówków |
| "Zabronione" (403) | Sprawdź, czy twoje dane uwierzytelniające mają wymagane uprawnienia |
| "Serwer nie znaleziony" (404) | Zweryfikuj adres URL. Aplikacja AI SmartTalk automatycznie dodaje /mcp |
| "Przekroczono czas oczekiwania" | Sprawdź łączność sieciową i zasady zapory. Test ma limit czasu 10 sekund |
| "Błąd SSL" | Upewnij się, że twój serwer MCP ma ważny certyfikat SSL |
| "Ograniczenie liczby żądań" (429) | Zbyt wiele żądań. Poczekaj i spróbuj ponownie lub zwiększ limity serwera |
Problemy z narzędziami
| Problem | Rozwiązanie |
|---|---|
| Narzędzia się nie pojawiają | Sprawdź, czy serwer MCP poprawnie udostępnia narzędzia. Spróbuj odświeżyć |
| Niewłaściwe narzędzia wywoływane | Sprawdź, czy nazwy serwerów są opisowe, aby pomóc AI w poprawnym wyborze |
| Wywołanie narzędzia nie powiodło się | Sprawdź logi serwera w poszukiwaniu błędów. Upewnij się, że narzędzie zwraca oczekiwany format |
Powszechne błędy
- Zapomnienie o
/mcp: AI SmartTalk dodaje to automatycznie, ale jeśli twój punkt końcowy jest inny, dołącz pełną ścieżkę - Niewłaściwy format nagłówka: Upewnij się, że nagłówki uwierzytelniające odpowiadają oczekiwaniom twojego serwera
- Duplikaty nazw serwerów: Każdy serwer musi mieć unikalną nazwę
Zarządzanie serwerami MCP
| Akcja | Jak |
|---|---|
| Dodaj serwer | Kliknij "Dodaj serwer", wypełnij szczegóły, przetestuj i zapisz |
| Edytuj serwer | Kliknij ikonę edycji na karcie serwera |
| Testuj połączenie | Kliknij ikonę testu na karcie serwera |
| Usuń serwer | Kliknij ikonę usunięcia na karcie serwera |
| Zapisz zmiany | Kliknij "Zapisz integrację", aby zachować wszystkie zmiany |
Najlepsze praktyki
- Używaj opisowych nazw serwerów: Pomaga to AI zrozumieć, który serwer zapytać (np. "CRM firmy" zamiast "Serwer 1")
- Testuj przed zapisaniem: Zawsze testuj połączenia, aby wcześnie wykryć problemy z konfiguracją
- Zacznij od jednego serwera: Zapoznaj się z jedną integracją, zanim dodasz więcej
- Zabezpiecz swoje dane uwierzytelniające: Używaj dedykowanych kluczy API dla AI SmartTalk, a nie osobistych tokenów
- Monitoruj swoje serwery: Śledź, które narzędzia są wywoływane i ich wydajność
- Utrzymuj serwery w aktualności: Upewnij się, że twoje serwery MCP przestrzegają najnowszej specyfikacji protokołu