Pripojenie AI klienta cez MCP
Pridajte Xuda ako vzdialený server MCP do Claude, Cursor alebo iného klienta podporujúceho MCP.
Táto stránka je o strane klienta: ako prinútiť Claude, Cursor alebo čokoľvek iné, čo hovorí MCP, komunikovať s vaším účtom Xuda. Samotný protokol, pomenovanie nástrojov, životný cyklus relácie a tvar chýb nájdete v MCP.
Čo potrebujete
Jednu vec: API kľúč. Vytvorte ho v oblasti Vývojári vášho účtu (plný prístup siaha na všetko, čo
vlastník kľúča môže, vlastný prístup len na povolenú sadu metód), pozrite si
Autentifikácia. Neexistuje samostatné poverenie pre MCP, ten istý kľúč
funguje cez obyčajné REST na /cpi/<method> aj cez MCP.
Každý API kľúč účtu a každý automaticky vydaný kľúč boxu Plnohodnotný VPS mieri na rovnakú adresu:
https://xuda.ai/mcp. Kľúč Plnohodnotný VPS navyše popri metódach ekosystému sprístupňuje nástroje
pluginov nainštalovaných na tomto boxe, pozrite si Full Stack VPS.
Pripojte klienta
Cursor číta svoj úryvok z .cursor/mcp.json (projekt) alebo zo svojich globálnych nastavení MCP.
Claude Desktop a claude.ai pridávajú vzdialený server v Nastaveniach, v časti Connectors: názov, URL
a ten istý hlavičkový údaj Authorization. Každý iný klient MCP potrebuje len tie isté dva údaje:
koncový bod streamable HTTP na https://xuda.ai/mcp a kľúč pri každej požiadavke ako
Authorization: Bearer YOUR_API_KEY.
Stránka Vývojári, API kľúče každého účtu má pod zoznamom kľúčov kartu Pripojenie. Jej výber formátu
prepína jeden blok medzi .env, Next.js, MCP, cURL, Node.js a PHP, každý už vyplnený koncovým bodom
a prvým kľúčom v zozname, ktorý pomenúva hlavička bloku. Formát .env nesie XUDA_MCP_URL vedľa
základu REST a kľúča a formát MCP je príkaz Claude Code vyššie. Kľúč sa zobrazuje zamaskovaný, kým
ho neodkryjete; Kopírovať vždy vezme skutočnú hodnotu.
Čo agent získa pri pripojení
Prvou požiadavkou na novom pripojení je volanie MCP initialize. Odpoveď Xuda nesie pole
instructions zostavené zo Sprievodca Studio LLM, z
rovnakého dokumentového modelu progu, referencie atribútov xu-* a pravidiel pracovných postupov,
ktoré sú na tej stránke, zlúčených z vlastných živých registrov platformy, takže nikdy nemôže opísať
pravidlo, ktoré nasadený validátor skutočne nevynucuje. Väčšina klientov MCP posiela instructions
priamo do kontextu modelu, takže agent už pred prvým volaním nástroja vie, ako je prog Studia
poskladaný, bez samostatného zaškolenia.
Dva nástroje stojí za to volať priamo, namiesto spoliehania sa na to, čo prišlo pri pripojení:
get_studio_guide znova prečíta ľubovoľnú tému na požiadanie (components, tables, programs,
javascript, attributes, anatomy, gotchas) a get_prog_examples vráti funkčné, vybrané
ukážkové proggy, podľa ktorých sa dá stavať.
Vyhradený koncový bod pre jeden program API
Metódy vyššie sú celý katalóg účtu za jedným kľúčom. Keď chcete, aby externý systém siahal presne na
jeden koncový bod jedného projektu, nasaďte ho: Nasadiť > Nasadenia > Server uvádza Server MCP
popri Cron, Api, Node a Emitter. Jeho krok Nastavenia spúšťania vyberie ako cieľ jeden z vlastných
programov api projektu a potom obvyklé kroky dátového centra, výkonnostnej úrovne a pomenovania ho
vydajú ako vlastný koncový bod. Spoločné časti tohto sprievodcu nájdete v
Vaše prvé nasadenie a čo je program api v
API.
mcp je dnes uvedený medzi beta typmi nasadenia platformy, popri router, android a
emitter.