AI-asiakkaan yhdistäminen MCP:llä
Lisää Xuda etä-MCP-palvelimeksi Claudelle, Cursorille tai mille tahansa muulle MCP-tietoiselle asiakkaalle.
Tämä sivu käsittelee asiakaspuolta: Clauden, Cursorin tai minkä tahansa MCP:tä puhuvan asian saamista keskustelemaan Xuda-tilisi kanssa. Itse protokollasta, työkalujen nimeämisestä, istunnon elinkaaresta ja virheen muodosta katso MCP.
Mitä tarvitset
Yhden asian: API-avaimen. Luo se tilin Kehittäjät-alueelta (täysi käyttöoikeus tavoittaa kaiken,
mitä avaimen omistaja voi, mukautettu käyttöoikeus vain sallittujen metodien joukon), katso
Todennus. Erillistä MCP-tunnistetta ei ole, sama avain toimii
tavallisen REST:n yli osoitteessa /cpi/<method> ja MCP:n yli.
Jokainen tilin API-avain ja jokaisen Full Stack VPS -laatikon oma automaattisesti myönnetty
avain osoittavat samaan osoitteeseen: https://xuda.ai/mcp. Full Stack VPS -avain paljastaa lisäksi
kyseisen laatikon asennettujen liitännäisten työkalut ekosysteemin metodien rinnalla, katso
Full Stack VPS.
Yhdistä asiakas
Cursor lukee pätkänsä tiedostosta .cursor/mcp.json (projekti) tai globaaleista MCP-asetuksistaan.
Claude Desktop ja claude.ai lisäävät etäpalvelimen kohdassa Asetukset, Connectors: nimi, URL ja
sama Authorization-otsikko. Mikä tahansa muu MCP-asiakas tarvitsee vain samat kaksi tietoa:
streamable HTTP -päätepisteen osoitteessa https://xuda.ai/mcp ja avaimen jokaisessa pyynnössä
muodossa Authorization: Bearer YOUR_API_KEY.
Jokaisen tilin Kehittäjät, API-avaimet -sivulla on Connect-kortti avainluettelon alla. Sen
muotovalitsin vaihtaa yhden lohkon välillä .env, Next.js, MCP, cURL, Node.js ja PHP, jokainen jo
täytettynä päätepisteellä ja luettelon ensimmäisellä avaimella, jonka lohkon otsikko nimeää.
.env-muoto sisältää XUDA_MCP_URL:n REST-perusosoitteen ja avaimen vieressä, ja MCP-muoto on
yllä oleva Claude Code -komento. Avain näkyy peitettynä, kunnes paljastat sen, Kopioi ottaa aina
oikean arvon.
Mitä agentti saa yhdistettäessä
Uuden yhteyden ensimmäinen pyyntö on MCP:n initialize-kutsu. Xudan vastaus sisältää
instructions-kentän, joka on rakennettu Studion LLM-oppaasta:
sama prog-dokumenttimalli, xu-*-attribuuttiviite ja työnkulun säännöt, jotka kyseisellä sivulla
käsitellään, yhdistettynä alustan omista elävistä rekistereistä, jotta se ei voi koskaan kuvata
sääntöä, jota julkaistu validaattori ei oikeasti valvo. Useimmat MCP-asiakkaat välittävät
instructions-kentän suoraan mallin kontekstiin, joten agentti tietää jo, miten Studio-prog
rakennetaan, ennen ensimmäistä työkalukutsuaan, erillistä perehdytystä ei tarvita.
Kahta työkalua kannattaa kutsua suoraan sen sijaan, että luottaisi yhdistettäessä tulleeseen:
get_studio_guide lukee minkä tahansa aiheen uudelleen pyydettäessä (components, tables,
programs, javascript, attributes, anatomy, gotchas), ja get_prog_examples palauttaa
toimivia, kuratoituja esimerkkiprogeja, joiden pohjalta rakentaa.
Oma päätepiste yhdelle API-ohjelmalle
Yllä olevat metodit ovat koko tilin katalogi yhden avaimen takana. Kun haluat ulkoisen järjestelmän
tavoittavan täsmälleen yhden projektin yhden päätepisteen, julkaise se: Julkaise > Käyttöönotot > Server
luettelee MCP-palvelin-vaihtoehdon Cronin, Apin, Noden ja Emitterin rinnalla. Sen
Käynnistysasetukset-vaihe valitsee kohteeksi yhden projektin omista api-ohjelmista, ja sitten
tavalliset datakeskus-, suoritustaso- ja nimeämisvaiheet julkaisevat sen omana päätepisteenään.
Katso Ensimmäinen julkaisusi velhon yhteisistä osista ja
API, mikä api-ohjelma on.
mcp on tällä hetkellä listattu alustan beta-julkaisutyyppeihin router-, android- ja
emitter-tyyppien rinnalla.