Przejdź do głównej treści
Polski— Wybierz język
Menu

Typy serwerów MCP: STDIO, SSE i OAuth

Lekcja 2 z 14 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Dwa tryby transportu, dwie architektury
  2. STDIO: serwer działający na Twojej maszynie
  3. SSE i Streamable HTTP: serwery zdalne
  4. Trzy poziomy uwierzytelniania
  5. Jak podjąć decyzję w praktyce
  6. Kluczowe wnioski

Zaktualizowano 2 listopada 2026 r. — Le Chat to teraz Vibe. Od 28 maja 2026 r. Le Chat zmienił nazwę na Vibe (nadal pod adresem chat.mistral.ai): to pojedynczy agent do pracy i kodowania, który zachowuje Twoje konwersacje, ustawienia i subskrypcje. Legacyjne doświadczenie Le Chat pozostaje dostępne w trybie Chat; w trybie Work agenci stali się umiejętnościami (wywoływanymi za pomocą @), pamięć przekształciła się w bazę wiedzy, a głębokie wyszukiwanie stało się umiejętnością Deep Research. Plany noszą teraz nazwy Mistral Free, Pro, Team i Enterprise. W tej lekcji używamy nazwy Vibe; niektóre opisane tu menu mogły zmienić nazwy lub lokalizację.

Dwa tryby transportu, dwie architektury

Serwer MCP komunikuje się ze swoim klientem na dwa zasadniczo różne sposoby, w zależności od tego, czy działa na tej samej maszynie, czy na zdalnym hoście. To rozróżnienie nie jest szczegółem implementacyjnym: decyduje o tym, kto może korzystać z Twojego serwera, jak go wdrażasz i do jakich danych ma dostęp. Podjęcie tej decyzji na wczesnym etapie uchroni Cię przed przepisywaniem projektu w połowie pracy.

STDIO: serwer działający na Twojej maszynie

STDIO (Standard Input/Output) to transport lokalny. Serwer MCP działa na tej samej maszynie co klient, a komunikacja odbywa się przez standardowe strumienie systemu operacyjnego: stdin i stdout. Mechanizm jest bezpośredni: klient uruchamia proces serwera, wysyła żądania przez stdin, odczytuje odpowiedzi ze stdout i kończy proces po zakończeniu konwersacji. Żadnych portów, żadnych adresów URL, żadnych certyfikatów.

Ten transport jest naturalnym wyborem zawsze, gdy narzędzie musi ingerować w środowisko lokalne. Serwer, który odczytuje Twoje pliki, wywołuje git, steruje Dockerem lub inspekcjonuje bazę danych SQLite leżącą na Twoim dysku, ma sens tylko w trybie STDIO. Jest to również preferowany tryb dla integracji w edytorach takich jak VS Code czy Cursor oraz oczywisty towarzysz fazy deweloperskiej, kiedy chcesz restartować serwer co trzydzieści sekund.

from mcp import StdioServerParameters

server_params = StdioServerParameters(
    command="python",
    args=["my_mcp_server.py"],
    env=None,  # Opcjonalne zmienne środowiskowe
)

Kompromis jest jednak bezwzględny: serwer i klient muszą współistnieć. Nie możesz połączyć serwera STDIO z Mistral Vibe, ponieważ Vibe działa na infrastrukturze Mistral i nie ma możliwości uruchomienia procesu na Twojej maszynie.

SSE i Streamable HTTP: serwery zdalne

Aby wyjść poza lokalną maszynę, MCP wykorzystuje HTTP. Wystąpiły po sobie dwie wersje tego protokołu i warto wiedzieć, z którą masz do czynienia, czytając istniejący kod.

SSE (Server-Sent Events) był pierwszym zdalnym transportem tego protokołu. Pozwalał serwerowi strumieniować zdarzenia do klienta, który z kolei musiał wysyłać osobne żądania POST, aby odpowiedzieć serwerowi. Jego strukturalną wadą było wymaganie trwałego połączenia między obiema stronami, co komplikowało hosting serverless i skalowanie. Jest to obecnie przestarzałe rozwiązanie — SDK Mistral nadal udostępnia MCPClientSSE dla istniejących punktów końcowych /sse, ale nowych serwerów nie należy już budować w oparciu o ten standard.

