Adăugarea unui server MCP propriu
Cu un server MCP propriu, conectezi AI-School la o aplicație proprie, o sursă de date sau un serviciu specializat. Alege mai întâi transportul potrivit pentru locul de utilizare.
Alege transportul corect
| Transport | Web | Mobil | Desktop | Utilizare |
|---|---|---|---|---|
| Streamable HTTP | Da | Da | Da | Recomandat pentru servere găzduite |
| stdio | Nu | Nu | Da | Procese locale și integrări desktop |
| SSE | Doar configurații existente | Doar configurații existente | Da | Transport învechit; pentru servere noi alege Streamable HTTP |
Cerințe pentru Streamable HTTP
Folosește endpoint-ul public complet, inclusiv calea MCP, de exemplu:
https://mcp.example.nl/mcp
Endpoint-ul trebuie să:
- folosească HTTPS;
- funcționeze fără nume de utilizator sau parolă în URL;
- nu necesite redirect;
- fie accesibil prin DNS public;
- răspundă cu un handshake MCP
initializevalid; - aibă un set explicit de unelte permise.
Adresele locale, adresele din rețele private și endpoint-urile de metadate cloud sunt blocate. Prin urmare, nu poți înregistra un server pe localhost din aplicația web.
Adăugarea unui server
- Deschide Preferințe → Unelte.
- Alege Adaugă unelte sau Adaugă server MCP.
- Consultă mai întâi presetările disponibile.
- Selectează Adaugă un server MCP propriu.
- Completează numele, endpoint-ul complet și metoda de autentificare.
- Salvează configurația și așteaptă verificarea conexiunii.
- Activează serverul pentru setul tău standard de unelte.
Un administrator poate înregistra un server pentru întregul mediu prin Administrare → Setări AI → Unelte → MCP.
Autentificare și secrete
AI-School suportă connector-OAuth și secrete statice. Token-urile OAuth, token-urile de reîmprospătare, cheile API și parolele sunt stocate doar pe server. Un chat primește doar connectorId înregistrat, niciodată configurația secretă.
La modificarea URL-ului sau a autentificării, noua configurație este verificată din nou. Dacă verificarea eșuează, o configurație aprobată anterior poate rămâne activă până la rezolvarea problemei.
Drepturi pentru unelte
Permite doar uneltele de care utilizatorii au cu adevărat nevoie. Un server MCP poate oferi acțiuni de citire și scriere, cum ar fi ștergerea fișierelor, trimiterea de emailuri sau modificarea înregistrărilor. AI-School filtrează uneltele descoperite conform listei de permisiuni server-side, dar administratorul serverului rămâne responsabil pentru scope-urile și autorizările adecvate.
Testare locală
Un server local stdio îl testezi în aplicația desktop. Renderer-ul nu poate porni comenzi shell arbitrare: instalarea se face printr-un preset aprobat sau prin fluxul securizat desktop. Comanda, argumentele, cheile de mediu și accesul solicitat sunt afișate înainte de instalare.
Depanare
- Endpoint inaccesibil: verifică HTTPS, DNS, firewall și calea completă
/mcp. - Necesită reconectare: reînnoiește permisiunea OAuth sau secretul salvat.
- Aparține unui alt mediu: înregistrează din nou connectorul în mediul curent.
- Nu se văd unelte: verifică lista de permisiuni pentru unelte, accesul MCP și dacă serverul este activ.
- Funcționează doar pe desktop: probabil serverul folosește stdio sau o adresă locală.
