Conectează servere MCP la botul tău #

Serverele MCP permit botului tău AI să utilizeze instrumente din alt sistem în timpul conversațiilor live — fără a fi nevoie să construiești fiecare instrument manual. Indici botului un server MCP o singură dată, iar fiecare instrument oferit de acel server devine disponibil botului în mod automat.

Dacă ai folosit Funcții Personalizate (Custom Functions), este aceeași idee, dusă cu un pas mai departe: o funcție personalizată este un singur instrument pe care îl configurezi singur, în timp ce un server MCP este un pachet gata pregătit de instrumente pe care botul le poate descoperi și apela singur.

Ce este un server MCP? #

MCP (Model Context Protocol) este un standard deschis pentru a oferi asistenților AI acces la instrumente externe. Multe aplicații și servicii moderne publică acum un „server MCP” — o singură adresă web care expune un set de instrumente pe care AI-ul le poate apela: caută ceva, preia o înregistrare, rulează o interogare, creează un element.

În loc să descrii fiecare instrument pentru bot, îi oferi lui Your AI Connector adresa serverului și o cheie de acces. Your AI Connector întreabă serverul „ce poți face?”, primește înapoi lista de instrumente și le face disponibile pentru botul tău. Când serverul adaugă un instrument nou, botul tău îl poate folosi fără nicio configurare suplimentară din partea ta.

Funcții Personalizate vs. Serverele MCP — pe care să le folosești:

Poți folosi ambele variante simultan pe același Agent.

Cum funcționează (Versiunea simplă) #

1. Înregistrezi un server MCP pe pagina Servere MCP — adresa sa web și un antet de autorizare (de obicei o cheie API).
2. Your AI Connector se conectează și descoperă instrumentele serverului și reține lista.
3. Activezi serverul pe un Agent.
4. În timpul unei conversații, când clientul cere ceva la care un instrument poate răspunde, botul apelează instrumentul, citește rezultatul și răspunde în mod natural.

Clientul nu vede niciodată mecanismul din spate — primește doar un răspuns susținut de informații reale și actualizate.

Cât costă un apel de instrument MCP #

Un apel de instrument de la un server MCP este facturat exact ca un apel de funcție personalizat, la nivelul de Calitate AI al Agentului tău:

Adăugarea unui server MCP (Pas cu pas) #

În bara laterală principală, sub AI Studio, dă clic pe Servere MCP. Apoi dă clic pe + Adaugă server.

Completați formularul:

Alegerea metodei de autentificare: cheie API sau OAuth #

Your AI Connector acceptă două modalități de autentificare cu un server. Alege-o pe cea indicată de documentația serverului, folosind opțiunea Autentificare din partea de sus a formularului:

• Cheie API / antet: metoda originală descrisă mai sus. Lipești o credențială fixă (o cheie API sau un token) în câmpul Valoare antet autentificare, iar Your AI Connector o trimite la fiecare cerere. Este cea mai bună opțiune pentru serverele care îți oferă o cheie cu durată lungă de viață.
• OAuth (conectare): pentru serverele care îți cer să te autentifici în loc să lipești o cheie. Cu OAuth nu există nicio cheie de copiat — aprobi accesul prin autentificare, la fel cum funcționează „Conectare cu Google” pe alte site-uri.

Pentru a vă conecta prin OAuth:

1. Alegeți OAuth ca metodă de autentificare. Câmpurile Antet Autentificare (Auth Header) vor dispărea, fiind înlocuite de un card Conectare — nu veți avea nevoie de o cheie.

2. Completează Numele și URL-ul serverului, apoi dă clic pe Salvare. Serverul este adăugat la listă, dar apare ca neconectat pentru moment.
3. Dă clic pe Conectare în dreptul serverului. Se va deschide o fereastră securizată de autentificare unde aprobi accesul.
4. Aprobă, iar fereastra se va închide automat. Serverul apare acum ca fiind conectat, iar Your AI Connector încarcă instrumentele acestuia.

Asta este tot. Your AI Connector menține conexiunea activă automat în fundal, așa că, de regulă, nu va mai trebui să intervii niciodată. Dacă un server întrerupe conexiunea (de exemplu, autentificarea expiră sau cineva o revocă din partea serverului), acesta va apărea ca deconectat — trebuie doar să dai clic pe Reconectare și să te autentifici din nou.

