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

Integrarea unui server personalizat în Vibe

Lecția 13 din 14 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Conectarea serverului dumneavoastră MCP la Vibe
  2. Adăugarea conectorului
  3. Ce se întâmplă în conversație
  4. Când nu funcționează
  5. MCP Inspector: folosiți-l înainte de Vibe
  6. Gestionarea mai multor servere
  7. Puncte cheie

Actualizare 2 noiembrie 2026 — Le Chat devine Vibe. Începând cu 28 mai 2026, Le Chat a fost rebotezat Vibe (disponibil tot la chat.mistral.ai): un singur agent pentru muncă și cod, care păstrează conversațiile, setările și abonamentele dumneavoastră. Experiența legacy Le Chat rămâne accesibilă în modul Chat; în modul Work, agenții au devenit competențe (invocate cu @), memoriile au devenit baza de cunoștințe, iar căutarea avansată a devenit competența Deep Research. Planurile se numesc acum Mistral Free, Pro, Team și Enterprise. Această lecție folosește denumirea Vibe; rețineți că unele meniuri descrise aici își pot fi schimbat numele sau locația.

Conectarea serverului dumneavoastră MCP la Vibe

Serverul dumneavoastră este implementat și răspunde prin HTTPS la o adresă stabilă. Urmează acum pasul care dă sens întregii munci anterioare: punerea lui la dispoziția publicului țintă în cadrul unei conversații, inclusiv pentru cei care nu vor deschide niciodată un terminal. Vibe acceptă orice server MCP conform ca conector personalizat. Această lecție acoperă adăugarea conectorului, parcurgerea fluxurilor de apel în conversație și diagnosticarea erorilor – deoarece prima încercare eșuează adesea.

Adăugarea conectorului

