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:
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
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
privateregistreras 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.
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: