MCP Playground: esegui i tools dei tuoi agenti in live, direttamente dalla documentazione
La settimana scorsa abbiamo reso i tools MCP un API Contract di prima classe: punta Archyl verso un server MCP attivo e scoprirà ogni tool con il suo schema di input, documentato e collegato al tuo modello C4 come qualsiasi contratto REST o GraphQL.
Questo rispondeva alla prima domanda: cosa possono fare i miei agenti?
Oggi rispondiamo alla seconda: lo fa davvero?
Ecco il MCP Playground — una nuova scheda su ogni contratto MCP live che ti permette di invocare qualsiasi tool contro il server reale e ispezionare il risultato reale. Nessun client da configurare, niente JSON-RPC a mano, senza lasciare la tua documentazione di architettura.
Dallo schema al form, automaticamente
Apri un contratto MCP live e troverai una scheda Playground accanto allo schema. Scegli un tool dalla lista — la stessa lista ricercabile che hai documentato — e Archyl trasforma il suo inputSchema in un form:
- Stringhe, numeri e booleani diventano campi tipizzati.
- Gli enum diventano menu a tendina con i valori consentiti.
- I parametri obbligatori sono contrassegnati e validati prima di inviare qualsiasi cosa.
- Oggetti annidati e array hanno un campo JSON grezzo, validato all'invio.
Compila, premi Esegui tool, e il risultato torna con la sua durata — visualizzato come un risultato merita. La vista Formattato mostra la risposta come JSON pulito e indentato. La vista Albero rende navigabili le payload grandi: comprimi ciò che non ti interessa, espandi ciò che conta. Testo, immagini e risorse restituiti da un tool vengono renderizzati nativamente.
Se il tool restituisce un errore, vedi esattamente quello che vedrebbe un agente — il flag di errore e la payload, mostrati in rosso, mai nascosti.
Il tuo token non lascia mai il tuo browser
Il Playground segue lo stesso modello di sicurezza della discovery live, e vale la pena ripeterlo perché è il punto centrale:
Ogni chiamata parte dal tuo browser. Quando premi Esegui tool, il tuo browser parla direttamente con il tuo server MCP. Il backend di Archyl non è nel percorso.
- Il token non viene mai memorizzato. Lo inserisci per la sessione; vive nella pagina e da nessun'altra parte.
- I risultati non vengono mai persistiti. Ciò che torna viene visualizzato, letto, e sparisce quando chiudi la scheda.
- Nessun accesso lato server alla tua rete. Poiché la richiesta parte dalla tua macchina, il playground raggiunge
localhoste i server privati — e non esiste alcun percorso di richiesta lato server da sfruttare.
L'unico compromesso, come per la discovery, è il CORS: il server di destinazione deve consentire l'origin di Archyl. Per i server che controlli, è una riga di configurazione.
Perché è importante
I tools MCP sono l'interfaccia che i tuoi agenti IA usano davvero. Finora, verificarne uno significava configurare un client, costruire una busta JSON-RPC, o semplicemente… fidarsi della descrizione.
Ora la documentazione è il banco di prova:
- Stai facendo la review della superficie di un agente? Esegui i tools e guarda le forme reali, non quelle descritte.
- Stai facendo il debug di una chiamata fallita di un agente? Riproducila in due clic con esattamente gli stessi argomenti.
- Stai facendo onboarding su un servizio? Invia il contratto: si può leggere ogni tool e provarlo.
Questo è ciò che intendiamo per documentazione viva. Una spec che può essere eseguita non deriva in silenzio; viene smascherata nel momento in cui mente.
Dogfooding, come sempre
Archyl è esso stesso un server MCP — 181 tools questa settimana. Il primo utente del Playground è stato il nostro stesso contratto: eseguiamo list_projects, get_project_c4_model e compagnia contro il nostro endpoint, dalla nostra documentazione, ogni giorno. Lo screenshot qui sopra è esattamente questo.
Provalo
Apri un progetto → API Contracts → qualsiasi contratto MCP con endpoint live → Playground. Inserisci il token, scegli un tool, eseguilo.
La tua documentazione di architettura ha appena imparato a eseguirsi.