Hoppa till innehållet
Verifierad

Ansluta en AI-klient över MCP

Lägg till Xuda som en fjärr-MCP-server i Claude, Cursor eller någon annan MCP-medveten klient.

Den här sidan handlar om klientsidan: att få Claude, Cursor eller något annat som talar MCP att prata med ditt Xuda-konto. För själva protokollet, verktygsnamn, sessionens livscykel och felens form, se MCP.

Vad du behöver

En enda sak: en API-nyckel. Skapa en från kontots område Utvecklare (full åtkomst når allt som nyckelns ägare kan, anpassad åtkomst når bara en tillåtelselista med metoder), se Autentisering. Det finns ingen separat MCP-inloggningsuppgift, samma nyckel fungerar över vanlig REST på /cpi/<method> och över MCP.

En slutpunkt för varje nyckel

Varje API-nyckel för ett konto, och varje Fullstack-VPS-maskins egen automatiskt utfärdade nyckel, pekar på samma adress: https://xuda.ai/mcp. En Fullstack-VPS-nyckel exponerar dessutom maskinens installerade plugin-verktyg bredvid ekosystemets metoder, se Fullstack-VPS.

Anslut 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 sitt utdrag från .cursor/mcp.json (projekt) eller sina globala MCP-inställningar. Claude Desktop och claude.ai lägger till en fjärrserver från Inställningar, under Connectors: ett namn, URL:en och samma Authorization-header. Alla andra MCP-klienter behöver bara samma två uppgifter: en streambar HTTP-slutpunkt på https://xuda.ai/mcp, och nyckeln i varje förfrågan som Authorization: Bearer YOUR_API_KEY.

Instrumentpanelen skriver det här åt dig

Varje kontos sida Utvecklare, API-nycklar har ett Connect-kort under nyckellistan. Dess formatväljare växlar ett enda block mellan .env, Next.js, MCP, cURL, Node.js och PHP, vart och ett redan ifyllt med slutpunkten och den första nyckeln i listan, som blockets rubrik namnger. Formatet .env har XUDA_MCP_URL bredvid REST-basen och nyckeln, och MCP-formatet är Claude Code-kommandot ovan. Nyckeln visas maskerad tills du visar den; Kopiera tar alltid det verkliga värdet.

Vad agenten får vid anslutning

Den första förfrågan på en ny anslutning är ett MCP-anrop initialize. Xudas svar bär ett instructions-fält byggt från Studio LLM-guiden, samma programdokumentmodell, xu-*-attributreferens och arbetsflödesregler som tas upp på den sidan, sammanslagna från plattformens egna levande register så att det aldrig kan beskriva en regel som den distribuerade valideraren inte faktiskt tillämpar. De flesta MCP-klienter skickar instructions rakt in i modellens kontext, så agenten vet redan hur ett Studio-program är uppbyggt före sitt första verktygsanrop, utan någon separat genomgång.

Två verktyg är värda att anropa direkt i stället för att lita på det som kom in vid anslutningen: get_studio_guide läser om vilket ämne som helst vid behov (components, tables, programs, javascript, attributes, anatomy, gotchas), och get_prog_examples ger fungerande, kurerade exempelprogram att bygga efter.

En dedikerad slutpunkt för ett API-program

Metoderna ovan är hela kontots katalog bakom en nyckel. När du vill att ett externt system ska nå exakt en slutpunkt i ett projekt i stället distribuerar du den: Distribuera > Driftsättningar > Server listar MCP-server bredvid Cron, Api, Nod och Emitter. Dess steg Startinställningar väljer ett av projektets egna api-program som mål, och sedan skickar de vanliga stegen för datacenter, prestandanivå och namngivning ut det som en egen slutpunkt. Se Din första distribution för de delade delarna av den guiden, och API för vad ett api-program är.

Distributionstyp i beta

mcp finns i dag bland plattformens betadistributionstyper, tillsammans med router, android och emitter.