Dacă serverul nu poate fi configurat automat când faceți clic pe Connect, vi se va solicita să introduceți câteva detalii (o adresă de autentificare și un ID de client) furnizate de documentația serverului, apoi procesul de conectare va finaliza autentificarea.

Testați conexiunea #

Înainte de a salva, dă clic pe Testare conexiune. Your AI Connector contactează serverul și îți arată lista de instrumente pe care acesta le oferă. Aceasta este cea mai rapidă metodă de a confirma că URL-ul și cheia sunt corecte — dacă conexiunea eșuează, vei vedea mesajul de eroare direct acolo, în loc să afli acest lucru în mijlocul unei conversații.

Când testul reușește, faceți clic pe Save (Salvare). Serverul dvs. apare în listă cu un punct de stare verde și numărul de instrumente pe care le oferă.

Citirea listei de servere #

Fiecare server din listă afișează:

• Un punct de stare — verde când ultima conexiune a funcționat, roșu când ultima încercare a eșuat (treceți cu mouse-ul peste pentru eroare), gri înainte de prima conexiune reușită.
• Adresa serverului și câte instrumente oferă în prezent.
• Un comutator pornit/oprit pentru a activa sau dezactiva rapid întregul server fără a-l șterge.

Your AI Connector reîmprospătează lista de instrumente a fiecărui server în fundal aproximativ o dată pe zi, astfel încât instrumentele noi apar automat. Un server lent sau temporar inaccesibil nu va bloca niciodată o conversație — botul folosește pur și simplu ultima listă de instrumente cunoscută și revine la starea anterioară dacă un apel nu poate fi efectuat.

Alegerea instrumentelor pe care le poate folosi botul #

Un server oferă adesea mai multe instrumente decât doriți să acceseze botul. Puteți activa sau dezactiva instrumente individuale fără a deconecta întregul server.

1. Faceți clic pe pictograma creion (editare) din dreptul serverului în listă.
2. Derulați până la secțiunea Instrumente — fiecare instrument oferit de server este listat, având propriul comutator pornit/oprit.
3. Dezactivați orice instrument pe care nu doriți ca botul să îl apeleze sau utilizați Activare totală / Dezactivare totală pentru a le seta dintr-o singură mișcare.
4. Faceți clic pe Salvare modificări.

Doar instrumentele pe care le lăsați activate sunt oferite botului. Un instrument care este dezactivat este complet invizibil pentru bot — acesta nu îl poate apela și nu va fi luat în calcul pentru limita de 40 de instrumente.

Două lucruri care merită știute:

• Instrumentele noi rămân dezactivate până când le pornești. Odată ce ai selectat instrumentele unui server, orice instrument adăugat ulterior de server va apărea dezactivat, astfel încât nimic nou să nu devină disponibil pentru bot până când nu decizi să îl activezi. (Serverele pe care nu le-ai configurat manual păstrează toate instrumentele activate, exact ca înainte.)
• Aceasta este separat de alegerea Agentului de mai jos. Aici decizi care dintre instrumentele unui server există la nivel de cont; pe Agent decizi la ce servere are acces acel Agent — și, dacă dorești, poți restrânge instrumentele disponibile doar pentru acel Agent.

Setarea limitelor de execuție per instrument #

Lângă comutatorul pornit/oprit al fiecărui instrument veți găsi un control Limite. Acesta deschide aceleași limite de execuție pe care le puteți seta pentru o funcție personalizată, aplicate doar acelui instrument — util atunci când un instrument al unui server apelează un serviciu terț plătit sau când un instrument ar trebui să ruleze o singură dată per conversație. Totul aici este opțional; lăsați câmpul gol și instrumentul se va comporta exact ca înainte.

• Read-only (Doar citire). Unele servere declară pentru fiecare instrument dacă acesta doar citește date. Automatic (setarea serverului) are încredere în acea declarație; puteți suprascrie acest lucru în ambele sensuri — marcați un instrument ca Read-only când știți că acesta nu creează sau nu modifică niciodată nimic (acest lucru permite AI-ului să reîncerce în siguranță un răspuns întrerupt în loc să lase clientul fără un răspuns), sau Not read-only când nu aveți încredere în afirmația serverului.
• Serve cached result on repeat calls (Servește rezultatul din cache la apeluri repetate). Când AI-ul apelează din nou instrumentul cu aceleași date de intrare, rezultatul anterior este refolosit (timp de până la 24 de ore) în loc să apeleze din nou serverul.
• Max runs per conversation (Număr maxim de rulări per conversație) și max runs per time window (număr maxim de rulări per interval de timp) funcționează exact ca la funcțiile personalizate: doar rulările reușite sunt luate în calcul, iar când o limită este atinsă, AI-ul este informat de ce și răspunde cu informațiile pe care le are deja — clientul nu este lăsat niciodată în așteptare. Conversațiile de testare sunt exceptate.

