MCP
Aceeași cheie API, expusă unui agent AI ca un instrument tipizat pentru fiecare metodă permisă.
Xuda rulează un server Model Context Protocol la /mcp, lângă /cpi. Conectează la el un agent
compatibil MCP, autentificându-te sau cu o cheie API, și fiecare metodă pe care are voie să o apeleze
acea cheie apare ca un instrument tipizat, fără nicio integrare separată de scris pentru agenții AI.
Conectarea
Există două moduri de a intra și ambele ajung în același loc: drepturile unei chei API.
Autentifică-te (conectori Claude și alți clienți OAuth)
Adaugă https://xuda.ai/mcp ca un custom connector în Claude (Settings, Connectors, Add
custom connector), lasă goale ID-ul și secretul clientului OAuth și apasă Conectează. Claude
deschide Xuda: autentifică-te dacă nu ești deja, iar o fereastră din dashboard te întreabă ca care
dintre cheile tale API acționează conexiunea; alege una și apasă Conectează. Claude pe web,
Desktop, mobil și Cowork împart acea conexiune, iar orice alt cont Claude o adaugă la fel. Fila
Dezvoltatori, MCP din dashboard arată adresa de lipit, acești pași și tot ce urmează mai jos.
Claude Code se autentifică în același mod când adaugi serverul fără antet, apoi rulezi /mcp și
alegi Authenticate:
Conexiunea nu are niciodată drepturi proprii. Fiecare apel de instrument rulează ca cheia pe care ai ales-o, așa că modul de acces al cheii, lista ei de permisiuni și revocarea ei sunt și ale conexiunii: revocă cheia în Dezvoltatori, Chei API și conexiunea se oprește, iar următoarea autentificare cere o altă cheie. Pagina listează doar propriile tale chei active; dacă nu ai niciuna, creează mai întâi una.
Pentru dezvoltatorii de clienți MCP, serverul urmează specificația de autorizare MCP:
Un apel la /mcp fără un token utilizabil răspunde cu 401 și WWW-Authenticate: Bearer resource_metadata="...", iar așa găsește un client restul. Tokenurile de acces durează o oră;
tokenurile de reîmprospătare durează 90 de zile și sunt înlocuite la fiecare utilizare. Un URI de
redirecționare loopback (http://localhost sau http://127.0.0.1) se potrivește pe orice port.
O cheie API într-un antet
Cheia merge într-un antet Authorization: Bearer, aceeași cheie pe care ai folosi-o ca api_key la
/cpi. Nu există o credențială MCP separată. O cerere fără antet Authorization sau cu o cheie care
nu se rezolvă la un document xuda_api_keys activ este refuzată cu 401 înainte să fie înregistrat
vreun instrument.
Sesiuni
Transportul este HTTP în flux: prima cerere este un apel MCP initialize, care deschide o sesiune și
returnează un antet mcp-session-id; fiecare cerere următoare din acea conexiune poartă același
antet și aceeași credențială. O sesiune se închide după 10 minute fără nicio cerere. O cerere pe o
sesiune închisă primește răspuns 404, iar un client MCP pornește apoi singur o sesiune nouă.
Ce devine instrument
Instrumentele se înregistrează la începutul sesiunii, pe baza modului de acces pe care îl are deja cheia:
- Acces complet: fiecare metodă din catalog care nu este
privatese înregistrează ca instrument, rezolvată la momentul conectării, astfel că o metodă adăugată după crearea cheii este disponibilă fără nicio schimbare a cheii însăși. - Acces personalizat: se înregistrează doar metodele din lista de permisiuni a cheii.
O sesiune activă ține pasul cu cheia ei: verifică cheia în fiecare minut, iar modulele și pluginurile
din spatele ei la fiecare cinci, iar când setul de instrumente s-a schimbat trimite
notifications/tools/list_changed. Un client care ascultă (Claude o face) citește noua listă fără să
se reconecteze, așa că o metodă pe care o permiți pe cheie ajunge la un agent deja conectat.
Fiecare instrument păstrează forma metodei: numele instrumentului este numele metodei
(get_account_projects, dbs_read, ...), titlul lui este numele metodei în Title Case, descrierea
lui este propriul description al metodei, iar schema lui de intrare este construită câmp cu câmp din
fields ale metodei; câmpurile obligatorii rămân obligatorii, restul sunt opționale. Un câmp cu un
tip nerecunoscut devine tot un argument permisiv al instrumentului, în loc să strice întreaga sesiune,
așa că o metodă specificată ciudat nu doboară niciodată restul catalogului.
O cheie limitată la un VPS Full Stack expune și instrumentele de plugin instalate pe acea mașină, alături de metodele ecosistemului de mai sus, astfel că un agent poate atinge atât platforma, cât și orice a construit dezvoltatorul pe mașină, într-o singură sesiune. Vezi VPS Full Stack.
Apelarea unui instrument
Un agent apelează un instrument cu aceleași argumente pe care le descriu câmpurile metodei. Xuda
răspunde apelând metoda intern, la fel cum ar face /cpi/<method>, și returnează instrumentului
plicul {code, data} al metodei, ca text. Un apel eșuat revine totuși normal la nivelul MCP, codul
-1 și peste el apare în rezultatul instrumentului exact cum ar apărea dintr-un apel REST simplu,
așa că un agent îl citește la fel cum l-ar citi tratarea ta de erori. Vezi Erori.
O cerere care eșuează înainte să ruleze vreun instrument, o credențială lipsă sau refuzată (401),
o sesiune care s-a închis (404, cod -32001), un mesaj MCP malformat, revine ca o eroare
JSON-RPC, nu ca rezultat de instrument: