Sari la conținutul principal

Adăugarea unui server MCP propriu

Cu un server MCP propriu, conectezi AI-School la propria aplicație, sursă de date sau serviciu specializat. Alege mai întâi transportul potrivit pentru locul de utilizare.

Alege transportul potrivit​

TransportWebMobilDesktopUtilizare
Streamable HTTPDaDaDaRecomandat pentru servere găzduite
stdioNuNuDaProcese locale și integrări desktop
SSEDoar configurații existenteDoar configurații existenteDaTransport învechit; pentru servere noi alege Streamable HTTP

Cerințe pentru Streamable HTTP​

Folosește endpointul public complet, inclusiv calea MCP, de exemplu:

https://mcp.example.nl/mcp

Endpointul trebuie să:

  • folosească HTTPS;
  • funcționeze fără nume de utilizator sau parolă în URL;
  • nu necesite redirecționare;
  • fie accesibil prin DNS public;
  • răspundă cu un handshake MCP initialize valid;
  • aibă un set explicit de instrumente permise.

Adresele locale, adresele din rețele private și endpointurile de metadate cloud sunt blocate. Prin urmare, nu poți înregistra un server pe localhost din aplicația web.

Adăugarea unui server​

  1. Deschide Preferințe → Instrumente.
  2. Alege Adaugă instrumente sau Adaugă server MCP. Vezi acest buton doar dacă ai acces MCP.
  3. Consultă mai întâi presetările disponibile.
  4. Alege Adaugă singur un server MCP.
  5. Completează numele, endpointul complet și metoda de autentificare.
  6. Salvează configurația și așteaptă verificarea conexiunii.
  7. Activează serverul pentru setul tău implicit de instrumente.

Un administrator poate înregistra și un server pentru întregul mediu prin Administrare → Setări AI → Instrumente → MCP.

Autentificare și secrete​

AI-School suportă OAuth pentru conectori și secrete statice. Tokenurile OAuth, tokenurile de reîmprospătare, cheile API și parolele sunt stocate doar pe server. Un chat primește doar connectorId-ul înregistrat, niciodată configurația secretă.

La o URL sau autentificare modificată, noua configurație este verificată din nou mai întâi. Dacă această verificare eșuează, o configurație aprobată anterior poate rămâne activă până la rezolvarea problemei.

Drepturi pentru instrumente​

Oferă acces doar la instrumentele de care utilizatorii au nevoie cu adevărat. Un server MCP poate oferi acțiuni de citire și scriere, cum ar fi ștergerea fișierelor, trimiterea de e-mailuri sau modificarea înregistrărilor. AI-School filtrează instrumentele descoperite prin allowlist-ul de pe server, dar administratorul serverului rămâne responsabil pentru scope-uri și autorizare adecvate.

Testare locală​

Un server stdio local îl testezi în aplicația desktop. Rendererul nu poate porni comenzi shell arbitrare: instalarea are loc printr-un preset aprobat sau fluxul desktop securizat. Comanda, argumentele, cheile de mediu și accesul solicitat sunt afișate înainte de instalare.

Depanare​

  • Endpointul nu este accesibil: verifică HTTPS, DNS, firewall-ul și calea completă /mcp.
  • Este necesară reconectarea: reînnoiește consimțământul OAuth sau secretul salvat.
  • Ține de un alt mediu: înregistrează din nou conectorul în mediul actual.
  • Nu se văd instrumente: verifică allowlist-ul instrumentelor, accesul tău MCP și dacă serverul este activ.
  • Funcționează doar pe desktop: probabil serverul folosește stdio sau o adresă locală.

Resurse pentru dezvoltare​

Vezi și​

La editare, configurația serverului înregistrat este preluată. Cheia salvată rămâne ascunsă: lasă câmpul cheii gol pentru a o păstra. La o URL sau metodă de autentificare diferită, este necesară o reconectare. O eroare într-un instrument MCP nu înseamnă că toate instrumentele de pe acel server sunt indisponibile.

Pe această pagină