Typy serwerów MCP: STDIO, SSE i OAuth
Na tej stronie
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.
| Kryterium | STDIO (Lokalny) | SSE / Streamable HTTP (Zdalny) | OAuth (Zdalny + Auth) |
|---|---|---|---|
| Transport | stdin / stdout | HTTP (opcjonalne strumieniowanie) | HTTP + przepływ OAuth 2.0 |
| Lokalizacja | Ta sama maszyna | Zdalny serwer | Zdalny serwer |
| Uwierzytelnianie | Brak (ta sama maszyna) | Brak lub token | Pełne OAuth 2.0 |
| Kompatybilni klienci | IDE, lokalne SDK | Wszystkie (Vibe, SDK, IDE) | Wszystkie (Vibe, SDK, IDE) |
| Przypadki użycia | Pliki lokalne, CLI, dev | Publiczne API, skrobanie | GitHub, Gmail, Linear |
| Trwałe połączenie | Tak (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