Ghid
Dă-i unelte: MCP și API extern
Un server MCP conectat, uneltele lui filtrate, plus o unealtă HTTP scrisă de tine.
20 de minute 5 pași
Un asistent care poate chema unelte reale, cu permisiuni per unealtă și cu fiecare încercare consemnată.
- Un asistent publicat.
- Un server MCP la care ai acces, cu URL și, dacă cere, o metodă de autentificare.
- Sau un API propriu cu o rută pe care vrei să o expui modelului.
Adaugă serverul MCP
Alege transportul, pune URL-ul și, dacă serverul cere autentificare, alege între anteturi statice, bearer, o credențială deja salvată sau OAuth. Timeoutul implicit este de 20 de secunde, iar rezultatul descoperirii se ține în cache 15 minute.
Construiește → MCP → Creează → Conectare: Nume, Transport, URL, timeout 20 s
Rulează descoperirea și citește ce a găsit
Butonul „Testează conexiunea” face doar handshake. „Descoperă acum” cere lista de unelte și o salvează. Catalogul îți arată pentru fiecare unealtă parametrii, schema de intrare și de ieșire, nivelul de risc și dacă are nevoie de confirmare.
Acțiuni: „Testează conexiunea” · „Descoperă acum” · „Reverifică”
Restrânge ce are voie modelul să cheme
Listele de permise și interzise se populează doar din uneltele deja descoperite, deci rulează întâi descoperirea, altfel sunt goale. Pune nivelul implicit de risc și blochează nivelurile pe care nu le vrei. O unealtă interzisă nu este doar ascunsă: apelul către ea este refuzat și scris în registrul apelului.
Permisiuni → Politică · Permise / Interzise · Nivel implicit de risc · Niveluri blocate
Fă o unealtă din fiecare unealtă MCP pe care o vrei
Aici este pasul pe care îl ratează toată lumea: nu legi un server de asistent, ci o unealtă. Creezi o unealtă de tip MCP, alegi serverul și apoi numele uneltei din cele descoperite. Abia unealta aceea se atașează asistentului.
Construiește → Unelte → Creează → Tip: MCP → Server + Nume unealtă
Sau scrie o unealtă HTTP proprie
Numele funcției este ce vede modelul, deci scrie-l ca pe un nume de funcție. Argumentele se dau ca schemă JSON, într-un editor care validează pe loc. Apoi configurezi metoda, URL-ul, anteturile, corpul și de unde vine fiecare parametru: din model, dintr-o valoare fixă, dintr-o variabilă de apel sau dintr-o credențială salvată.
Tip: Cerere API → Nume funcție (^[a-zA-Z_][a-zA-Z0-9_]*$) → Argumente (schemă JSON) → Legături de parametri
Cum îți dai seama că a mers
- Starea serverului MCP este „Conectat”, nu „Neverificat”.
- În catalogul de unelte, cele pe care le-ai interzis apar ca Interzise, cu motivul scris.
- Într-un apel de test, fila Unelte a apelului arată „tool.started” și „tool.completed” pentru unealta chemată.
Ce nu merge încă
Fiecare ghid are secțiunea asta. Dacă ar lipsi, ar însemna că nu ne-am uitat destul de atent.
- Butonul de publicare al uneltelor nu are etichetă tradusă și apare ca „Publish” chiar și cu interfața pe română.
- Uneltele de tip shell și computer refuză să ruleze. Cutia izolată în care ar trebui să se execute nu există încă, iar refuzul este preferabil rulării pe mașina noastră.
- Fiecare unealtă MCP se leagă separat. Dacă serverul expune treizeci de unelte și le vrei pe toate, faci treizeci de unelte.