Adăugarea unui server MCP propriu
Cu un server MCP propriu, conectați AI-Corporate la o aplicație internă, o sursă de date sau un 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 | Numai configurații existente | Numai configurații existente | Da | Transport învechit; pentru servere noi alegeți Streamable HTTP |
Cerințe pentru Streamable HTTP
Folosiți endpointul public complet, inclusiv calea MCP, de exemplu:
https://mcp.example.com/mcp
Endpointul trebuie să folosească HTTPS, să fie accesibil fără redirect prin DNS public și să răspundă cu un handshake MCP valid initialize. Numele de utilizator și parolele nu trebuie incluse în URL. Adresele locale, adresele din rețele private și endpointurile de metadata din cloud sunt blocate.
Adăugarea unui server
- Deschideți Preferințe → Tools.
- Alegeți Adaugă tool-uri sau Adaugă server MCP. Acest buton este vizibil doar dacă aveți acces MCP.
- Examinați presetările disponibile, potrivite pentru organizație.
- Alegeți Adaugă singur un server MCP.
- Completați numele, endpointul 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 întregul mediu prin Administrare → Tools → MCP.
Autentificare și secrete
AI-Corporate suportă OAuth pentru conectori și secrete statice. Tokenurile OAuth, tokenurile de refresh, 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 schimbă, 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 de tool-uri și guvernanță
Acordați acces doar la tool-urile de care angajații au cu adevărat nevoie. Un server MCP poate oferi acțiuni atât de citire, cât și de scriere. AI-Corporate filtrează tool-urile descoperite printr-o allowlist pe server și verifică tenantul, proprietarul și rolul la fiecare utilizare. Organizația rămâne responsabilă pentru scope-uri adecvate, logging, perioade de retenție și autorizare în sistemul sursă.
Servere locale desktop
Un server local stdio îl instalați în aplicația desktop. Rendererul nu poate porni comenzi shell arbitrare: command, argumentele, cheile de environment ș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împrospătați consimțământul OAuth sau secretul salvat.
- Ține de un 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 de 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. La un URL sau o metodă de autentificare diferită, este necesară reconectarea. O eroare într-un singur tool MCP nu înseamnă că toate tool-urile acelui server sunt inaccesibile.