MCP
Ten istý API kľúč, sprístupnený AI agentovi ako jeden typovaný nástroj na každú povolenú metódu.
Xuda prevádzkuje server Model Context Protocol na /mcp, vedľa /cpi. Pripojte k nemu agenta, ktorý
rozumie MCP, prihlásením alebo cez API kľúč, a každá metóda, ktorú tento kľúč smie volať, sa
zobrazí ako typovaný nástroj, bez samostatnej integrácie, ktorú by museli písať pre AI agentov.
Pripojenie
Existujú dva spôsoby vstupu a oba končia na tom istom mieste: pri právach API kľúča.
Prihlásenie (konektory Claude a ďalší klienti OAuth)
Pridajte https://xuda.ai/mcp ako vlastný konektor v Claude (Nastavenia, Konektory, Pridať
vlastný konektor), ponechajte id klienta a tajomstvo OAuth prázdne a stlačte Pripojiť. Claude
otvorí Xuda: prihláste sa, ak ešte nie ste, a okno v dashboarde sa opýta, ktorý z vašich API kľúčov
bude pripojenie používať. Vyberte jeden a stlačte Pripojiť. Claude na webe, v aplikácii pre
počítač, v mobile a Cowork zdieľajú toto pripojenie a každý ďalší účet Claude ho pridá rovnako.
Karta Vývojári, MCP v dashboarde ukazuje adresu na vloženie, tieto kroky a všetko nižšie.
Claude Code sa prihlasuje rovnako, keď pridáte server bez hlavičky, potom spustite /mcp a vyberte
Authenticate:
Pripojenie nikdy nemá vlastné práva. Každé volanie nástroja beží ako kľúč, ktorý ste vybrali, takže režim prístupu kľúča, jeho zoznam povolených a jeho odvolanie sú aj pripojenia: odvolajte kľúč v Vývojári, API kľúče a pripojenie sa zastaví a ďalšie prihlásenie si vypýta iný kľúč. Stránka uvádza len vaše vlastné aktívne kľúče. Ak žiadne nemáte, najprv jeden vytvorte.
Pre vývojárov klientov server dodržiava špecifikáciu autorizácie MCP:
Volanie /mcp bez použiteľného tokenu odpovie 401 s WWW-Authenticate: Bearer resource_metadata="...", vďaka čomu klient nájde zvyšok. Prístupové tokeny platia hodinu, obnovovacie
tokeny 90 dní a pri každom použití sa nahradia. Presmerovací URI na slučku (http://localhost alebo
http://127.0.0.1) sa zhoduje na ľubovoľnom porte.
API kľúč v hlavičke
Kľúč ide v hlavičke Authorization: Bearer, rovnaký kľúč, aký by ste použili ako api_key na
/cpi. Samostatný prístupový údaj MCP neexistuje. Požiadavka bez hlavičky Authorization alebo s
kľúčom, ktorý sa nepreloží na aktívny dokument xuda_api_keys, je odmietnutá s 401 skôr, než sa
zaregistruje akýkoľvek nástroj.
Relácie
Transport je streamovateľné HTTP: prvá požiadavka je volanie MCP initialize, ktoré otvorí reláciu
a vráti hlavičku mcp-session-id. Každá ďalšia požiadavka na tomto pripojení nesie rovnakú hlavičku
a rovnaký prístupový údaj. Relácia sa zatvorí po 10 minútach bez požiadavky. Požiadavka na zatvorenú
reláciu odpovie 404 a klient MCP potom sám začne novú reláciu.
Čo sa stane nástrojom
Nástroje sa registrujú na začiatku relácie z rovnakého režimu prístupu, aký kľúč už má:
- Plný prístup: každá metóda katalógu, ktorá nie je
private, sa zaregistruje ako nástroj, vyhodnotená pri pripojení, takže metóda pridaná po vytvorení kľúča je dostupná bez akejkoľvek zmeny samotného kľúča. - Vlastný prístup: zaregistrujú sa len metódy zo zoznamu povolených kľúča.
Bežiaca relácia drží krok so svojím kľúčom: kontroluje kľúč každú minútu a moduly a pluginy za ním
každých päť minút, a keď sa sada nástrojov zmení, pošle notifications/tools/list_changed. Klient,
ktorý počúva (Claude počúva), prečíta nový zoznam bez opätovného pripojenia, takže metóda, ktorú
na kľúči povolíte, dosiahne agenta, ktorý je už pripojený.
Každý nástroj si zachová tvar metódy: názov nástroja je názov metódy (get_account_projects,
dbs_read, ...), jeho titulok je názov metódy v Title Case, jeho popis je vlastný description
metódy a jeho vstupná schéma sa skladá pole po poli z fields metódy, povinné polia zostávajú
povinné, všetko ostatné je voliteľné. Pole bez rozpoznaného typu sa stále stane voľným argumentom
nástroja, namiesto toho, aby pokazilo celú reláciu, takže jedna zvláštne špecifikovaná metóda nikdy
neznefunkční zvyšok katalógu.
Kľúč obmedzený na Plnohodnotný VPS sprístupňuje popri metódach ekosystému vyššie aj nainštalované nástroje pluginov tohto servera, takže agent v jednej relácii dosiahne platformu aj všetko, čo vývojár na serveri vytvoril. Pozri Full Stack VPS.
Volanie nástroja
Agent volá nástroj s rovnakými argumentmi, aké popisujú polia metódy. Xuda odpovie tak, že
metódu zavolá interne, rovnako ako by to urobilo /cpi/<method>, a nástroju vráti obálku metódy
{code, data} ako text. Zlyhané volanie sa na vrstve MCP stále vráti normálne, kód -1 a vyššie sa
v výsledku nástroja zobrazí presne tak, ako by sa zobrazil pri obyčajnom volaní REST, takže ho agent
číta rovnako ako vaše vlastné spracovanie chýb. Pozri Errors.
Požiadavka, ktorá zlyhá skôr, než sa spustí akýkoľvek nástroj, chýbajúci alebo odmietnutý
prístupový údaj (401), zatvorená relácia (404, kód -32001), poškodená správa MCP, sa vráti
ako chyba JSON-RPC namiesto výsledku nástroja: