Preskočiť na obsah
Overené

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.

Jeden koncový bod pre každý kľúč

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

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 čí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.

Dashboard to napíše za vás

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.

Beta typ nasadenia

mcp je dnes uvedený medzi beta typmi nasadenia platformy, popri router, android a emitter.