Adăugarea unui conector MCP personalizat
Pe această pagină
Actualizat la 2 noiembrie 2026 — Le Chat devine Vibe. Începând cu 28 mai 2026, Le Chat a fost rebotezat Vibe (rămânând la chat.mistral.ai): un singur agent pentru muncă și cod, care preia conversațiile, setările și abonamentele dumneavoastră. Experiența legacy Le Chat rămâne disponibilă în modul Chat; în modul Work, agenții sunt acum competențe (invocate cu
@), memoriile servesc drept bază de cunoștințe, iar căutarea profundă este competența Deep Research. Planurile se numesc acum Mistral Free, Pro, Team și Enterprise. Această lecție utilizează denumirea Vibe; unele meniuri descrise aici își pot fi schimbat numele sau locația.
Dincolo de directorul oficial
Conectorii integrați acoperă multe cazuri de utilizare, dar organizația dumneavoastră se bazează probabil pe instrumente interne, API-uri proprietare sau servicii de nișă absente din directorul Vibe. Aici intervin conectorii personalizați: puteți adăuga orice server MCP la distanță în Vibe simplu, furnizând URL-ul acestuia. acel CRM intern construit acum șase ani devine utilizabil într-o conversație, la fel ca GitHub sau Notion.
Procesul de adăugare
Adăugarea unui conector necesită doar câțiva clicuri în interfață. Deschideți fila Connectors (Conectori), faceți clic pe Add a custom connector (Adăugați un conector personalizat) în partea de jos a listei și completați detaliile requise:
- Name (Nume): Un nume descriptiv pentru a identifica conectorul (de exemplu, „CRM Intern“ sau „API Meteo“)
- Server URL (URL Server): Adresa publică a serverului dumneavoastră MCP, inclusiv endpoint-ul
/mcp(de exemplu,https://mon-serveur.example.com/mcp) - Description (Descriere): O scurtă explicație a funcției conectorului (opțional, dar recomandat)
- Authentication method (Metodă de autentificare): None (Niciuna), Token sau OAuth 2.0
În final, faceți clic pe Create (Creați) pentru a salva conectorul. Vibe interoghează automat serverul pentru a descoperi instrumentele disponibile: lista funcțiilor expuse apare și puteți începe să le utilizați în conversațiile dumneavoastră.
Această cerere de descoperire returnează numele, descrierea textuală, parametrii așteptați (cu numele, tipul și descrierea lor) și tipul de returnare pentru fiecare instrument. Acestea sunt singurele detalii pe care modelul Mistral le utilizează pentru a decide când și cum să invoce fiecare instrument—motiv pentru care lecția următoare se concentrează puternic pe calitatea descrierii. Un instrument bine scris, dar cu o descriere slabă, rămâne invizibil pentru model.
Metode de autentificare
Cazul cel mai simplu este absența autentificării: serverul dumneavoastră MCP este accesibil oricui îi cunoaște URL-ul. Acest lucru funcționează pentru instrumente publice care nu gestionează date sensibile, prototipuri, demo-uri și servere MCP care înfășoară API-uri publice. Autentificarea prin token implică furnizarea unei chei trimise cu fiecare cerere către server; Vibe stochează token-ul în siguranță. Alegeți această opțiune pentru API-uri interne protejate printr-o cheie API, servere care trebuie să identifice apelantul și orice scenariu în care doriți să restricționați accesul. În final, există OAuth 2.0, fluxul complet cu redirecționare către pagina de autorizare a serviciului: este mecanismul cel mai securizat, dar și cel mai complex de implementat pe partea de server, și va fi tratat în profunzime în ghidurile viitoare Mistral AI.
Condiții prealabile pentru serverul dumneavoastră MCP
- Să fie accesibil printr-un URL public (fără localhost)
- Să expună un endpoint în format Streamable HTTP (
/mcp) - Să răspundă la cererile de descoperire a instrumentelor în format JSON MCP standard
- Să gestioneze corect apelurile de instrumente și să returneze rezultatele în formatul așteptat
Cerința URL-ului public pare să blocheze dezvoltarea locală, dar există o soluție în faza de depanare. Dacă dezvoltați pe mașina dumneavoastră și doriți să testați cu Vibe înainte de implementare, deschideți un tunel către serverul local folosind ngrok:
ngrok http 8000
ngrok vă oferă un URL public temporar pe care îl puteți utiliza ca URL al conectorului în Vibe. Această abordare este ideală pentru dezvoltare și testare: modificați codul, reporniți, iar Vibe vede imediat noua versiune fără nicio implementare.
Testarea cu MCP Inspector
Înainte de a adăuga serverul în Vibe, testați-l cu MCP Inspector, un instrument open-source care verifică dacă serverul răspunde corect la cererile de descoperire, listează instrumentele disponibile cu descrierile și parametrii lor, execută manual apeluri de instrumente pentru a verifica rezultatele și ajută la depanarea problemelor de formatare sau de tipizare. Lansați-l cu o comandă simplă npx:
npx @modelcontextprotocol/inspector
Inspectorul deschide o interfață web locală unde vă conectați la serverul MCP și testați fiecare instrument individual. Acest pas nu este doar o formalitate: vă scutește de a consuma mesaje din conversație pentru depanare și izolează clar erorile de server de erorile de interpretare ale modelului.
Gestionarea organizațională
Dacă faceți parte dintr-o organizație pe Vibe, rețineți că conectorii personalizați pe care îi adăugați sunt vizibili pentru alți membri. Un administrator poate dezactiva orice conector pentru întreaga organizație dacă îl consideră inadecvat sau nesecurizat. Totuși, fiecare utilizator trebuie să își furnizeze propriile credențiale—token sau OAuth—pentru conectorii care necesită autentificare: partajarea unui conector nu înseamnă niciodată partajarea credențialelor de acces.
Securitatea conectorilor personalizați
Spre deosebire de conectorii oficiali validați de Mistral AI, un conector personalizat poate executa cod arbitrar pe partea de server, iar descrierea textuală pe care o vedeți nu garantează nimic despre ceea ce face serverul de fapt. Limitați-vă la servere pe care le-ați dezvoltat dumneavoastră înșivă, cele de la colegi sau parteneri de încredere și servere open-source al căror cod l-ați verificat. Chiar și cu propriii conectori, mențineți validarea umană activată pe tot parcursul fazei de depanare; odată ce sunteți sigur că totul funcționează, puteți lua în considerare setarea instrumentelor read-only (doar citire) la „Always Allow“ (Permite întotdeauna).
Puncte cheie
- Puteți adăuga orice server MCP la distanță ca conector personalizat în Vibe
- Serverul trebuie să fie accesibil printr-un URL public cu un endpoint
/mcp - Sunt suportate trei metode de autentificare: none (niciuna), token și OAuth 2.0
- Utilizați ngrok pentru a testa serverul local cu Vibe înainte de implementare
- MCP Inspector este esențial pentru depanarea serverului înainte de integrare
- Adăugați doar conectori din surse de încredere și mențineți validarea umană activată