Gå til indhold
Bekræftet

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.

Ét endpoint til hver nøgle

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

claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
{
  "mcpServers": {
    "xuda": {
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
{
  "mcpServers": {
    "xuda": {
      "type": "http",
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

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.

Dashboardet skriver det for dig

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.

Beta-udrulningstype

mcp er i dag opført blandt platformens beta-udrulningstyper, sammen med router, android og emitter.