O notă sinceră despre încredere: limitele controlează dacă și cât de des apelăm serverul — acestea nu pot schimba ceea ce face serverul intern odată apelat. Iar suprascrierea unui instrument terț ca Read-only este o afirmație mai puternică decât în cazul propriei funcții personalizate, deoarece este codul altcuiva; faceți acest lucru doar pentru instrumentele pe care le înțelegeți.

Activarea unui server pe un Agent #

Înregistrarea unui server îl face disponibil; tu alegi în continuare ce Agenți îl pot folosi.

1. Deschideți Agentul și accesați fila Capabilități AI. (Pentru o campanie care își păstrează propriile setări AI direct, în loc să le gestioneze printr-un Agent separat, aceeași listă apare în pasul Capabilități AI al acelei campanii.)
2. Găsiți secțiunea Servere MCP.
3. Activați fiecare server pe care doriți să îl poată utiliza botul acestui Agent.
4. Faceți clic pe Salvare modificări — selecțiile se aplică doar după salvare.

Poți activa până la 5 servere per Agent. Doar serverele pe care le activezi sunt disponibile pentru botul acelui Agent, ceea ce menține botul concentrat pe instrumentele relevante.

Alegerea instrumentelor pe care un Agent le poate folosi #

Odată ce un server este activat pe un Agent, poți, de asemenea, să restrângi care dintre instrumentele sale poate apela acel Agent specific — util atunci când un Agent ar trebui doar să citească date, în timp ce altul poate crea și înregistrări.

1. În fila Capabilități AI, sub serverul activat, dă clic pe rândul „… instrumente activate pentru acest agent” pentru a extinde lista de instrumente.
2. Dezactivează orice instrument pe care acest Agent nu ar trebui să îl folosească, apoi dă clic pe Salvează modificările.

Două reguli mențin acest lucru predictibil:

• Un Agent poate doar să restrângă, niciodată să extindă. Instrumentele pe care le-ai dezactivat la nivel de cont (pe pagina Servere MCP) nu apar aici și nu pot fi reactivate pentru un singur Agent.
• Agenții moștenesc setările implicit. Un Agent pentru care nu ai modificat lista de instrumente urmează pur și simplu selecția de la nivel de cont — inclusiv instrumentele pe care le activezi acolo ulterior. Odată ce restrângi lista unui Agent, instrumentele noi rămân dezactivate pentru acel Agent până când le activezi manual.

Exemplu gata de utilizare: Conectarea unui magazin Shopify #

Fiecare magazin Shopify vine cu un server MCP încorporat — nu trebuie instalată nicio aplicație, nicio cheie de creat. Shopify îl găzduiește la adresa web a magazinului cu /api/mcp adăugat la sfârșit.

Ce obține botul de la acesta:

• Căutare produse — găsește produse descriind ceea ce dorește clientul („o jachetă de alergare călduroasă sub 100 $”), cu prețuri în timp real, variante și stoc.
• Detalii produs — informații complete despre un anumit produs, inclusiv opțiuni și disponibilitate.
• Politici și întrebări frecvente ale magazinului — întrebări despre livrare, retururi, rambursări și confidențialitate, răspunsuri extrase direct din paginile magazinului.
• Coș — creează un coș pentru client și oferă-i un link către finalizarea comenzii.

Pentru a conecta unul, adaugă un server cu:

Salvează, dă clic pe Test Connection și activează serverul pe agentul tău — aceasta este întreaga configurare.

Două lucruri de știut:

• Comenzile nu se află pe acest server. Shopify păstrează în mod deliberat datele comenzilor în afara acestui punct final public. Pentru întrebări de tipul „unde este comanda mea?”, asociază acest server cu o funcție personalizată — consultă exemplul privind starea comenzii Shopify.
• Funcționează pentru orice magazin Shopify — inclusiv pentru magazinul unui client dacă gestionezi conturi pentru alții. Tot ce ai nevoie este adresa web a magazinului.

