Konfiguracja serwerów MCP w Vibe
Na tej stronie
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_envlub OAuth); składnia${VARIABLE}w nagłówkach, wcześniej prezentowana, nie jest udokumentowana dla serwerów MCP. Dodano podkomendyvibe mcp addoraz/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