Conectarea unui client AI prin MCP
Adaugă Xuda ca server MCP la distanță în Claude, Cursor sau orice alt client compatibil MCP.
Această pagină este despre partea de client: să faci Claude, Cursor sau orice altceva care vorbește MCP să comunice cu contul tău Xuda. Pentru protocolul în sine, denumirea tool-urilor, ciclul de viață al sesiunii, forma erorilor, vezi MCP.
Ce îți trebuie
Un singur lucru: o cheie API. Creează una din zona Dezvoltatori a contului (accesul complet ajunge la
tot ce poate face proprietarul cheii, accesul personalizat ajunge doar la un set de metode din lista de permisiuni), vezi
Autentificare. Nu există o credențială MCP separată, aceeași cheie
funcționează prin REST simplu la /cpi/<method> și prin MCP.
Fiecare cheie API de cont și fiecare cheie emisă automat pentru o casetă VPS Full Stack indică aceeași
adresă: https://xuda.ai/mcp. O cheie VPS Full Stack expune în plus tool-urile plugin-urilor instalate pe acea casetă,
alături de metodele ecosistemului, vezi VPS Full Stack.
Conectează un client
Cursor își citește snippet-ul din .cursor/mcp.json (proiect) sau din setările MCP globale. Claude
Desktop și claude.ai adaugă un server la distanță din Settings, la Connectors: un nume, URL-ul și
același header Authorization. Orice alt client MCP are nevoie doar de aceleași două informații: un endpoint HTTP
streamable la https://xuda.ai/mcp și cheia la fiecare cerere, ca
Authorization: Bearer YOUR_API_KEY.
Pagina Dezvoltatori, Chei API a fiecărui cont are un card Connect sub lista de chei. Selectorul lui de format
comută un singur bloc între .env, Next.js, MCP, cURL, Node.js și PHP, fiecare completat deja cu endpoint-ul și cu prima
cheie din listă, pe care o numește antetul blocului. Formatul .env conține XUDA_MCP_URL lângă baza
REST și cheie, iar formatul MCP este comanda Claude Code de mai sus. Cheia apare mascată până o afișezi;
Copy ia întotdeauna valoarea reală.
Ce primește agentul la conectare
Prima cerere pe o conexiune nouă este un apel MCP initialize. Răspunsul Xuda conține un câmp
instructions construit din Ghidul LLM pentru Studio, același
model de documente prog, aceeași referință de atribute xu-* și aceleași reguli de flux de lucru tratate în acea pagină,
îmbinate din registrele live ale platformei, așa că nu poate descrie o regulă pe care validatorul publicat
nu o aplică de fapt. Majoritatea clienților MCP transmit instructions direct în contextul
modelului, așa că agentul știe deja cum este alcătuit un prog Studio înainte de primul
apel de tool, fără un briefing separat.
Merită apelate direct două tool-uri, în loc să te bazezi pe ce a venit la conectare:
get_studio_guide recitește orice subiect la cerere (components, tables, programs, javascript,
attributes, anatomy, gotchas), iar get_prog_examples returnează exemple de prog funcționale, selectate,
după care să modelezi un build.
Un endpoint dedicat pentru un program API
Metodele de mai sus sunt întregul catalog al contului în spatele unei chei. Când vrei ca un sistem extern
să ajungă exact la un singur endpoint al unui singur proiect, publică-l: Publică > Implementări > Server
listează Server MCP alături de Cron, Api, Node și Emitter. Pasul Setări de lansare alege unul dintre
programele api ale proiectului ca țintă, apoi pașii obișnuiți de datacenter, nivel de performanță
și denumire îl livrează ca propriul endpoint. Vezi Prima ta publicare
pentru părțile comune ale acelui asistent și API pentru ce este un program
api.
mcp este astăzi printre tipurile de implementare beta ale platformei, alături de router, android și
emitter.