MCP
Den samme API-nøgle, udstillet for en AI-agent som ét typet værktøj pr. tilladt metode.
Xuda kører en Model Context Protocol-server på /mcp ved siden af /cpi. Forbind en MCP-kompatibel agent
til den, ved at logge ind eller med en API-nøgle, og hver metode, nøglen må kalde, dukker op som et typet
værktøj. Der er ingen separat integration, AI-agenter skal skrive.
Forbindelse
Der er to veje ind, og begge ender det samme sted: en API-nøgles rettigheder.
Log ind (Claude-konnektorer og andre OAuth-klienter)
Tilføj https://xuda.ai/mcp som en brugerdefineret konnektor i Claude (Indstillinger, Konnektorer,
Tilføj brugerdefineret konnektor), lad OAuth-klient-id og -hemmelighed stå tomme, og tryk på
Forbind. Claude åbner Xuda: log ind, hvis du ikke allerede er det, og et vindue i dashboardet spørger,
hvilken af dine API-nøgler forbindelsen skal handle som. Vælg en, og tryk på Forbind. Claude på nettet, i
Desktop, på mobil og i Cowork deler den forbindelse, og enhver anden Claude-konto tilføjer den på samme
måde. Dashboardets fane Udviklere, MCP viser adressen, der skal indsættes, disse trin og alt
nedenfor.
Claude Code logger ind på samme måde, når du tilføjer serveren uden en header, kør derefter /mcp og vælg
Authenticate:
Forbindelsen har aldrig egne rettigheder. Hvert værktøjskald kører som den nøgle, du valgte, så nøglens adgangstilstand, dens tilladelsesliste og dens tilbagekaldelse er også forbindelsens: tilbagekald nøglen under Udviklere, API-nøgler, og forbindelsen stopper, og næste login beder om en anden nøgle. Siden viser kun dine egne aktive nøgler. Har du ingen, så opret en først.
For klientudviklere følger serveren MCP-autorisationsspecifikationen:
Et kald til /mcp uden et brugbart token besvares med 401 med WWW-Authenticate: Bearer resource_metadata="...", og sådan finder en klient resten. Adgangstokens varer en time. Opdateringstokens
varer 90 dage og erstattes ved hver brug. En loopback-omdirigerings-URI (http://localhost eller
http://127.0.0.1) matcher på enhver port.
En API-nøgle i en header
Nøglen går i en Authorization: Bearer-header, den samme nøgle, du ville bruge som api_key på /cpi. Der
er ingen separat MCP-legitimation. En anmodning uden Authorization-header eller med en nøgle, der ikke
løser til et aktivt xuda_api_keys-dokument, afvises med 401, før noget værktøj registreres.
Sessioner
Transporten er streamable HTTP: den første anmodning er et MCP-initialize-kald, som åbner en session og
returnerer en mcp-session-id-header. Hver følgende anmodning på den forbindelse bærer den samme header og
den samme legitimation. En session lukker efter 10 minutter uden en anmodning. En anmodning på en session, der
er lukket, besvares med 404, og en MCP-klient starter så selv en ny session.
Hvad der bliver et værktøj
Værktøjer registreres ved sessionens start ud fra den adgangstilstand, nøglen allerede har:
- Fuld adgang: hver metode i kataloget, der ikke er
private, registreres som et værktøj, afgjort ved forbindelsen, så en metode tilføjet efter nøglen blev oprettet er tilgængelig uden nogen ændring af selve nøglen. - Brugerdefineret adgang: kun metoderne på nøglens tilladelsesliste registreres.
En kørende session følger med sin nøgle: den ser på nøglen hvert minut og på modulerne og pluginsene bag den
hvert femte, og når sættet af værktøjer har ændret sig, sender den notifications/tools/list_changed. En
klient, der lytter (det gør Claude), læser den nye liste uden at forbinde igen, så en metode, du tillader på
nøglen, når en agent, der allerede er forbundet.
Hvert værktøj beholder metodens egen form: værktøjsnavnet er metodenavnet (get_account_projects,
dbs_read, ...), dets titel er metodenavnet i Title Case, dets beskrivelse er metodens egen description, og
dets inputskema bygges felt for felt ud fra metodens fields, obligatoriske felter forbliver påkrævede, alt
andet er valgfrit. Et felt uden en genkendt type bliver stadig et tilladende værktøjsargument i stedet for at
ødelægge hele sessionen, så én mærkeligt specificeret metode aldrig tager resten af kataloget med sig.
En nøgle afgrænset til en Full Stack VPS udstiller også den maskines installerede plugin-værktøjer ved siden af økosystemmetoderne ovenfor, så en agent kan nå både platformen og det, udvikleren har bygget på maskinen, i én session. Se Full Stack VPS.
Kald et værktøj
En agent kalder et værktøj med de samme argumenter, som metodens felter beskriver. Xuda svarer ved at kalde
metoden internt, på samme måde som /cpi/<method> ville, og giver værktøjet metodens {code, data}-konvolut
tilbage som tekst. Et mislykket kald returnerer stadig normalt på MCP-laget, kode -1 og opefter vises i
værktøjsresultatet præcis som fra et almindeligt REST-kald, så en agent læser det på samme måde, som din egen
fejlhåndtering ville. Se Fejl.
En anmodning, der fejler, før noget værktøj kører, en manglende eller afvist legitimation (401), en session,
der er lukket (404, kode -32001), en forkert udformet MCP-besked, kommer tilbage som en JSON-RPC-fejl i
stedet for et værktøjsresultat: