Hoppa till innehållet
Verifierad

MCP

Samma API-nyckel, exponerad för en AI-agent som ett typat verktyg per tillåten metod.

Xuda kör en Model Context Protocol-server på /mcp, bredvid /cpi. Anslut en MCP-kompatibel agent till den, genom att logga in eller med en API-nyckel, så dyker varje metod som nyckeln får anropa upp som ett typat verktyg, utan någon separat integration att skriva för AI-agenter.

Ansluta

Det finns två vägar in, och båda slutar på samma ställe: en API-nyckels rättigheter.

Logga in (Claude-anslutningar och andra OAuth-klienter)

Lägg till https://xuda.ai/mcp som en egen anslutning i Claude (Settings, Connectors, Add custom connector), lämna OAuth-klient-id och hemlighet tomma och tryck på Anslut. Claude öppnar Xuda: logga in om du inte redan är det, så frågar ett fönster i dashboarden vilken av dina API-nycklar anslutningen ska agera som. Välj en och tryck på Anslut. Claude på webben, i Desktop, i mobilen och i Cowork delar den anslutningen, och varje annat Claude-konto lägger till den på samma sätt. Dashboardens flik Utvecklare, MCP visar adressen att klistra in, de här stegen och allt nedan.

Claude Code loggar in på samma sätt när du lägger till servern utan rubrik, kör sedan /mcp och väljer Authenticate:

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

Anslutningen har aldrig några egna rättigheter. Varje verktygsanrop körs som nyckeln du valde, så nyckelns åtkomstläge, dess tillåtelselista och dess återkallning gäller också för anslutningen: återkalla nyckeln under Utvecklare, API-nycklar så upphör anslutningen, och nästa inloggning ber om en annan nyckel. Sidan listar bara dina egna aktiva nycklar. Har du inga, skapa först en.

För utvecklare av MCP-klienter följer servern MCP-specifikationen för auktorisering:

Ett anrop till /mcp utan en användbar token besvaras med 401 och WWW-Authenticate: Bearer resource_metadata="...", vilket är hur en klient hittar resten. Åtkomsttokens gäller i en timme. Uppdateringstokens gäller i 90 dagar och byts ut vid varje användning. En loopback-omdirigerings-URI (http://localhost eller http://127.0.0.1) matchar på valfri port.

En API-nyckel i en rubrik

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

Nyckeln går i en Authorization: Bearer-rubrik, samma nyckel som du skulle använda som api_key på /cpi. Det finns ingen separat MCP-behörighet. En förfrågan utan Authorization-rubrik, eller med en nyckel som inte motsvarar ett aktivt xuda_api_keys-dokument, nekas med 401 innan något verktyg registreras.

Sessioner

Transporten är streambar HTTP: den första förfrågan är ett MCP-anrop initialize, som öppnar en session och returnerar en rubrik mcp-session-id. Varje följande förfrågan på den anslutningen har samma rubrik och samma behörighet. En session stängs efter 10 minuter utan förfrågan. En förfrågan på en session som har stängts besvaras med 404, och en MCP-klient startar då en ny session på egen hand.

Vad som blir ett verktyg

Verktyg registreras i början av sessionen utifrån samma åtkomstläge som nyckeln redan har:

  • Full åtkomst: varje metod i katalogen som inte är private registreras som ett verktyg, uppslaget görs vid anslutningen, så en metod som läggs till efter att nyckeln skapades är tillgänglig utan någon ändring av själva nyckeln.
  • Anpassad åtkomst: bara metoderna i nyckelns tillåtelselista registreras.

En pågående session följer sin nyckel: den tittar på nyckeln varje minut, och på modulerna och pluginerna bakom den var femte, och när uppsättningen verktyg har ändrats skickar den notifications/tools/list_changed. En klient som lyssnar (Claude gör det) läser den nya listan utan att ansluta på nytt, så en metod som du tillåter på nyckeln når en agent som redan är ansluten.

Varje verktyg behåller metodens egen form: verktygsnamnet är metodnamnet (get_account_projects, dbs_read, ...), dess titel är metodnamnet i Title Case, dess beskrivning är metodens egen description, och dess indataschema byggs fält för fält utifrån metodens fields: obligatoriska fält förblir obligatoriska, allt annat är valfritt. Ett fält utan en känd typ blir ändå ett tillåtande verktygsargument i stället för att bryta hela sessionen, så en märkligt specificerad metod drar aldrig med sig resten av katalogen.

Fullstack-VPS-nycklar har extra verktyg

En nyckel som är begränsad till en Fullstack-VPS exponerar också maskinens installerade plugin-verktyg vid sidan av ekosystemets metoder ovan, så att en agent når både plattformen och det som utvecklaren byggt på maskinen i en enda session. Se Full Stack VPS.

Anropa ett verktyg

En agent anropar ett verktyg med samma argument som metodens fält beskriver. Xuda svarar genom att anropa metoden internt, på samma sätt som /cpi/<method> skulle göra, och lämnar tillbaka metodens {code, data}-format som text till verktyget. Ett misslyckat anrop returnerar ändå normalt på MCP-nivå: kod -1 och uppåt visas i verktygsresultatet precis som det skulle göra från ett vanligt REST-anrop, så en agent läser det på samma sätt som din egen felhantering skulle göra. Se Errors.

En förfrågan som misslyckas innan något verktyg körs, en saknad eller nekad behörighet (401), en session som har stängts (404, kod -32001) eller ett felformaterat MCP-meddelande, kommer tillbaka som ett JSON-RPC-fel i stället för ett verktygsresultat:

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

Nästa