Adăugarea unui server MCP propriu
Cu un server MCP propriu, conectați AI-Public la un sistem de gestionare a dosarelor, o arhivă, o sursă de date sau un alt serviciu specializat. Alegeți mai întâi transportul potrivit pentru locul de utilizare.
Alegeți transportul potrivit
| 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; alegeți Streamable HTTP pentru servere noi |
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 prin DNS public fără redirect și să răspundă la un handshake MCP initialize valid. Numele de utilizator și parolele nu trebuie incluse în URL. Adresele locale, adresele private de rețea și endpoint-urile de metadata cloud sunt blocate.
Adăugarea unui server
- Deschideți Preferințe → Tools.
- Alegeți Adaugă Tools sau Adaugă server MCP. Acest buton este vizibil doar dacă aveți acces MCP.
- Consultați presetările disponibile.
- Alegeți Adăugați singur un server MCP.
- Introduceț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. implicit de tool-uri.
Un administrator poate înregistra un server pentru întreaga organizație prin Administrare → Tools → MCP.
Autentificare și secrete
AI-Public acceptă 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 înregistrat, niciodată configurația secretă.
Dacă URL-ul sau autentificarea se modifică, 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ă când problema este rezolvată.
Drepturi pentru tool-uri și securitatea informațiilor
Activați doar tool-urile de care utilizatorii au nevoie cu adevărat. Un server MCP poate oferi atât acțiuni de citire, cât și de scriere. AI-Public filtrează tool-urile descoperite printr-o allowlist pe server și verifică mediul, proprietarul și rolul la fiecare utilizare. Organizația rămâne responsabilă pentru scope-uri, jurnalizare, termene de păstrare și autorizare adecvate în sistemul sursă.
Servere desktop locale
Un server stdio local se instalează în aplicația desktop. Command, argumentele, environment keys și accesul solicitat sunt limitate și afișate înainte de aprobare. Secretele sunt criptate local.
Depanare
- Endpoint inaccesibil: verificați HTTPS, DNS, firewall-ul și calea completă
/mcp. - Este necesară reconectarea: reînnoiți consimțământul OAuth sau secretul salvat.
- Aparține unui alt mediu: înregistrați din nou conectorul în mediul curent.
- Nu se văd tool-uri: verificați allowlist-ul, accesul pe roluri și starea 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ă: lăsați câmpul cheii gol pentru a o păstra. Dacă URL-ul sau metoda de autentificare este diferită, este necesară o reconectare. O eroare într-un singur tool MCP nu înseamnă că toate tool-urile acelui server sunt inaccesibile.