Strumenti personalizzatiBeta

I comandi integrati coprono il web, i file e la tua cronologia. Uno strumento personalizzato collega Glaido a qualsiasi altra cosa con un'API, come il gestore di attività, le note o i sistemi interni dell'azienda.

Parli come al solito, Glaido chiama lo strumento e la risposta è pronta da incollare sul cursore.

Aggiungi il primo strumento

Non costruisci gli strumenti a mano e non devi saper programmare. Un agente di coding IA come Claude Code, Cursor o Codex li costruisce per te. Il primo richiede circa due minuti:

1. Apri l'agente di coding.

2. Incolla questo prompt e lascialo lavorare:

   I'm setting up custom tools for the Glaido dictation app. Read this guide and
   follow the instructions for coding agents: /docs/beta/tools
    
   Build the hello-world weather example from the guide (current weather for any
   city, using the free Open-Meteo API, no API key needed). It's a fixed demo:
   just run the commands from the guide without planning or questions, then tell
   me the exact folder to pick when I click Import folder on Glaido's Commands page.

3. Importa il risultato. Quando l'agente ha finito, apri Comandi nella barra laterale di Glaido, vai alla scheda Personalizzati, clicca Importa cartella e seleziona la cartella che ha creato. Attiva il server con il suo interruttore.

Tieni premuta la scorciatoia dei comandi e chiedi «Che tempo fa ad Amsterdam?»

L'esempio non ha bisogno di una chiave API né di un account, quindi con le credenziali non può andare storto nulla. Lungo il percorso l'agente installa tutto il resto che gli serve.

Non hai ancora un agente di coding?

Installane uno prima: è una normale app desktop più un comando da terminale. Claude Code è una buona scelta predefinita. Quando è installato e hai effettuato l'accesso, incollaci il prompt qui sopra.

Costruisci il tuo

Quando l'esempio del meteo funziona, usa lo stesso prompt, ma sostituisci il paragrafo centrale con lo strumento che vuoi. Per esempio:

• «Collega Glaido al mio workspace di Notion»
• «Rendi Glaido in grado di inviare messaggi su Slack»
• «Dai a Glaido accesso all'API interna della mia azienda»

L'agente decide se per il tuo servizio esiste già un server pronto oppure ne costruisce uno piccolo su misura, sistema le eventuali chiavi API in un file locale e ti consegna una cartella da importare. Ti dirà quali chiavi impostare e dove prenderle.

Parti invece da un server vuoto

Se preferisci avere la cartella pronta prima di aprire l'agente di coding, Glaido può preparartene una. Nella scheda Personalizzati, clicca Nuovo server.

1. 1

   Scegli una posizione

   Glaido crea qui una cartella per il server. Il valore predefinito è ~/Glaido/servers, che tiene in un solo posto ogni server che prepara.

2. 2

   Scegli un linguaggio

   Python gira con uv, e Glaido installa FastMCP e blocca il progetto. TypeScript gira con Bun, e Glaido installa e blocca l'MCP SDK. Scegli quello che preferisci leggere; l'agente di coding gestisce entrambi.

3. 3

   Lascia che Glaido controlli la configurazione

   Glaido avvia il server da solo, quindi deve trovare uv o bun sulla macchina. Se non ci riesce, ti mostra l'unico comando che lo installa e un pulsante Controlla di nuovo. Se ne hai più copie installate, scegli quale deve usare.

4. 4

   Dai un nome al server

   È quello che vedrai nella schermata Comandi. Se esiste già una cartella con quel nome, Glaido ti dice il nome che userà al suo posto.

   È l'ultimo passo. Cliccare Crealo scrive la cartella. Prima puoi tornare indietro e cambiare qualsiasi cosa.

5. 5

   Portalo all'agente

   Il server è creato e vuoto. Glaido ti dà un prompt da copiare in Claude Code, Codex o un altro agente di coding, e un pulsante che mostra la cartella in Finder o in Esplora file.

Glaido osserva quella cartella, quindi gli strumenti compaiono nella schermata Comandi man mano che l'agente li salva. Dopo non devi importarla.

Installa la skill

