Documentație
Conectarea sistemelor tale (MCP)
Pe această pagină
Un asistent care doar vorbește este util; un asistent care poate face lucruri este un produs. Busymate AI îi permite amicului tău să apeleze uneltele tale, prin propriul server MCP, ca să caute informații și să facă schimbări în sistemele tale în numele utilizatorilor, după regulile stabilite de tine.
MCP (Model Context Protocol) este un standard deschis pentru expunerea uneltelor către un AI. Dacă sistemele tale folosesc deja MCP, amicul tău se conectează la ele la fel ca la oricare altele — fără cod de integrare specific platformei.
Cum acționează amicul tău asupra datelor utilizatorilor
Când asistentul trebuie să facă ceva, apelează o unealtă de pe serverul tău MCP. Două lucruri fac acest proces sigur:
- Amicul tău îi spune serverului cine este utilizatorul, printr-un token cu durată scurtă, semnat criptografic, pe care serverul îl verifică. Nu poate fi falsificat sau reutilizat, astfel încât serverul știe întotdeauna exact pentru care utilizator este cererea.
- Serverul tău aplică domeniul de acces. Deoarece MCP cunoaște utilizatorul, returnează și schimbă doar datele acelei persoane. Amicul tău nu vede niciodată mai mult decât îi oferă serverul tău.
Niveluri de permisiune
Fiecare unealtă pe care o expui primește un nivel, astfel încât asistentul să ajungă doar la ceea ce este potrivit pentru persoana care solicită:
| Nivel | Pentru cine | Ce permite |
|---|---|---|
| Public | Oricine, inclusiv vizitatorii | Citiri sigure, nepersonale — informații despre produs și ajutor general. |
| Identificat | Un utilizator autentificat | Citiri și acțiuni numai asupra propriilor date. |
| Delegat | Un utilizator autentificat, pentru acțiuni care cer autorizarea lui | Aceleași operațiuni, atunci când vrei autorizarea explicită a utilizatorului. |
| Confirmare | Orice acțiune de scriere marcată de tine | Utilizatorul trebuie să confirme înainte de executare; acțiunea completă este afișată mai întâi. |
Operațiunile distructive sau sensibile sunt protejate prin confirmare: amicul tău arată exact ce urmează să facă și așteaptă un „da” uman. Nimic nu scrie în tăcere.
Configurare
Secțiunea Integrare din Consola Busymate AI este sursa de adevăr pentru această configurare. Este generată din configurația activă a spațiului de lucru selectat, astfel încât URL-urile, valorile de identitate, fragmentele și lista de publicare rămân actuale — nu există un document separat de predare care să se poată învechi.
- Deschide Consolă → Integrare și selectează spațiul de lucru pe care îl configurezi.
- Urmează pasul MCP către Conexiuni, adaugă URL-ul serverului și asocierea acreditărilor, apoi rulează verificarea.
- Verifică fiecare unealtă descoperită și atribuie în mod deliberat politicile Public, Identificat, Delegat și Confirmare.
- Rulează verificarea preliminară și publică revizia spațiului de lucru. O verificare eșuată sau un contract de identitate incomplet blochează publicarea în loc să creeze un asistent conectat doar pe jumătate.
Secțiunea Integrare oferă și instrucțiuni de automatizare gata de copiat și endpointul MCP de administrare Busymate AI pentru echipele care vor ca un agent să execute același flux limitat la spațiul de lucru. Vezi Primii pași.
Conectează Claude Code la MCP-ul de administrare
O singură comandă; browserul se ocupă de autentificarea cu contul tău obișnuit (OAuth 2.1 — nu se lipește nimic):
claude mcp add --transport http busymate-ai https://busymate.ai/mcpApoi rulează /mcp în Claude Code și alege busymate-ai → Autentificare. Orice alt client HTTP-MCP (Claude Desktop, Cursor, …) se conectează doar cu URL-ul https://busymate.ai/mcp — descoperirea OAuth este servită atât la endpoint, cât și la origine, așa că nu e nevoie de nicio configurare pe client în afară de URL.
Utilizatorii își conectează propriile conturi
Delegarea OAuth pentru fiecare utilizator este disponibilă conectorilor white-label. Folosește-o când fiecare utilizator trebuie să-și autorizeze propriul cont într-un serviciu pe care nu îl operezi. Configurează în Conexiuni metadatele OAuth de autorizare, token și revocare ale conectorului, apoi publică uneltele delegate.
Uneltele delegate pentru cont acceptă două moduri explicite:
- Token de actor client semnat — recomandat când produsul tău a verificat deja vizitatorul. Busymate AI emite pentru serverul MCP un token de actor cu durată scurtă, legat de spațiul de lucru și conector, astfel încât accesul la cont este automat și clientul nu vede o a doua autentificare sau o nouă cerere de consimțământ.
- OAuth pentru fiecare client autentificat — folosește-l când o autorizare separată este intenționată. Asistentul arată o singură dată Autorizează uneltele contului, folosește fluxul de cod de autorizare OAuth 2.1 cu PKCE și leagă autorizarea pe server de spațiul de lucru, conector și utilizatorul final verificat.
Ambele moduri refuză în siguranță. Serverul MCP identifică clientul numai din bearer-ul verificat și nu are niciodată încredere într-un ID de cont furnizat în argumentele unei unelte. Autorizările OAuth pot fi revocate din meniul contului; tokenurile de actor semnate expiră în cel mult cinci minute și sunt legate de un singur conector.
Următorul pas
- Primii pași — unde se conectează MCP-ul tău.
- Guvernanță și politica modelelor — activează uneltele și stabilește regulile de confirmare.
- Experiența asistentului — vezi cum apar acțiunile pentru un utilizator.
- Pune cunoștințele site-ului tău la dispoziție prin MCP — publică unelte de documentație doar pentru citire, iar amicul tău răspunde din ele în loc să-ți parcurgă site-ul.