MCP
Stejný klíč API, zpřístupněný AI agentovi jako jeden typovaný nástroj na každou povolenou metodu.
Xuda provozuje server Model Context Protocol na /mcp, vedle /cpi. Připojte k němu agenta s
podporou MCP, přihlášením nebo klíčem API, a každá metoda, kterou smí klíč volat, se objeví jako
typovaný nástroj, bez samostatné integrace, kterou by pro AI agenty bylo nutné psát.
Připojení
Cesty dovnitř jsou dvě a obě končí na stejném místě: u práv klíče API.
Přihlášení (konektory Claude a další klienti OAuth)
Přidejte https://xuda.ai/mcp jako vlastní konektor v Claude (Nastavení, Konektory,
Přidat vlastní konektor), nechte id klienta OAuth a tajný klíč prázdné a stiskněte
Připojit. Claude otevře Xuda: přihlaste se, pokud ještě nejste, a okno v dashboardu se zeptá,
jako který z vašich klíčů API bude připojení jednat. Vyberte jeden a stiskněte Připojit.
Claude na webu, v aplikaci pro počítač, v mobilu a Cowork sdílejí toto připojení a každý jiný účet
Claude ho přidá stejným způsobem. Karta Vývojáři, MCP v dashboardu ukazuje adresu k vložení,
tyto kroky i vše níže.
Claude Code se přihlašuje stejně, když server přidáte bez hlavičky, pak spusťte /mcp a
zvolte Authenticate:
Připojení nemá nikdy vlastní práva. Každé volání nástroje běží jako klíč, který jste vybrali, takže režim přístupu klíče, jeho seznam povolených metod i jeho odvolání platí i pro připojení: odvolejte klíč v části Vývojáři, Klíče API a připojení se zastaví a další přihlášení požádá o jiný klíč. Stránka uvádí jen vaše vlastní aktivní klíče, pokud žádný nemáte, nejdřív ho vytvořte.
Pro vývojáře klientů server dodržuje specifikaci autorizace MCP:
Volání /mcp bez použitelného tokenu odpoví 401 s WWW-Authenticate: Bearer resource_metadata="...", podle čehož klient najde zbytek. Přístupové tokeny platí hodinu,
obnovovací tokeny 90 dní a při každém použití se vymění. Adresa přesměrování na loopback
(http://localhost nebo http://127.0.0.1) odpovídá na libovolném portu.
Klíč API v hlavičce
Klíč jde v hlavičce Authorization: Bearer, je to stejný klíč, který byste použili jako api_key
na /cpi. Samostatný přihlašovací údaj MCP neexistuje. Požadavek bez hlavičky Authorization
nebo s klíčem, který nevede na aktivní dokument xuda_api_keys, se odmítne s 401 dřív, než se
zaregistruje jakýkoli nástroj.
Relace
Přenos je streamovatelné HTTP: první požadavek je volání MCP initialize, které otevře relaci a
vrátí hlavičku mcp-session-id. Každý další požadavek na tomto připojení nese stejnou hlavičku a
stejný přihlašovací údaj. Relace se zavře po 10 minutách bez požadavku. Požadavek na zavřenou
relaci odpoví 404 a klient MCP pak sám založí novou relaci.
Co se stane nástrojem
Nástroje se registrují na začátku relace podle režimu přístupu, který klíč už má:
- Plný přístup: každá metoda v katalogu, která není
private, se zaregistruje jako nástroj, vyhodnocená při připojení, takže metoda přidaná po vytvoření klíče je dostupná bez jakékoli změny samotného klíče. - Vlastní přístup: zaregistrují se jen metody ze seznamu povolených u klíče.
Běžící relace drží krok se svým klíčem: každou minutu se podívá na klíč a každých pět minut na
moduly a pluginy za ním, a když se sada nástrojů změnila, pošle notifications/tools/list_changed.
Klient, který naslouchá (Claude ano), načte nový seznam bez opětovného připojení, takže metoda,
kterou na klíči povolíte, se dostane k agentovi, který už je připojený.
Každý nástroj si drží tvar metody: název nástroje je název metody (get_account_projects,
dbs_read, ...), jeho titulek je název metody ve formátu Title Case, jeho popis je vlastní
description metody a jeho vstupní schéma se skládá pole po poli z fields metody, povinná pole
zůstávají povinná, vše ostatní je nepovinné. Pole bez rozpoznaného typu se stále stane
benevolentním argumentem nástroje, aby nerozbilo celou relaci, takže jedna zvláštně popsaná
metoda nikdy nesrazí zbytek katalogu.
Klíč omezený na Full-stack VPS vystavuje vedle výše uvedených metod ekosystému i nástroje nainstalovaných pluginů daného stroje, takže agent dosáhne na platformu i na vše, co vývojář na stroji postavil, v jedné relaci. Viz Full-stack VPS.
Volání nástroje
Agent volá nástroj se stejnými argumenty, jaké popisují pole metody. Xuda odpoví tím, že metodu
zavolá interně, stejně jako by to udělalo /cpi/<method>, a nástroji předá zpět obálku metody
{code, data} jako text. Neúspěšné volání se na vrstvě MCP stále vrací normálně, kód -1 a vyšší
se v odpovědi nástroje ukáže přesně tak, jako by se ukázal z prostého volání REST, takže ho agent
čte stejně jako vaše vlastní zpracování chyb. Viz Chyby.
Požadavek, který selže dřív, než se spustí jakýkoli nástroj, tedy chybějící nebo odmítnutý
přihlašovací údaj (401), zavřená relace (404, kód -32001) nebo poškozená zpráva MCP, se vrátí
jako chyba JSON-RPC místo odpovědi nástroje: