Costruisci con VULK da Claude e da altri client MCP: il connettore, tool per tool

Verificato il 10 ottobre 2026 sul server live e sul codice che ci sta dietro.

VULK gestisce un server MCP remoto. Aggiungi un indirizzo a Claude, a Claude Code o a un altro assistente che supporta i server MCP remoti, accedi a VULK una volta, e l'assistente può elencare i tuoi progetti, leggerne i file, controllare i tuoi crediti e avviare o continuare una build per te. Non installi niente e non incolli nessuna chiave API.

L'indirizzo è:

https://app.vulk.dev/mcp

Questo articolo elenca ogni tool che il server espone e mostra le risposte live che provano che è in funzione.

La prova che è live

Chiunque può controllare il server senza un account. Chiedigli i suoi metadati di accesso:

curl https://app.vulk.dev/.well-known/oauth-protected-resource

Il 10 ottobre 2026 ha risposto:

{
  "resource": "https://app.vulk.dev/mcp",
  "authorization_servers": ["https://app.vulk.dev"],
  "scopes_supported": ["projects.read", "usage.read", "projects.write"],
  "bearer_methods_supported": ["header"],
  "resource_name": "VULK"
}

Se chiami il server stesso senza un token, rifiuta con un 401 e un header WWW-Authenticate che indica al client quei metadati. È con quell'header che un client MCP scopre di dover far accedere la persona. Lo stesso server risponde anche su https://mcp.vulk.dev/mcp.

Come funziona l'accesso

La connessione usa OAuth standard, con i passaggi di discovery e di registrazione definiti dalla specifica MCP:

• Il client si registra da solo tramite un endpoint di registrazione, quindi non copi mai un client ID.
• Il flusso con codice di autorizzazione richiede PKCE con S256, e i client si autenticano senza segreto, che è il modello giusto per le app che girano sul tuo computer.
• L'accesso si rinnova con i refresh token, ma una connessione dura al massimo 90 giorni, per quanto spesso si rinnovi. Dopo devi approvarla di nuovo.
• Il server parla le versioni 2025-06-18, 2025-03-26 e 2024-11-05 del protocollo MCP.

Quando ti connetti, VULK mostra una schermata di consenso che elenca esattamente cosa potrà fare l'assistente. Un assistente che chiede solo di leggere riceve solo i permessi di lettura, e la schermata ti dice che la connessione non può creare, modificare, pubblicare o eliminare nulla. Su quella schermata stampiamo anche un avvertimento: il nome mostrato è quello che l'app si è data da sola, e VULK non può verificarlo, quindi approva solo una connessione che hai appena avviato tu.

Vedi tutte le app connesse in Impostazioni › Integrazioni › App connesse e puoi rimuoverne una in qualsiasi momento. Perde l'accesso subito. Puoi avere fino a 50 app connesse e 20 schermate di approvazione in attesa contemporaneamente.

I nove tool

Sei tool si limitano a leggere. Tre possono avviare, continuare o fermare il lavoro.

Ogni tool dichiara il permesso di cui ha bisogno, e il server rifiuta una chiamata fatta senza. A una connessione di sola lettura i tool di build non vengono nemmeno mostrati.

Come gira una build da un assistente

Costruire richiede minuti, non millisecondi, quindi il processo è diviso in due:

1. L'assistente chiama create_project con il tuo brief, fino a 8.000 caratteri, e un request_id, un UUID nuovo per quell'unica azione.
2. VULK controlla il tuo piano e i tuoi crediti e risponde con una ricevuta: l'id della richiesta, l'id del progetto e un link all'editor. Una ricevuta significa che la build è partita, non che è finita.
3. L'assistente chiama get_operation con lo stesso request_id finché il lavoro non è concluso, girandoti qualsiasi domanda che VULK ti fa.

Se una risposta va persa, l'assistente riprova con lo stesso request_id e gli stessi argomenti, e VULK la tratta come la stessa richiesta invece di avviarne e addebitarne una seconda. Se VULK non ha confermato una richiesta entro circa 20 secondi, la risposta dice unconfirmed e l'assistente la rilegge con get_operation invece di tirare a indovinare.

Il progetto che ne esce è un normale progetto VULK. Compare nel tuo account e puoi aprirlo nell'editor in qualsiasi momento.

Salvaguardie integrate

Alcuni limiti sono tracciati di proposito, nel codice e non solo nella documentazione:

• Nessun tool pubblica un sito. La pubblicazione resta nell'editor, dove puoi vedere cosa va online.
• Nessun tool compra crediti o cambia il tuo piano. create_project e continue_project spendono crediti già inclusi nel tuo piano, esattamente come farebbe la stessa richiesta scritta nell'editor. Se il saldo non basta, VULK rifiuta e spiega perché.
• Nessun tool elimina un progetto. Un'istruzione inviata con continue_project può modificare o rimuovere file dentro un progetto, come farebbe la stessa richiesta scritta nell'editor, ma nessun tool rimuove il progetto in sé.

Risposte pensate per i modelli

Un assistente paga per ogni byte che un tool restituisce, quindi le risposte sono limitate e dicono quando sono tagliate: un elenco di progetti si ferma a 50, un elenco di file a 500 voci e un singolo file a 200.000 caratteri, con un flag truncated quando succede. Ogni risultato arriva due volte, come testo per qualsiasi client e come dati strutturati per i client sul protocollo 2025-06-18, e ogni tool pubblica la forma esatta di quei dati come output schema, verificata da un test. Ogni tool porta anche un titolo leggibile e le indicazioni di sola lettura, distruttivo e idempotente.

Gli errori tornano come risultati del tool che il modello può leggere, per esempio "il file non esiste, elenca prima i file", invece che come errori di protocollo che chiudono la conversazione.

Configurarlo

Claude (web e desktop): apri Customize, poi Connectors, aggiungi un connettore personalizzato con l'indirizzo qui sopra, poi scegli Connect e approva nella finestra di VULK che si apre.

Claude Code:

claude mcp add --transport http vulk https://app.vulk.dev/mcp

Poi esegui /mcp, scegli vulk e accedi quando si apre il browser.

Altri assistenti: aggiungi lo stesso indirizzo come server MCP HTTP remoto in qualsiasi client che supporti i server remoti con accesso. Il client apre VULK nel tuo browser per l'approvazione. La guida passo passo è nella documentazione MCP.