Přeskočit na obsah
Ověřeno

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.

Jeden koncový bod pro každý klíč

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

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

Přehled to napíše za vás

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.

Beta typ nasazení

mcp je dnes uveden mezi beta typy nasazení platformy, vedle router, android a emitter.