◆ Sparround

Transport-lar: stdio və HTTP

MCP iki transport mexanizmi dəstəkləyir:

stdio — server sizin maşınınızda ayrıca proses kimi işləyir; mübadilə standart giriş/çıxış axınları üzərindən gedir. Şəbəkə yükü yoxdur, ona görə ən sürətli variantdır. Adətən bir client-ə xidmət edir.

Streamable HTTP — client-dən server-ə mesajlar HTTP POST ilə gedir; server axın (streaming) lazım olduqda Server-Sent Events istifadə edə bilər. Uzaq serverlər üçündür və standart HTTP autentifikasiyasını dəstəkləyir: bearer token, API açarı, xüsusi başlıqlar. Rəsmi tövsiyə — token almaq üçün OAuth işlətmək. Bir server bir çox client-ə xidmət edə bilər.

MeyarstdioStreamable HTTP
Server harada işləyirSizin maşınınızdaUzaqda (və ya lokal şəbəkədə)
SürətƏn sürətli — şəbəkə yoxdurŞəbəkə gecikməsi var
AutentifikasiyaMühit dəyişənləri iləOAuth, bearer token, başlıqlar
Client sayıAdətən birÇoxlu
Tipik istifadəLokal alətlər, faylsistem, öz skriptlərinizSaaS servisləri, komanda üçün mərkəzi server
bash
# stdio — a local process. Everything after `--` is the server command.
claude mcp add --transport stdio my-tools \
  --env API_TOKEN=$MY_TOKEN \
  -- node ./tools/mcp-server.js

# HTTP — a remote server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# HTTP with an authentication header
claude mcp add --transport http internal-api https://mcp.internal.company/mcp \
  --header "Authorization: Bearer $INTERNAL_TOKEN"

Qoşulma nümunələri. `--` ayırıcısı vacibdir: ondan əvvəlkilər Claude-un parametrləri, sonrakılar server-in işə salınma əmridir.

SSE transportu köhnəlmiş sayılır — yeni server-lər üçün http (Streamable HTTP) istifadə edilməlidir. Köhnə --transport sse qoşulmaları hələ işləyir, amma yeni inteqrasiyada seçilməməlidir.

Praktiki seçim qaydası:

  • stdio seçin — server yalnız sizin maşınınızda lazım olan şeylərə çıxış verirsə (lokal fayllar, adb, lokal verilənlər bazası) və ya siz onu özünüz yazmısınızsa və hələ sınayırsınızsa.
  • HTTP seçin — server komanda üçün mərkəzi xidmətdirsə, SaaS-a qoşulursa və ya autentifikasiya mərkəzləşdirilməlidirsə.

Öz daxili server-inizi yazarkən adətən stdio ilə başlayıb, komanda üçün lazım olanda HTTP-yə keçirsiniz.

📚 Mənbələr və sənədlər