Il prompt qui sopra fa recuperare le istruzioni all'agente ogni volta. Se pensi di costruire altri strumenti, installa invece la skill dal repository glaido-skills. L'agente allora conosce l'intero flusso a memoria e lo avvia in automatico su qualsiasi richiesta come «rendi Glaido in grado di inviare messaggi su Slack», senza bisogno del prompt. Puoi anche fare all'agente domande sulla skill stessa, per capire come funzionano gli strumenti di Glaido.

git clone https://github.com/daveebbelaar/glaido-skills.git
mkdir -p ~/.claude/skills
cp -r glaido-skills/creating-glaido-mcp-servers ~/.claude/skills/

Questi comandi si possono rieseguire senza rischi: mkdir -p non fa nulla se la cartella esiste già, e la copia aggiunge o aggiorna solo questa skill senza toccare le altre che hai installato. Su Windows, eseguili in PowerShell.

Dove stanno gli strumenti

Due cartelle arrivano già pronte, e conviene sceglierne una. Nuovo server prepara i file in ~/Glaido/servers. Il prompt per l'agente di coding in cima a questa pagina mette l'esempio del meteo in ~/Glaido/glaido-mcp-servers. Scegli quella in cui vuoi vivere, dì all'agente di costruire lì e sposta tutto quello che è finito nell'altra.

Tieni ogni nuovo server in quell'unica cartella. Quando ne hai alcuni, trasformala in un repository git e mandalo su GitHub. Hai la cronologia delle versioni degli strumenti, e configurare una macchina nuova diventa clonare e importare. L'agente di coding può farlo per te. Puoi tenere i server dove preferisci, ma se ne sposti uno importalo di nuovo dalla nuova posizione.

Decidere cosa viene eseguito senza chiedere

L'approvazione copre i server che hai aggiunto, più un comando integrato. Analizza immagine chiede prima di usare un'immagine dagli appunti. Vedi Approvare un'immagine dagli appunti.

Ogni altro comando integrato parte ogni volta che il modello lo chiama, e il suo interruttore nella scheda Integrati decide se il modello lo vede. Questo include File e app, che legge e apre cose sul disco senza chiedere prima. Spegnilo lì se preferisci che non lo faccia.

Per i tuoi server, ogni strumento ha una policy di approvazione. Clicca il riquadro di un server nella pagina Comandi e impostala per ciascuno strumento:

Gli strumenti che si limitano a leggere dati partono da Automatico; tutto il resto parte da Chiedi. Quando uno strumento impostato su Chiedi sta per partire, nella finestra dei comandi compare una scheda di approvazione:

Consenti una volta esegue lo strumento questa volta, Consenti sempre lo passa ad Automatico e Nega rifiuta la chiamata. Mentre la scheda è visibile, premere Enter sceglie Consenti una volta e non incolla mai.

La scheda non aspetta per sempre. Lasciala per 60 secondi e non parte nulla. Glaido dice che ha smesso di aspettare e chiede se riprovare.

Perché strumenti locali e specifici?

Glaido usa un modello veloce così le risposte tornano in circa un secondo, e i modelli veloci lavorano meglio con un piccolo insieme di strumenti specifici.

