Salt la conținutul principal
Română— Alege o limbă
Meniu

Configurarea serverelor MCP în Vibe

Lecția 8 din 16 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Ce este MCP?
  2. Cele două tipuri de transport
  3. Exemplu practic: Adăugarea preluării web
  4. Filtrarea instrumentelor MCP
  5. Configurare avansată cu autentificare
  6. Servere MCP populare
  7. Securitatea serverelor MCP
  8. Puncte cheie

Lecție actualizată la 2 noiembrie 2026 pe baza paginii MCP servers din documentația Vibe Code: autentificarea utilizează acum tabelul [mcp_servers.auth] (api_key_env sau OAuth); sintaxa ${VARIABLE} în anteturi, prezentată anterior, nu este documentată pentru serverele MCP. Au fost adăugate subcomenzile vibe mcp add și /mcp. Sursă: MCP servers.

Ce este MCP?

Model Context Protocol (MCP) este un standard deschis care permite agenților de inteligență artificială să comunice cu servere de instrumente externe. În loc să codificați manual fiecare integrare, MCP oferă un protocol unificat: serverul expune instrumente, iar agentul le descoperă și le utilizează automat. Nu scrieți niciun cod de legătură. Declarați doar o adresă sau o comandă, iar instrumentele apar în sesiunea următoare.

Vibe include suport nativ pentru MCP, ceea ce înseamnă că îi puteți extinde capacitățile mult dincolo de instrumentele încorporate – citirea unei pagini web, interogarea unei baze de date sau apelarea unui API intern al companiei.

Cele două tipuri de transport

Înainte de a configura orice, trebuie să decideți asupra transportului – canalul pe care Vibe îl utilizează pentru a comunica cu serverul.

Cu transportul HTTP, serverul MCP rulează ca un serviciu web standard, iar Vibe trimite cereri pentru a descoperi și a apela instrumente:

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

Utilizați acest mod atunci când serverul MCP rulează continuu – un serviciu de bază de date, un API intern sau un instrument web partajat de întreaga echipă.

Cu transportul STDIO, serverul este un program local pe care Vibe îl lansează singur, comunicând prin stdin/stdout:

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

Acesta este cel mai simplu mod de configurare, deoarece Vibe gestionează ciclul de viață al serverului: pornește serverul la începutul sesiunii și îl oprește la final. Fără pornire manuală, fără monitorizare necesară.

Există, de asemenea, o variantă HTTP numită streamable-http, concepută pentru conexiuni de lungă durată cu streaming:

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

Exemplu practic: Adăugarea preluării web

Unul dintre cele mai utile servere MCP este mcp-server-fetch, care permite Vibe să citească conținutul paginilor web. Sunt necesare doar trei linii de configurare:

# ~/.vibe/config.toml

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

Impactul asupra fluxului dumneavoastră de lucru zilnic este imediat. Puteți face acum cereri care presupun citire externă:

Citește documentația FastAPI de la fastapi.tiangolo.com și rezumă-mi endpoint-urile de securitate

Agentul apelează automat instrumentul fetch de la serverul MCP pentru a obține pagina, apoi îi analizează conținutul. Nu trebuie să deschideți un browser sau să lipiți fragmente de documentație în terminal.

Filtrarea instrumentelor MCP

Această comoditate vine cu un compromis. Fiecare server pe care îl adăugați aduce propriul set de instrumente, iar cu trei sau patru servere active, catalogul devine aglomerat. Filtrarea vă permite să păstrați doar ceea ce este relevant:

# Activează doar instrumentele de la un server specific
enabled_tools = ["fetch_*"]

# Dezactivează toate instrumentele MCP, exceptând cele activate explicit
disabled_tools = ["mcp_*"]

Filtrarea prin caractere wildcard servește două scopuri simultan. Întărește securitatea limitând ceea ce agentul are voie să facă și previne supraîncărcarea contextului modelului: o listă de instrumente prea lungă consumă context valoros și degradează calitatea deciziilor agentului.

Configurare avansată cu autentificare

Serverele MCP enterprise necesită aproape întotdeauna autentificare. Pentru un token, tabelul [mcp_servers.auth] în modul static citește cheia dintr-o variabilă de mediu al cărei nume îl furnizați, apoi o inserează în antetul dorit:

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

[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN"        # numele variabilei, nu tokenul însuși
api_key_header = "Authorization"     # valoare implicită
api_key_format = "Bearer {token}"    # valoare implicită

Pentru un server care oferă autentificare OAuth, cum ar fi Linear, setați type = "oauth" și autentificați-vă în timpul sesiunii cu /mcp login <name>: Vibe deschide browserul și stochează token-urile în keychain-ul sistemului, niciodată în config.toml. Comanda vibe mcp add gestionează totul direct din terminal: vibe mcp add linear --url https://mcp.linear.app/mcp adaugă serverul și pornește fluxul de autentificare.

Beneficiul este simplu: puteți versiona și partaja fișierul config.toml cu echipa fără a codifica hardcoded niciun secret, deoarece fiecare dezvoltator își furnizează propriul token prin mediul său.

Servere MCP populare

Mai multe servere gata de utilizare acoperă cele mai comune nevoi, iar toate se declară în același mod în config.toml. mcp-server-fetch gestionează preluarea paginilor web și a API-urilor; mcp-server-filesystem extinde operațiunile cu fișiere dincolo de instrumentele încorporate; mcp-server-git aduce o integrare Git avansată cu diff, blame și log; mcp-server-sqlite și mcp-server-postgres permit interogarea bazelor de date SQLite și PostgreSQL. Un agent care poate citi atât schema unei baze de date, cât și codul care o utilizează, detectează inconsistențe pe care simpla citire a fișierelor nu le-ar revela niciodată.

În timpul unei sesiuni, /mcp listează serverele, iar /mcp <name> listează instrumentele lor; /mcp status afișează starea fiecăruia. Agentul vă spune, de asemenea, ce instrumente utilizează în răspunsurile sale, ceea ce rămâne cea mai bună metodă de a verifica dacă un server funcționează corect.

Securitatea serverelor MCP

Un server MCP rulează cu permisiunile dumneavoastră și vede ceea ce îi oferiți: adăugați doar servere de încredere, deoarece un server malițios ar putea expune date din baza dumneavoastră de cod. Apoi, limitați permisiunile cu enabled_tools în loc să acordați acces complet implicit.

Două obiceiuri completează această rutină de igienizare. Verificați anteturile: niciun token nu ar trebui să apară în text clar în config.toml; exact pentru asta servește api_key_env. Iar pentru instrumentele locale, preferați transportul STDIO, care este mai sigur decât un server HTTP expus în rețea, dacă nu din alt motiv, măcar pentru că nu deschide niciun port.

Puncte cheie

  • MCP vă permite să adăugați instrumente externe în Vibe printr-un protocol standardizat
  • Două transporturi principale: HTTP (server persistent) și STDIO (proces local)
  • Filtrarea instrumentelor (enabled_tools, disabled_tools) controlează ceea ce poate utiliza agentul
  • Variabilele de mediu în anteturi protejează secretele
  • Adăugați doar servere MCP de încredere și limitați-le permisiunile