Adăugarea unui server MCP propriu
Cu un server MCP propriu conectați AI-Public la un sistem de gestionare a cazurilor, arhivă, sursă de date sau alt serviciu specializat. Alegeți mai întâi transportul potrivit pentru locul de utilizare.
Alegeți 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ți Streamable HTTP |
Cerințe pentru Streamable HTTP
Folosiți endpoint-ul public complet, inclusiv calea MCP, de exemplu:
https://mcp.organisatie.nl/mcp
Endpoint-ul trebuie să folosească HTTPS, să fie accesibil fără redirecționare prin DNS public și să răspundă cu un handshake MCP initialize valid. Numele de utilizator și parolele nu trebuie să fie în URL. Adresele locale, adresele din rețele private și endpoint-urile de metadate cloud sunt blocate.
Adăugarea unui server
- Deschideți Preferințe → Tools.
- Alegeți Adăugați un tool sau Adăugați un server MCP.
- Consultați presetările disponibile.
- Selectați Adăugați un server MCP propriu.
- Completați numele, endpoint-ul complet și metoda de autentificare.
- Salvați configurația și așteptați verificarea conexiunii.
- Activați serverul pentru setul dvs. standard de unelte.
Un administrator poate înregistra un server pentru întreaga organizație prin Administrare → Tools → MCP.
Autentificare și secrete
AI-Public suportă OAuth pentru conectori ș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 și securitatea informațiilor
Permiteți doar uneltele de care utilizatorii au cu adevărat nevoie. Un server MCP poate oferi acțiuni de citire și scriere. AI-Public filtrează uneltele descoperite conform unei liste de permisiuni pe server și verifică mediul, proprietarul și rolul la fiecare utilizare. Organizația rămâne responsabilă pentru scope-urile adecvate, logare, perioadele de păstrare și autorizarea în sistemul sursă.
Servere desktop locale
Un server stdio local se instalează în aplicația desktop. Comanda, argumentele, cheile de mediu și accesul solicitat sunt limitate și afișate înainte de aprobare. Secretele sunt criptate local.
Depanare
- Endpoint inaccesibil: verificați HTTPS, DNS, firewall și calea completă
/mcp. - Este necesară reconectarea: reînnoiți permisiunea OAuth sau secretul salvat.
- Aparține unui alt mediu: înregistrați conectorul din nou în mediul curent.
- Nu se văd unelte: verificați lista de permisiuni, accesul pe rol și starea activă.
- Funcționează doar pe desktop: probabil serverul folosește stdio sau o adresă locală.