Per questo Glaido esegue gli strumenti come piccoli server sulla tua macchina, invece di collegarsi a grandi server MCP nel cloud. Quelli di solito espongono decine di strumenti ampi e generici, pensati per agenti che restano in esecuzione a lungo come Claude Code, e caricarli tutti rende un modello veloce più lento e meno preciso. Uno strumento che fa bene un solo lavoro («ottieni il meteo», «aggiungi un'attività», «cerca nelle mie note») tiene Glaido veloce.

Riferimento

Gli strumenti personalizzati sono server Model Context Protocol (MCP) che girano come processi locali sulla tua macchina. Li gestisci dalla scheda Personalizzati:

• Nuovo server te ne prepara uno vuoto, come descritto sopra.

• Importa cartella aggiunge una cartella che contiene un file mcp.json (o .mcp.json). È quello che produce il flusso con l'agente di coding.

• Modifica, sotto File di configurazione in fondo alla scheda, apre il file di configurazione MCP di Glaido, ~/Glaido/mcp.json, nell'editor. Usa il formato standard mcpServers condiviso dalla maggior parte dei client MCP:

  {
    "mcpServers": {
      "my-server": {
        "command": "npx",
        "args": ["-y", "@example/mcp-server"],
        "env": { "API_KEY": "your-key" }
      }
    }
  }

Glaido ricarica l'elenco dei server quando il file cambia.

Il riquadro di un server mostra un'icona di estensione, il nome del server, una descrizione di una riga e fino a tre dei suoi strumenti come chip, con un chip +N altri per il resto. A destra c'è l'interruttore che lo abilita. Non compare nient'altro, a meno che il server non sia riuscito ad avviarsi: in quel caso all'icona si aggiunge un badge di avviso.

Clicca il riquadro per i dettagli: il pallino di stato, ogni strumento con la sua policy di approvazione, il messaggio di errore se c'è, la configurazione che Glaido esegue e i pulsanti per aggiornare gli strumenti, aprire la cartella o eliminare il server.

Glaido esegue ogni server importato dalla cartella che hai importato, quindi un mcp.json non ha bisogno di percorsi assoluti.

Quando un server non si avvia

Un riquadro che non è riuscito porta un badge di avviso. Aprilo e Glaido indica la causa, invece di farti leggere un log:

Dove un server si è fermato con un codice di uscita, Glaido indica il codice nel messaggio.

Glaido rileva i primi tre controllando la tua configurazione, quindi non c'è output del server da mostrare. Per gli altri, quello che il server ha stampato compare sotto il messaggio nella finestra dei dettagli. Chiedi all'agente di coding di eseguire lo script di validazione della skill; li intercetta tutti prima dell'importazione.

Per gli agenti di coding

Se sei un agente di coding mandato qui per configurare uno strumento per Glaido:

1. Recupera e leggi questa skill, poi seguila alla lettera: https://raw.githubusercontent.com/daveebbelaar/glaido-skills/main/creating-glaido-mcp-servers/SKILL.md

2. Se l'utente ha chiesto l'esempio meteo hello-world, non devi leggere la skill né altro: è una demo fissa. Non pianificare, non generare né modificare codice, non proporre posizioni delle cartelle e non chiedere approvazione. Controlla che uv sia installato (installalo da docs.astral.sh/uv se non c'è), poi esegui esattamente:

   TMP=$(mktemp -d)
   git clone --depth 1 https://github.com/daveebbelaar/glaido-skills.git "$TMP/glaido-skills"
   mkdir -p ~/Glaido/glaido-mcp-servers
   cp -r "$TMP/glaido-skills/examples/hello-world-weather" ~/Glaido/glaido-mcp-servers/hello-world-weather
   python3 "$TMP/glaido-skills/creating-glaido-mcp-servers/scripts/validate_glaido_mcp.py" ~/Glaido/glaido-mcp-servers/hello-world-weather

   (Windows: adattalo a PowerShell; clona in $env:TEMP invece di mktemp.) Quando il validatore segnala "ready to import", hai finito. Ha già avviato il server per provarlo, quindi salta ogni ulteriore verifica. Il mcp.json è volutamente senza percorsi; non c'è nulla da modificare. Vai direttamente ai passi di importazione qui sotto.

3. Per tutto il resto, la skill copre il riuso di server MCP di terze parti già esistenti, la preparazione di quelli personalizzati, la configurazione dell'ambiente, lo schema di mcp.json, la validazione e i passi di consegna.

4. Qualsiasi cosa costruisci, il messaggio finale deve chiudersi con i passi di importazione esatti per l'utente: apri l'app Glaido, clicca Comandi nella barra laterale, vai alla scheda Personalizzati, clicca Importa cartella, poi nel browser di file che si apre seleziona l'intera cartella che hai creato (la cartella stessa, non un file al suo interno) e conferma, e attiva l'interruttore del server. Poi suggerisci un comando vocale che usi il nuovo strumento.

La skill è la fonte di verità e ha la precedenza sul riassunto di questa pagina.