Siirry sisältöön
Tarkistettu

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.

Yksi päätepiste kaikille avaimille

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

claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
{
  "mcpServers": {
    "xuda": {
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
{
  "mcpServers": {
    "xuda": {
      "type": "http",
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

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.

Hallintapaneeli kirjoittaa tämän puolestasi

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.

Beta-julkaisutyyppi

mcp on tällä hetkellä listattu alustan beta-julkaisutyyppeihin router-, android- ja emitter-tyyppien rinnalla.