Gå til indhold
Bekræftet

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:

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

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

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

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.

Full Stack VPS-nøgler har ekstra værktøjer

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:

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

Næste