Instrukcja obsługi What credential and transport types can I use with MCP Assistant and AI platforms?

Wyjaśnienie​

Typy poświadczeń​

Poświadczenie to metoda uwierzytelniania, która umożliwia klientowi MCP bezpieczne łączenie się z serwerem MCP. QNAP MCP Assistant obsługuje dwa typy poświadczeń:

• Token: Identyfikator w postaci ciągu znaków przekazywany w nagłówkach HTTP/HTTPS. Pozwala to na identyfikację klienta MCP bez konieczności podawania nazwy użytkownika i hasła. Metoda ta jest lekka i łatwa w użyciu, co czyni ją odpowiednią dla większości integracji ogólnego przeznaczenia.
• Klucz: Pakiet oparty na certyfikacie, używany przez HTTPS do wzajemnej weryfikacji. Wymaga to pobrania pakietu poświadczeń z serwera MCP, który zawiera plik wykonywalny qmcp. Podczas uwierzytelniania host MCP używa tego pliku wykonywalnego oraz powiązanego z nim certyfikatu do nawiązania zaufanego połączenia z serwerem MCP. Metoda ta zapewnia silniejszą weryfikację tożsamości i jest zalecana w środowiskach wymagających wysokiego poziomu bezpieczeństwa lub korporacyjnych.

Poświadczenia są niezbędne do autoryzacji dostępu do narzędzi MCP oraz do zapewnienia bezpiecznej komunikacji między komponentami.

Typy transportu​

Typ transportu określa sposób przesyłania danych między klientem MCP a serwerem MCP. QNAP MCP Assistant obsługuje trzy następujące typy transportu:

• STDIO: Podstawowa metoda transportu wykorzystująca standardowe strumienie wejścia i wyjścia. Jest ona zazwyczaj używana do komunikacji lokalnej lub na etapie testów. Nie wymaga komunikacji sieciowej i jest przeznaczona głównie do scenariuszy, w których klient i serwer MCP działają na tym samym hoście.
• SSE (Server-Sent Events): Lekka metoda komunikacji jednokierunkowej, w której serwer wysyła aktualizacje do klienta przez połączenie HTTP. SSE jest idealne do monitorowania w czasie rzeczywistym lub przesyłania aktualizacji statusu, umożliwiając klientom odbieranie ciągłych strumieni danych bez konieczności wielokrotnego odpytywania. Najlepiej sprawdza się w scenariuszach wymagających niskiej latencji i komunikacji sterowanej zdarzeniami.
  • W przypadku korzystania z SSE adres URL musi kończyć się na /sse, na przykład: http://<NAS_IP>:8442/sse
• Streamable HTTP:Dwukierunkowy tryb transportu oparty na HTTP, który umożliwia strumieniowe przesyłanie zarówno treści żądań, jak i odpowiedzi. Metoda ta jest odpowiednia do obsługi dużych ilości danych lub długotrwałych operacji, takich jak przesyłanie plików lub wykonywanie poleceń w czasie rzeczywistym. Zapewnia dobrą równowagę między elastycznością a wydajnością w nowoczesnych aplikacjach sieciowych.
  • W przypadku korzystania ze Streamable HTTP adres URL musi kończyć się na /mcp, na przykład: http://<NAS_IP>:8442/mcp

uwaga

• Klucz jest przeznaczony dla typu transportu STDIO, natomiast Token jest przeznaczony dla typów transportu SSE i Streamable HTTP.
• Różne hosty MCP obsługują różne typy. Aby ustalić, który typ transportu ma zastosowanie, należy zapoznać się z dokumentacją danego hosta MCP.

Typy poświadczeń i transportu obsługiwane przez platformy AI​

Poniżej znajduje się zestawienie typów poświadczeń i transportu obsługiwanych przez poszczególne platformy AI w przypadku QNAP MCP Assistant:

Platforma AI	Obsługiwane typy poświadczeń	Obsługiwane typy transportu
Claude Desktop	Klucz	STDIO
Cline	Klucz	STDIO
Copilot	Klucz, Token	STDIO, SSE, Streamable HTTP

uwaga

• Typy poświadczeń obsługiwane przez poszczególne platformy AI mogą ulec zmianie i być aktualizowane w czasie.
• Ze względu na ograniczenia samych platform AI, platformy takie jak ChatGPT, Deepseek i Grok nie obsługują konfiguracji MCP.