MCP
Den samme API-nøkkelen, eksponert for en AI-agent som ett typet verktøy per tillatte metode.
Xuda kjører en Model Context Protocol-server på /mcp, ved siden av /cpi. Koble en MCP-kompatibel
agent til den, ved å logge inn eller med en API-nøkkel, og hver metode nøkkelen har lov til å kalle,
dukker opp som et typet verktøy, uten en egen integrasjon som AI-agenter må skrive.
Å koble til
Det finnes to veier inn, og begge ender på samme sted: rettighetene til en API-nøkkel.
Logg inn (Claude-tilkoblinger og andre OAuth-klienter)
Legg til https://xuda.ai/mcp som en egendefinert tilkobling i Claude (Innstillinger,
Tilkoblinger, Legg til egendefinert tilkobling), la OAuth-klient-ID og hemmelighet stå
tomme, og trykk Koble til. Claude åpner Xuda: logg inn hvis du ikke allerede er det, og et
vindu i dashbordet spør hvilken av API-nøklene dine tilkoblingen skal handle som. Velg en og trykk
Koble til. Claude på nettet, Desktop, mobil og Cowork deler den tilkoblingen, og enhver annen
Claude-konto legger den til på samme måte. Fanen Utviklere, MCP i dashbordet viser
adressen du skal lime inn, disse trinnene og alt nedenfor.
Claude Code logger inn på samme måte når du legger til serveren uten overskrift, og deretter kjører
/mcp og velger Authenticate:
Tilkoblingen har aldri egne rettigheter. Hvert verktøykall kjører som nøkkelen du valgte, så nøkkelens tilgangsmodus, tillatelsesliste og tilbaketrekking er også tilkoblingens: trekk nøkkelen tilbake under Utviklere, API-nøkler, og tilkoblingen stopper, og neste innlogging ber om en annen nøkkel. Siden lister bare dine egne aktive nøkler. Har du ingen, må du opprette en først.
For klientutviklere følger serveren MCP-autorisasjonsspesifikasjonen:
Et kall til /mcp uten et brukbart token svarer 401 med WWW-Authenticate: Bearer resource_metadata="...", og slik finner en klient resten. Tilgangstokens varer i én time.
Oppdateringstokens varer i 90 dager og byttes ut ved hver bruk. En loopback-omdirigerings-URI
(http://localhost eller http://127.0.0.1) samsvarer på alle porter.
En API-nøkkel i en overskrift
Nøkkelen går i en Authorization: Bearer-overskrift, den samme nøkkelen du ville brukt som
api_key på /cpi. Det finnes ingen egen MCP-legitimasjon. En forespørsel uten
Authorization-overskrift, eller med en nøkkel som ikke løses til et aktivt xuda_api_keys-dokument,
avvises med 401 før noe verktøy er registrert.
Økter
Transporten er streambar HTTP: den første forespørselen er et MCP-initialize-kall, som åpner en
økt og returnerer en mcp-session-id-overskrift. Hver følgende forespørsel på den tilkoblingen
har den samme overskriften og den samme legitimasjonen. En økt lukkes etter 10 minutter uten en
forespørsel. En forespørsel på en økt som er lukket, svarer 404, og en MCP-klient starter da en ny
økt på egen hånd.
Hva som blir et verktøy
Verktøy registreres ved starten av økten ut fra den samme tilgangsmodusen nøkkelen allerede har:
- Full tilgang: hver metode i katalogen som ikke er
private, registreres som et verktøy, løst ved tilkoblingstidspunktet, så en metode som er lagt til etter at nøkkelen ble opprettet, er tilgjengelig uten endring i selve nøkkelen. - Egendefinert tilgang: bare metodene på nøkkelens tillatelsesliste registreres.
En kjørende økt holder tritt med nøkkelen sin: den ser på nøkkelen hvert minutt, og på modulene og
pluginene bak den hvert femte, og når settet med verktøy har endret seg, sender den
notifications/tools/list_changed. En klient som lytter (Claude gjør det), leser den nye listen
uten å koble til på nytt, så en metode du tillater på nøkkelen, når en agent som allerede er
tilkoblet.
Hvert verktøy beholder metodens egen form: verktøynavnet er metodenavnet (get_account_projects,
dbs_read, ...), tittelen er metodenavnet i Title Case, beskrivelsen er metodens egen
description, og inndataskjemaet bygges felt for felt fra metodens fields. Obligatoriske felt
forblir påkrevde, alt annet er valgfritt. Et felt uten gjenkjent type blir likevel et tillatende
verktøyargument i stedet for å ødelegge hele økten, så én merkelig spesifisert metode tar aldri
resten av katalogen med seg ned.
En nøkkel avgrenset til en Full stack-VPS eksponerer også boksens installerte plugin-verktøy ved siden av økosystemmetodene ovenfor, så en agent kan nå både plattformen og det utvikleren bygde på boksen i én økt. Se Full stack-VPS.
Å kalle et verktøy
En agent kaller et verktøy med de samme argumentene metodens felt beskriver. Xuda svarer ved å
kalle metoden internt, på samme måte som /cpi/<method> ville gjort, og gir verktøyet metodens
{code, data}-konvolutt tilbake som tekst. Et mislykket kall returnerer fortsatt normalt i
MCP-laget, kode -1 og oppover vises i verktøyresultatet nøyaktig som fra et vanlig REST-kall, så
en agent leser det på samme måte som din egen feilhåndtering ville gjort. Se Feil.
En forespørsel som feiler før noe verktøy kjører, en manglende eller avvist legitimasjon (401), en
økt som er lukket (404, kode -32001), en feilformet MCP-melding, kommer tilbake som en
JSON-RPC-feil i stedet for et verktøyresultat: