AI-kliens csatlakoztatása MCP-n keresztül
Adja hozzá a Xudát távoli MCP szerverként a Claude-hoz, a Cursorhoz vagy bármely más MCP-t értő klienshez.
Ez az oldal a kliensoldalról szól: hogyan beszéljen a Claude, a Cursor vagy bármi más, amely MCP-t ért, a Xuda-fiókjával. Magáról a protokollról, az eszközök elnevezéséről, a munkamenet életciklusáról és a hibák alakjáról lásd az MCP oldalt.
Mire van szüksége
Egyetlen dologra: egy API-kulcsra. Hozzon létre egyet a fiók Fejlesztők területén (a teljes hozzáférés
mindent elér, amit a kulcs tulajdonosa, az egyéni hozzáférés csak egy engedélyezőlistán szereplő
metóduskészletet), lásd Hitelesítés. Nincs külön MCP hitelesítő adat, ugyanaz a
kulcs működik egyszerű REST-en a /cpi/<method> címen és MCP-n keresztül is.
Minden fiók API-kulcsa és minden Teljes körű VPS gép saját, automatikusan kiadott kulcsa ugyanarra a
címre mutat: https://xuda.ai/mcp. A Teljes körű VPS kulcs ezen felül az adott gépre telepített bővítmény
eszközeit is kiteszi az ökoszisztéma-metódusok mellett, lásd Teljes körű VPS.
Kliens csatlakoztatása
A Cursor a kódrészletét a .cursor/mcp.json fájlból (projekt) vagy a globális MCP-beállításaiból olvassa.
A Claude Desktop és a claude.ai a Settings, majd Connectors alatt ad hozzá távoli szervert: egy nevet, az
URL-t és ugyanazt az Authorization fejlécet. Bármely más MCP-kliensnek csak ugyanez a két tény kell:
egy streamelhető HTTP-végpont az https://xuda.ai/mcp címen, és a kulcs minden kérésben
Authorization: Bearer YOUR_API_KEY formában.
Minden fiók Fejlesztők, API-kulcsok oldalán van egy Connect kártya a kulcslista alatt. A formátumválasztója
egyetlen blokkot kapcsol át .env, Next.js, MCP, cURL, Node.js és PHP között, mindegyik már kitöltve a
végponttal és a lista első kulcsával, amelyet a blokk fejléce megnevez. A .env formátum az
XUDA_MCP_URL értéket hordozza a REST alap és a kulcs mellett, az MCP formátum pedig a fenti Claude Code
parancs. A kulcs maszkolva látszik, amíg fel nem fedi; a Copy mindig a valódi értéket másolja.
Mit kap az ügynök csatlakozáskor
Az új kapcsolat első kérése egy MCP initialize hívás. A Xuda válasza egy instructions mezőt hordoz,
amely a A Studio LLM útmutatója alapján épül, ugyanazt a prog
dokumentummodellt, xu-* attribútum-referenciát és munkafolyamat-szabályokat tartalmazza, amelyek azon az
oldalon szerepelnek, a platform saját élő nyilvántartásaiból összefésülve, így soha nem írhat le olyan
szabályt, amelyet a telepített érvényesítő ténylegesen nem kényszerít ki. A legtöbb MCP-kliens az
instructions tartalmát közvetlenül a modell kontextusába továbbítja, így az ügynök már az első
eszközhívás előtt tudja, hogyan épül fel egy Studio prog, külön eligazítás nélkül.
Két eszközt érdemes közvetlenül hívni, ahelyett hogy a csatlakozáskor beérkezőre hagyatkozna: a
get_studio_guide igény szerint újraolvas bármely témát (components, tables, programs,
javascript, attributes, anatomy, gotchas), a get_prog_examples pedig működő, válogatott példa
progokat ad vissza, amelyekre egy építés mintázható.
Dedikált végpont egyetlen API-programhoz
A fenti metódusok a teljes fiók katalógusát jelentik egyetlen kulcs mögött. Ha azt szeretné, hogy egy
külső rendszer pontosan egy projekt egyetlen végpontját érje el, telepítse azt: a Telepítés >
Élesítések > Server listában az MCP szerver található a Cron, Api, Node és Emitter mellett. Az
Indítási beállítások lépése a projekt egyik saját api programját jelöli ki célként, majd a szokásos
adatközpont-, teljesítményszint- és elnevezési lépések saját végpontként élesítik. A varázsló közös
részeiről lásd Az első telepítése, arról pedig, mi az api program, az
API oldalt.
Az mcp ma a platform béta telepítési típusai között szerepel, a router, android és emitter
mellett.