Forbind en AI-klient over MCP
Tilføj Xuda som en ekstern MCP-server i Claude, Cursor eller en anden MCP-bevidst klient.
Denne side handler om klientsiden: at få Claude, Cursor eller noget andet, der taler MCP, til at tale med din Xuda-konto. For selve protokollen, navngivning af værktøjer, sessionens livscyklus og fejlformen, se MCP.
Hvad du har brug for
Én ting: en API-nøgle. Opret en fra kontoens område Udviklere (fuld adgang når alt, hvad nøglens
ejer kan, brugerdefineret adgang når kun et sæt tilladte metoder), se
Godkendelse. Der er ingen separat MCP-legitimation: den samme nøgle
virker over almindelig REST på /cpi/<method> og over MCP.
Hver API-nøgle på kontoen, og hver Full Stack VPS-maskines egen automatisk udstedte nøgle, peger på
den samme adresse: https://xuda.ai/mcp. En Full Stack VPS-nøgle udstiller desuden maskinens
installerede plugin-værktøjer ved siden af økosystemets metoder, se
Full Stack VPS.
Forbind en klient
Cursor læser sit uddrag fra .cursor/mcp.json (projekt) eller sine globale MCP-indstillinger.
Claude Desktop og claude.ai tilføjer en ekstern server fra Indstillinger, under Connectors: et navn,
URL'en og den samme Authorization-header. Enhver anden MCP-klient har kun brug for de samme to
oplysninger: et streamable HTTP-endpoint på https://xuda.ai/mcp og nøglen på hver forespørgsel som
Authorization: Bearer YOUR_API_KEY.
Hver kontos side Udviklere, API-nøgler har et Connect-kort under nøglelisten. Dets formatvælger
skifter én blok mellem .env, Next.js, MCP, cURL, Node.js og PHP, hver især allerede udfyldt med
endpointet og den første nøgle på listen, som blokkens overskrift nævner. Formatet .env har
XUDA_MCP_URL ved siden af REST-basen og nøglen, og MCP-formatet er Claude Code-kommandoen ovenfor.
Nøglen vises maskeret, til du afslører den. Kopiér tager altid den rigtige værdi.
Hvad agenten får, når den forbinder
Den første forespørgsel på en ny forbindelse er et MCP-kald til initialize. Xudas svar bærer et
instructions-felt bygget ud fra Studio LLM-vejledningen,
den samme prog-dokumentmodel, xu-*-attributreference og workflow-regler, som den side dækker,
sammenflettet fra platformens egne levende registre, så det aldrig kan beskrive en regel, som den
udrullede validator ikke faktisk håndhæver. De fleste MCP-klienter sender instructions direkte ind
i modellens kontekst, så agenten allerede ved, hvordan en Studio-prog er sat sammen, før dens første
værktøjskald, uden separat briefing.
To værktøjer er værd at kalde direkte i stedet for at stole på det, der kom ind ved forbindelsen:
get_studio_guide genlæser et hvilket som helst emne efter behov (components, tables,
programs, javascript, attributes, anatomy, gotchas), og get_prog_examples returnerer
fungerende, udvalgte eksempel-progs, man kan bygge efter.
Et dedikeret endpoint til ét API-program
Metoderne ovenfor er hele kontoens katalog bag én nøgle. Når du vil have et eksternt system til at
nå præcis ét endpoint i ét projekt, så udrul det: Udrul > Udrulninger > Server viser
MCP-server ved siden af Cron, Api, Node og Emitter. Dens trin Launch-indstillinger vælger et af
projektets egne api-programmer som mål, og så sender de sædvanlige trin for datacenter,
ydelsesniveau og navngivning det live som sit eget endpoint. Se
Din første udrulning for de fælles dele af den guide, og
API for, hvad et api-program er.
mcp er i dag opført blandt platformens beta-udrulningstyper, sammen med router, android og
emitter.