Zastąpił go Streamable HTTP jako standardowy transport zdalny. Usuwa on wymóg trwałego połączenia: klient wysyła standardowe żądania HTTP, a serwer odpowiada poprzez strumieniowanie lub w jednym bloku, w zależności od potrzeb. W praktyce Twój zdalny serwer udostępnia punkt końcowy /mcp, do którego łączy się klient.

from mistralai.extra.mcp.streamable_http import (
    MCPClientStreamableHTTP,
    StreamableHTTPServerParams,
)

# Połączenie ze zdalnym serwerem MCP
server_url = "https://my-server.example.com/mcp"
mcp_client = MCPClientStreamableHTTP(
    params=StreamableHTTPServerParams(url=server_url, timeout=100)
)

Trzy poziomy uwierzytelniania

Transport mówi Ci, gdzie znajduje się serwer; uwierzytelnianie określa, kto może go wywołać. Są to niezależne kwestie, a protokół obsługuje trzy rozwiązania.

Najprostszym jest brak uwierzytelniania: każdy, kto zna adres URL, może korzystać z Twoich narzędzi. Wybór ten jest uzasadniony tylko w przypadku publicznych narzędzi nieprzetwarzających danych wrażliwych — np. konwertera jednostek, skrobacza sieciowego czy kalkulatora.

Kolejnym poziomem jest token, czyli klucz API. Generujesz token z określonymi uprawnieniami i przekazujesz go klientowi, który dołącza go do swoich żądań. GitHub dobrze ilustruje ten model: tworzysz Personal Access Token, zaznaczając tylko zakresy (scopes), których Twój agent faktycznie potrzebuje, i nic więcej.

Trzecim poziomem jest OAuth 2.0, czyli pełny przepływ z ekranem zgody. Użytkownik wyraźnie autoryzuje aplikację do działania w jego imieniu na koncie, a serwer otrzymuje token powiązany z tą osobą. Tak działają Gmail, Linear czy Google Calendar, gdy podłączasz je w Vibe — i jest to jedyny akceptowalny model, gdy serwer przetwarza dane osobowe wielu użytkowników.

KryteriumSTDIO (Lokalny)SSE / Streamable HTTP (Zdalny)OAuth (Zdalny + Auth)
Transportstdin / stdoutHTTP (opcjonalne strumieniowanie)HTTP + przepływ OAuth 2.0
LokalizacjaTa sama maszynaZdalny serwerZdalny serwer
UwierzytelnianieBrak (ta sama maszyna)Brak lub tokenPełne OAuth 2.0
Kompatybilni klienciIDE, lokalne SDKWszystkie (Vibe, SDK, IDE)Wszystkie (Vibe, SDK, IDE)
Przypadki użyciaPliki lokalne, CLI, devPubliczne API, skrobanieGitHub, Gmail, Linear
Trwałe połączenieTak (aktywny proces)Nie (Streamable HTTP)Nie (Streamable HTTP)

Jak podjąć decyzję w praktyce

Decyzja sprowadza się do dwóch pytań zadawanych po kolei. Czy serwer działa na tej samej maszynie co klient? Jeśli tak, wybierz STDIO. Jeśli nie, wybierz Streamable HTTP, z uwierzytelnianiem lub bez, w zależności od wrażliwości przetwarzanych danych.

Miej na uwadze ograniczenia po stronie klienta: Mistral Vibe i ogólnie hostowane chatboty konsumują wyłącznie serwery zdalne. IDE takie jak VS Code czy Cursor akceptują jednak oba tryby — stąd wygodny nawyk developowania w STDIO, a następnie przełączania się na HTTP, gdy przychodzi czas udostępnienia serwera.

Kluczowe wnioski

  • STDIO = serwer lokalny, ta sama maszyna, idealny do rozwoju
  • Streamable HTTP = serwer zdalny, obecny standard, zastępuje SSE
  • Trzy poziomy auth: brak, token, OAuth 2.0
  • Mistral Vibe obsługuje wyłącznie serwery zdalne
  • Wybór transportu zależy od architektury wdrożenia