Securitate — Conectați doar servere în care aveți încredere #

Un server MCP pe care îl conectați poate fi apelat de botul dvs. și poate returna text pe care botul îl citește și pe baza căruia acționează. Tratați-l ca pe orice altă integrare care deține o cheie pentru sistemele dvs.:

• Înregistrați doar serverele pe care le controlați sau în care aveți încredere deplină. Descrierea unui instrument este scrisă de cel care administrează serverul, iar botul citește acele descrieri pentru a decide când să utilizeze un instrument.
• Utilizați o cheie API dedicată și limitată, nu o credențială de administrator. Cheia dumneavoastră este stocată în siguranță și nu este afișată niciodată în exporturile de date. Același lucru este valabil și pentru autentificările OAuth — jetoanele de acces sunt stocate în siguranță și eliminate din orice export.
• URL-ul trebuie să fie o adresă publică https://. Adresele interne, localhost și cele din rețele private sunt respinse din motive de securitate.
• Dezactivați un server în momentul în care nu mai aveți încredere în el — comutați-l pe oprit sau ștergeți-l, iar acesta va dispărea imediat din fiecare Agent.

Depanare #

• Punct de stare roșu / conexiune eșuată: Redeschideți serverul și faceți clic pe Test Connection (Testare conexiune) pentru a vedea eroarea exactă. Cele mai frecvente cauze sunt o cheie greșită sau expirată, o greșeală de scriere în URL sau faptul că serverul necesită un nume de antet diferit de Authorization.
• Un server OAuth a încetat să funcționeze / vă cere să vă reconectați: Autentificările OAuth pot fi revocate sau pot expira din partea serverului. Deschideți serverul și faceți clic din nou pe Connect (Conectare) pentru a vă autentifica din nou. Rețineți că autentificările OAuth nu sunt niciodată copiate între conturi, deci serverele unui Agent sau ale unei campanii copiate trebuie reconectate în contul în care le-ați copiat.
• Botul nu folosește un instrument: Mai întâi verificați dacă instrumentul este activat în secțiunea Tools (Instrumente) a serverului (editați serverul pentru a vedea lista) — un instrument dezactivat este invizibil pentru bot. Apoi asigurați-vă că serverul este activat pentru acel Agent specific și că solicitarea clientului corespunde clar cu ceea ce face instrumentul. La fel ca în cazul funcțiilor personalizate, numele și descrierile clare ale instrumentelor din partea serverului ajută botul să aleagă corect.
• Un instrument oferit de server nu apare pentru bot: Dacă ați selectat instrumentele acestui server, rețineți că orice instrument adăugat după ce ați făcut selecția va fi dezactivat implicit. Editați serverul, deschideți secțiunea Tools (Instrumente) și activați-l.
• Conectorul gestionează sesiunile MCP HTTP? Da. Dacă serverul dumneavoastră emite un antet mcp-session-id atunci când conexiunea este stabilită, îl stocăm și îl trimitem înapoi la fiecare solicitare ulterioară, împreună cu antetul MCP-Protocol-Version. Serverele cu stare (stateful) funcționează fără nicio configurație suplimentară din partea dumneavoastră.
• Un instrument a fost omis: Un Agent poate folosi cel mult 5 servere și 40 de instrumente MCP simultan. Dacă un server oferă un număr foarte mare de instrumente, este posibil ca unele să nu fie încărcate — dezactivați instrumentele de care nu aveți nevoie în secțiunea Tools (Instrumente) a serverului sau păstrați fiecare server concentrat pe instrumentele pe care le utilizați efectiv.

Cerințele planului #

Serverele MCP fac parte din setul de instrumente pentru dezvoltatori, alături de funcțiile personalizate. Dacă nu vedeți MCP Servers în secțiunea AI Studio din bara laterală, planul dumneavoastră actual nu include această funcționalitate — treceți la un plan cu instrumente pentru dezvoltatori pentru a o activa.

Pașii următori #

• Funcții personalizate — configurați manual un singur instrument în loc să conectați un server întreg.
• Agenți AI — locul unde serverele MCP sunt activate pentru un bot.
• Agenți AI — pagina principală a grupului AI Studio în care se află Servere MCP.