Sari la conținut
Verificat

Conectarea unui client AI prin MCP

Adaugă Xuda ca server MCP la distanță în Claude, Cursor sau orice alt client compatibil MCP.

Această pagină este despre partea de client: să faci Claude, Cursor sau orice altceva care vorbește MCP să comunice cu contul tău Xuda. Pentru protocolul în sine, denumirea tool-urilor, ciclul de viață al sesiunii, forma erorilor, vezi MCP.

Ce îți trebuie

Un singur lucru: o cheie API. Creează una din zona Dezvoltatori a contului (accesul complet ajunge la tot ce poate face proprietarul cheii, accesul personalizat ajunge doar la un set de metode din lista de permisiuni), vezi Autentificare. Nu există o credențială MCP separată, aceeași cheie funcționează prin REST simplu la /cpi/<method> și prin MCP.

Un singur endpoint pentru fiecare cheie

Fiecare cheie API de cont și fiecare cheie emisă automat pentru o casetă VPS Full Stack indică aceeași adresă: https://xuda.ai/mcp. O cheie VPS Full Stack expune în plus tool-urile plugin-urilor instalate pe acea casetă, alături de metodele ecosistemului, vezi VPS Full Stack.

Conectează un client

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 își citește snippet-ul din .cursor/mcp.json (proiect) sau din setările MCP globale. Claude Desktop și claude.ai adaugă un server la distanță din Settings, la Connectors: un nume, URL-ul și același header Authorization. Orice alt client MCP are nevoie doar de aceleași două informații: un endpoint HTTP streamable la https://xuda.ai/mcp și cheia la fiecare cerere, ca Authorization: Bearer YOUR_API_KEY.

Tabloul de bord îl scrie pentru tine

Pagina Dezvoltatori, Chei API a fiecărui cont are un card Connect sub lista de chei. Selectorul lui de format comută un singur bloc între .env, Next.js, MCP, cURL, Node.js și PHP, fiecare completat deja cu endpoint-ul și cu prima cheie din listă, pe care o numește antetul blocului. Formatul .env conține XUDA_MCP_URL lângă baza REST și cheie, iar formatul MCP este comanda Claude Code de mai sus. Cheia apare mascată până o afișezi; Copy ia întotdeauna valoarea reală.

Ce primește agentul la conectare

Prima cerere pe o conexiune nouă este un apel MCP initialize. Răspunsul Xuda conține un câmp instructions construit din Ghidul LLM pentru Studio, același model de documente prog, aceeași referință de atribute xu-* și aceleași reguli de flux de lucru tratate în acea pagină, îmbinate din registrele live ale platformei, așa că nu poate descrie o regulă pe care validatorul publicat nu o aplică de fapt. Majoritatea clienților MCP transmit instructions direct în contextul modelului, așa că agentul știe deja cum este alcătuit un prog Studio înainte de primul apel de tool, fără un briefing separat.

Merită apelate direct două tool-uri, în loc să te bazezi pe ce a venit la conectare: get_studio_guide recitește orice subiect la cerere (components, tables, programs, javascript, attributes, anatomy, gotchas), iar get_prog_examples returnează exemple de prog funcționale, selectate, după care să modelezi un build.

Un endpoint dedicat pentru un program API

Metodele de mai sus sunt întregul catalog al contului în spatele unei chei. Când vrei ca un sistem extern să ajungă exact la un singur endpoint al unui singur proiect, publică-l: Publică > Implementări > Server listează Server MCP alături de Cron, Api, Node și Emitter. Pasul Setări de lansare alege unul dintre programele api ale proiectului ca țintă, apoi pașii obișnuiți de datacenter, nivel de performanță și denumire îl livrează ca propriul endpoint. Vezi Prima ta publicare pentru părțile comune ale acelui asistent și API pentru ce este un program api.

Tip de implementare beta

mcp este astăzi printre tipurile de implementare beta ale platformei, alături de router, android și emitter.