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.
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
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.
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.
mcp finns i dag bland plattformens betadistributionstyper, tillsammans med router, android och
emitter.