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

Konfiguracja serwerów MCP w Vibe

Lekcja 8 z 16 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Czym jest MCP?
  2. Dwa typy transportu
  3. Przykład praktyczny: Dodawanie pobierania ze stron WWW
  4. Filtrowanie narzędzi MCP
  5. Zaawansowana konfiguracja z uwierzytelnianiem
  6. Popularne serwery MCP
  7. Bezpieczeństwo serwerów MCP
  8. Kluczowe wnioski

Lekcja zaktualizowana 2 listopada 2026 r. na podstawie strony MCP servers w dokumentacji Vibe Code: uwierzytelnianie korzysta teraz z tabeli [mcp_servers.auth] (api_key_env lub OAuth); składnia ${VARIABLE} w nagłówkach, wcześniej prezentowana, nie jest udokumentowana dla serwerów MCP. Dodano podkomendy vibe mcp add oraz /mcp. Źródło: MCP servers.

Czym jest MCP?

Model Context Protocol (MCP) to otwarty standard pozwalający agentom AI komunikować się z zewnętrznymi serwerami narzędzi. Zamiast kodować każdą integrację na sztywno, MCP zapewnia ujednolicony protokół: serwer udostępnia narzędzia, a agent automatycznie je wykrywa i wykorzystuje. Nie piszesz żadnego kodu łączącego. Wystarczy, że zadeklarujesz adres lub polecenie, a narzędzia pojawią się w Twojej następnej sesji.

Vibe posiada natywne wsparcie dla MCP, co oznacza, że możesz rozszerzyć jego możliwości daleko poza wbudowane narzędzia – od czytania stron internetowych, przez odpytywanie baz danych, aż po wywoływanie wewnętrznych API firmowych.

Dwa typy transportu

Zanim cokolwiek skonfigurujesz, musisz wybrać transport – kanał, którego Vibe używa do komunikacji z serwerem.

W przypadku transportu HTTP, serwer MCP działa jako standardowa usługa sieciowa, a Vibe wysyła żądania, aby odkryć i wywołać narzędzia:

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token_here" }

Użyj tego trybu, gdy serwer MCP działa ciągle – np. usługa bazodanowa, wewnętrzne API lub narzędzie sieciowe udostępnione całemu zespołowi.

W przypadku transportu STDIO, serwer jest lokalnym programem, który Vibe uruchamia samodzielnie, komunikując się przez stdin/stdout:

[[mcp_servers]]
name = "fetch_server"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]

Jest to najprostszy tryb konfiguracji, ponieważ Vibe zarządza cyklem życia serwera: uruchamia go na początku sesji i zatrzymuje na końcu. Żadnego ręcznego startu, żadnego monitorowania.

Istnieje również wariant HTTP o nazwie streamable-http, zaprojektowany dla długotrwałych połączeń ze strumieniowaniem:

[[mcp_servers]]
name = "my_stream_server"
transport = "streamable-http"
url = "http://localhost:9000/mcp"

Przykład praktyczny: Dodawanie pobierania ze stron WWW

Jednym z najbardziej użytecznych serwerów MCP jest mcp-server-fetch, który pozwala Vibe czytać zawartość stron internetowych. Konfiguracja zajmuje tylko trzy linie:

# ~/.vibe/config.toml

[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]

Wpływ na Twój codzienny przepływ pracy jest natychmiastowy. Możesz teraz formułować żądania zakładające zewnętrzne odczyty:

Przeczytaj dokumentację FastAPI pod adresem fastapi.tiangolo.com i podsumuj dla mnie endpointy bezpieczeństwa

Agent automatycznie wywoła narzędzie fetch z serwera MCP, aby pobrać stronę, a następnie przeanalizuje jej zawartość. Nie musisz otwierać przeglądarki ani wklejać fragmentów dokumentacji do terminala.

Filtrowanie narzędzi MCP

Ta wygoda niesie ze sobą kompromis. Każdy dodany serwer wnosi własny zestaw narzędzi, a przy trzech lub czterech aktywnych serwerach katalog staje się zaśmiecony. Filtrowanie pozwala zachować tylko to, co istotne:

# Włącz tylko narzędzia z konkretnego serwera
enabled_tools = ["fetch_*"]

