Vai al contenuto
Verificata

Collegare un client AI tramite MCP

Aggiungi Xuda come server MCP remoto a Claude, Cursor o a qualsiasi altro client compatibile con MCP.

Questa pagina riguarda il lato client: far dialogare Claude, Cursor o qualsiasi altra cosa che parli MCP con il tuo account Xuda. Per il protocollo in sé, la denominazione degli strumenti, il ciclo di vita della sessione e la forma degli errori, vedi MCP.

Che cosa ti serve

Una sola cosa: una chiave API. Creane una dall'area Sviluppatori dell'account (l'accesso completo raggiunge tutto ciò che può il proprietario della chiave, l'accesso personalizzato raggiunge solo un insieme consentito di metodi), vedi Autenticazione. Non esiste una credenziale MCP separata: la stessa chiave funziona sia con il normale REST a /cpi/<method> sia con MCP.

Un solo endpoint per ogni chiave

Ogni chiave API dell'account, e la chiave rilasciata automaticamente a ogni box Full Stack VPS, puntano allo stesso indirizzo: https://xuda.ai/mcp. Una chiave Full Stack VPS espone inoltre gli strumenti dei plugin installati su quel box insieme ai metodi dell'ecosistema, vedi Full Stack VPS.

Collega 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 legge il suo frammento da .cursor/mcp.json (progetto) o dalle sue impostazioni MCP globali. Claude Desktop e claude.ai aggiungono un server remoto da Impostazioni, sotto Connettori: un nome, l'URL e lo stesso header Authorization. Qualsiasi altro client MCP ha bisogno solo degli stessi due dati: un endpoint HTTP in streaming a https://xuda.ai/mcp e la chiave a ogni richiesta come Authorization: Bearer YOUR_API_KEY.

La dashboard lo scrive per te

La pagina Sviluppatori, Chiavi API di ogni account ha una scheda Collega sotto l'elenco delle chiavi. Il suo selettore di formato fa passare un solo blocco tra .env, Next.js, MCP, cURL, Node.js e PHP, ciascuno già compilato con l'endpoint e la prima chiave dell'elenco, che l'intestazione del blocco nomina. Il formato .env porta XUDA_MCP_URL accanto alla base REST e alla chiave, e il formato MCP è il comando Claude Code qui sopra. La chiave appare mascherata finché non la mostri; Copia prende sempre il valore reale.

Che cosa ottiene l'agente alla connessione

La prima richiesta su una nuova connessione è una chiamata MCP initialize. La risposta di Xuda porta un campo instructions costruito dalla guida LLM di Studio, lo stesso modello di documento dei prog, il riferimento agli attributi xu-* e le regole dei flussi di lavoro trattati in quella pagina, unito dai registri attivi della piattaforma stessa, così da non poter mai descrivere una regola che il validatore distribuito non applica davvero. La maggior parte dei client MCP inoltra instructions direttamente nel contesto del modello, quindi l'agente sa già come è fatto un prog di Studio prima della sua prima chiamata a uno strumento, senza bisogno di un briefing separato.

Vale la pena chiamare direttamente due strumenti invece di affidarsi a ciò che è arrivato al momento della connessione: get_studio_guide rilegge su richiesta qualsiasi argomento (components, tables, programs, javascript, attributes, anatomy, gotchas), e get_prog_examples restituisce esempi di prog funzionanti e selezionati su cui modellare una creazione.

Un endpoint dedicato per un solo programma API

I metodi qui sopra sono l'intero catalogo dell'account dietro una sola chiave. Quando vuoi che un sistema esterno raggiunga esattamente un endpoint di un progetto, distribuiscilo: Distribuisci > Deployment > Server elenca Server MCP insieme a Cron, Api, Node ed Emitter. Il suo passaggio Impostazioni di avvio sceglie come destinazione uno dei programmi api del progetto stesso, poi i consueti passaggi di datacenter, livello di prestazioni e denominazione lo pubblicano come endpoint a sé. Vedi La tua prima distribuzione per le parti condivise di quella procedura guidata, e API per sapere che cos'è un programma api.

Tipo di distribuzione beta

mcp oggi è elencato tra i tipi di distribuzione beta della piattaforma, insieme a router, android ed emitter.