Připojení AI klienta přes MCP
Přidejte Xudu jako vzdálený server MCP do Claude, Cursoru nebo jakéhokoli jiného klienta s podporou MCP.
Tato stránka se týká strany klienta: jak přimět Claude, Cursor nebo cokoli jiného, co mluví MCP, ke komunikaci s vaším účtem Xuda. Samotný protokol, pojmenování nástrojů, životní cyklus relace a tvar chyb najdete v MCP.
Co potřebujete
Jednu věc: klíč API. Vytvořte ho v oblasti Vývojáři svého účtu (plný přístup dosáhne na vše, na co
dosáhne vlastník klíče, vlastní přístup jen na povolenou sadu metod), viz
Ověřování. Žádné samostatné přihlašovací údaje pro MCP neexistují:
stejný klíč funguje přes běžné REST na /cpi/<method> i přes MCP.
Každý klíč API účtu i automaticky vydaný klíč každého boxu Full-stack VPS míří na stejnou adresu:
https://xuda.ai/mcp. Klíč Full-stack VPS navíc vedle metod ekosystému zpřístupňuje i nástroje
pluginů nainstalovaných na tomto boxu, viz Full-stack VPS.
Připojení klienta
Cursor čte svůj úryvek z .cursor/mcp.json (projekt) nebo ze svých globálních nastavení MCP.
Claude Desktop a claude.ai přidávají vzdálený server v Nastavení, v části Konektory: název, URL
a stejná hlavička Authorization. Jakýkoli jiný klient MCP potřebuje jen tytéž dvě informace:
streamovatelný koncový bod HTTP na https://xuda.ai/mcp a klíč u každého požadavku jako
Authorization: Bearer YOUR_API_KEY.
Stránka Vývojáři, Klíče API u každého účtu má pod seznamem klíčů kartu Připojit. Výběr formátu
přepíná jeden blok mezi .env, Next.js, MCP, cURL, Node.js a PHP, každý už vyplněný koncovým bodem
a prvním klíčem v seznamu, který pojmenovává hlavička bloku. Formát .env nese XUDA_MCP_URL vedle
základu REST a klíče a formát MCP je příkaz pro Claude Code výše. Klíč je zobrazen maskovaně, dokud
ho neodhalíte; Kopírovat vždy vezme skutečnou hodnotu.
Co agent dostane při připojení
První požadavek na novém spojení je volání MCP initialize. Odpověď Xudy nese pole instructions
sestavené z Průvodce Studia pro LLM, tedy téhož dokumentového
modelu programů, reference atributů xu-* a pravidel workflow, které popisuje ta stránka,
sloučených z živých registrů platformy, takže nemůže popsat pravidlo, které nasazený validátor
ve skutečnosti nevynucuje. Většina klientů MCP předává instructions přímo do kontextu modelu,
takže agent už před prvním voláním nástroje ví, jak je program Studia poskládán, bez samostatného
zaškolení.
Dva nástroje stojí za to volat přímo, místo spoléhání na to, co přišlo při připojení:
get_studio_guide znovu přečte kterékoli téma na požádání (components, tables, programs,
javascript, attributes, anatomy, gotchas) a get_prog_examples vrací funkční, vybrané
ukázkové programy, podle kterých lze stavět.
Vyhrazený koncový bod pro jeden program API
Výše uvedené metody jsou celý katalog účtu za jedním klíčem. Když chcete, aby externí systém
dosáhl přesně na jeden koncový bod jednoho projektu, nasaďte ho: Nasadit > Nasazení > Server
uvádí MCP server vedle Cron, Api, Node a Emitter. Jeho krok Nastavení spuštění vybere jeden
z vlastních programů api projektu jako cíl a obvyklé kroky datového centra, výkonnostní úrovně
a pojmenování ho pak vydají jako samostatný koncový bod. Společné části průvodce viz
Vaše první nasazení a co je program api, viz
API.
mcp je dnes uveden mezi beta typy nasazení platformy, vedle router, android a emitter.