# Wyłącz wszystkie narzędzia MCP oprócz tych jawnie włączonych
disabled_tools = ["mcp_*"]

Filtrowanie z użyciem wieloznaczników realizuje dwa cele jednocześnie. Wzmacnia bezpieczeństwo, ograniczając to, co agent może zrobić, i zapobiega przeciążeniu kontekstu modelu: zbyt długa lista narzędzi zużywa cenny kontekst i obniża jakość decyzji agenta.

Zaawansowana konfiguracja z uwierzytelnianiem

Przedsiębiorcze serwery MCP prawie zawsze wymagają uwierzytelniania. W przypadku tokenu, tabela [mcp_servers.auth] w trybie static odczytuje klucz ze zmiennej środowiskowej, której nazwę podajesz, a następnie wstawia go do wybranego nagłówka:

[[mcp_servers]]
name = "internal_api"
transport = "http"
url = "https://mcp.your-company.com"

[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN"        # nazwa zmiennej, a nie sam token
api_key_header = "Authorization"     # domyślna wartość
api_key_format = "Bearer {token}"    # domyślna wartość

Dla serwera oferującego logowanie OAuth, takiego jak Linear, ustaw type = "oauth" i zaloguj się podczas sesji za pomocą /mcp login <name>: Vibe otworzy Twoją przeglądarkę i zapisze tokeny w systemowym pęku kluczy (keychain), nigdy w pliku config.toml. Polecenie vibe mcp add obsługuje to wszystko z poziomu terminala: vibe mcp add linear --url https://mcp.linear.app/mcp dodaje serwer i uruchamia proces logowania.

Korzyść jest prosta: możesz wersjonować i udostępniać plik config.toml swojemu zespołowi bez hard-codowania jakichkolwiek sekretów, ponieważ każdy programista dostarcza własny token poprzez swoje środowisko.

Popularne serwery MCP

Kilka gotowych do użycia serwerów pokrywa najczęstsze potrzeby i wszystkie deklaruje się je w ten sam sposób w pliku config.toml. mcp-server-fetch obsługuje pobieranie stron WWW i API; mcp-server-filesystem rozszerza operacje na plikach poza wbudowane narzędzia; mcp-server-git wnosi zaawansowaną integrację z Gitem z obsługą diff, blame i log; mcp-server-sqlite oraz mcp-server-postgres umożliwiają odpytywanie baz danych SQLite i PostgreSQL. Agent, który potrafi czytać zarówno schemat bazy danych, jak i kod, który z niej korzysta, wykrywa niespójności, których samo czytanie plików nigdy by nie ujawniło.

Podczas sesji /mcp wyświetla listę serwerów, a /mcp <name> listuje ich narzędzia; /mcp status pokazuje stan każdego z nich. Agent informuje również, z których narzędzi korzysta w swoich odpowiedziach, co pozostaje najlepszym sposobem na weryfikację, czy serwer faktycznie działa.

Bezpieczeństwo serwerów MCP

Serwer MCP działa z Twoimi uprawnieniami i widzi to, co mu udostępnisz: dodawaj tylko zaufane serwery, ponieważ złośliwy serwer mógłby ujawnić dane z Twojej bazy kodu. Następnie ogranicz uprawnienia za pomocą enabled_tools, zamiast domyślnie przyznawać pełny dostęp.

Dwa nawyki dopełniają tę rutynę higieniczną. Sprawdź swoje nagłówki: żaden token nie powinien pojawiać się jako zwykły tekst w config.toml; dokładnie do tego służy api_key_env. A w przypadku narzędzi lokalnych preferuj transport STDIO, który jest bezpieczniejszy niż serwer HTTP wystawiony na sieć, choćby dlatego, że nie otwiera żadnych portów.

Kluczowe wnioski

  • MCP pozwala dodawać zewnętrzne narzędzia do Vibe poprzez standaryzowany protokół
  • Dwa główne typy transportu: HTTP (trwały serwer) i STDIO (lokalny proces)
  • Filtrowanie narzędzi (enabled_tools, disabled_tools) kontroluje to, z czego agent może korzystać
  • Zmienne środowiskowe w nagłówkach chronią sekrety
  • Dodawaj tylko zaufane serwery MCP i ograniczaj ich uprawnienia