Deschideți Vibe la chat.mistral.ai și navigați la fila Connectors din bara laterală. Veți găsi două secțiuni distincte: conectorii evidențiați, preconfigurați de Mistral (GitHub, Notion și alții), și conectorii dumneavoastră personalizați, inițial goi. Faceți clic pe Add Custom Connector și completați câmpurile:

  1. Name: Un nume descriptiv (de ex. „Task Manager“)
  2. Server URL: URL-ul complet al endpoint-ului dumneavoastră MCP (de ex. https://my-server.com/tasks/mcp)
  3. Description: Ce face serverul dumneavoastră (opțional, dar recomandat)

Alegeți apoi metoda de autentificare: No authentication pentru un server public, Token dacă lipiți token-ul API, sau OAuth 2.0 pentru un flux complet de consimțământ. Făcând clic pe Connect se declanșează descoperirea: dacă reușește, Vibe afișează lista de instrumente găsite pe serverul dumneavoastră, arătând numele și descrierea fiecăruia. Acesta este primul feedback real privind calitatea docstring-urilor dumneavoastră – le citiți aici exact așa cum le va primi modelul.

Ce se întâmplă în conversație

Odată conectat, serverul dumneavoastră apare în secțiunea Tools a barei laterale de chat, marcat printr-o pictogramă care indică disponibilitatea unui instrument extern. Utilizatorul își formulează cererea în limbaj natural, iar modelul o traduce:

User: Create a high-priority task to prepare the MCP demo

Vibe: [Calling create_task with the following arguments]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → Do you want to authorize this tool call?

User: [Authorize]

Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.

Această solicitare de confirmare este comportamentul implicit. Puteți să o aprobați ad-hoc sau să comutați un instrument la autorizare permanentă. Rezistați tentației de a face acest lucru pentru orice server pe care nu îl dețineți. Confirmarea protejează nu doar împotriva bug-urilor; este singura dumneavoastră apărare împotriva injectărilor de prompt (prompt injections), unde instrucțiuni ascunse în datele returnate de un instrument direcționează modelul către apeluri pe care nimeni nu le-a solicitat. Vizualizarea argumentelor derulând înainte de validare este ceea ce vă permite să depistați anomalia.

Când nu funcționează

Mesajul „Unable to connect“ provine aproape întotdeauna din una dintre aceste patru cauze: URL-ul este inaccesibil din exterior, protocolul nu este HTTPS (ceea ce Vibe impune), serverul pur și simplu nu rulează, sau CORS nu este configurat, deși Vibe trimite cereri dintr-un browser. Următoarea comandă distinge între primele două ipoteze în câteva secunde:

# Test accessibility
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Dacă conexiunea reușește, dar niciun instrument nu apare, urmăriți lanțul înapoi, pe partea serverului: verificați dacă decoratorul @app.tool() este prezent pe fiecare funcție, dacă nu lipsesc docstring-uri și dacă serverul MCP este montat pe ruta pe care credeți că este. Folosiți MCP Inspector înainte de orice altă investigație.

Cel mai confuz caz este când totul funcționează, dar modelul apelează instrumentul greșit sau niciunul. Problema nu este atunci tehnică: modelul alege pe baza descrierilor, iar dacă două instrumente seamănă sau dacă unul rămâne vag, acesta va alege prost. Folosiți trei pârghii, în această ordine: faceți descrierea mai specifică clarificând cazul de utilizare, redenumiți instrumentul pentru a elimina ambiguitatea și reduceți numărul de instrumente active simultan. În final, dacă un instrument returnează o eroare, verificați jurnalele serverului, repetați apelul manual în inspector și verificați dacă variabilele de mediu sunt setate și dacă token-ul sau scopurile OAuth acordă permisiunile așteptate.

MCP Inspector: folosiți-l înainte de Vibe

Inspectorul testează instrumentele dumneavoastră fără a implica modelul, izolând jumătate din variabilele problemei:

npx @modelcontextprotocol/inspector

Deschide o interfață web unde vă conectați la serverul distant prin URL-ul său, listați toate instrumentele cu descrierile și parametrii lor, executați un instrument cu argumente la alegerea dumneavoastră și citiți răspunsul brut al serverului. Faceți din aceasta un obicei să efectuați această verificare sistematic înainte de a adăuga un server în Vibe, deoarece vă oferă un diagnostic imediat: dacă un instrument răspunde corect în inspector, dar eșuează în Vibe, serverul nu este de vină, iar problema constă în descriere sau în prompt.

Gestionarea mai multor servere

Odată ce ați instalat mai mulți conectori, disciplina devine factorul principal al calității. Vibe vă permite să comutați fiecare conector: mențineți active doar instrumentele necesare sarcinii curente, deoarece un model copleșit de cincizeci de instrumente alege mai puțin precis și răspunde mai lent. Această igienă se bazează pe separarea pe domenii abordată în Lecția 10 – un server pentru gestionarea proiectelor, unul pentru monitorizare, unul pentru instrumente interne – deoarece astfel trebuie doar să activați pe cel care corespunde conversației curente.

În final, adaptați-vă prompt-urile la capacitățile expuse efectiv:

# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"

# Bad: too vague, the model doesn't know which tool to use
"Manage my project"

Un ultim punct worth knowing înainte de a vă proiecta serverele: conectorii MCP configurați în Vibe rămân disponibili în aplicația mobilă. Instrumentele dumneavoastră interne devin astfel accesibile de pe un telefon, deschizând scenarii de utilizare în teren pe care s-ar pute să nu le luați în considerare atunci când dezvoltați pe un desktop.

Puncte cheie

  • Adăugarea unui conector personalizat în Vibe necesită 3 pași: nume, URL, auth
  • Mențineți confirmarea manuală a apelurilor de instrumente activată pentru securitate
  • Folosiți MCP Inspector pentru a testa și depana înainte de integrarea în Vibe
  • Îmbunătățiți descrierile instrumentelor dacă modelul nu le folosește corect
  • Mențineți active doar instrumentele necesare pentru sarcina curentă
  • Serverele dumneavoastră MCP sunt accesibile și pe mobil