Přeskočit na obsah
Ověřeno

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:

claude mcp add
claude mcp add --transport http xuda https://xuda.ai/mcp

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

claude mcp add
claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

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íče Full-stack VPS nesou další nástroje

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:

json
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" }, "id": null }

Dál