Configurare Aggrega con il tuo assistente AI
Un assistente AI in grado di eseguire comandi sulla tua macchina — un agente di programmazione nel terminale o nell’editor — può configurare Aggrega al posto tuo: installare il binario aggrega, aggiungere a sé stesso la skill di Aggrega e collegarsi al server MCP di Aggrega. Un assistente che installa plugin esegue gli ultimi due passaggi in uno solo, installando il plugin di Aggrega; qualsiasi altro aggiunge la skill e collega il server uno dopo l’altro. Incolla il prompt qui sotto e l’assistente esegue questi passaggi; il prompt gli dice di chiedere conferma prima di installare qualsiasi cosa.
Al termine, l’assistente ha due modi per lavorare con Aggrega. La skill è una cartella che contiene un file SKILL.md che l’assistente carica quando la tua richiesta riguarda Aggrega: indica all’assistente come si svolge il ciclo di scrittura e di prendere ogni risposta su uno schema o su un file dal binario anziché dalla memoria. Il server MCP, aggrega mcp, gli fornisce gli strumenti di Aggrega — scaffold, validate, build e il resto — e il materiale di riferimento su cui lavorano. La skill di Aggrega descrive la skill e il plugin, Collegare il server MCP il server, e Cosa può fare il tuo assistente con Aggrega ciò che raggiunge tramite esso.
Una volta configurato l’assistente, Per iniziare, ogni procedura guidata in Importazione e la pagina di ogni esempio eseguibile che si compila con Aggrega riportano il compito che insegnano come prompt da incollare nell’assistente, accanto ai comandi.
Il prompt
Configura Aggrega per me, un passo alla volta, e dimmi cosa hai eseguito a ogni passo.
1. Esegui `aggrega version`. Se il comando non viene trovato, chiedimi conferma prima di installare Aggrega, poi installalo per il mio utente con il programma di installazione ufficiale: su Linux o macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, su Windows in PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Esegui di nuovo `aggrega version`. Se il programma di installazione ha stampato una riga da aggiungere al mio `PATH`, mostramela.2. Se `https://aggrega.ai/docs/ai-assistants/skill/` indica un modo per installare in te il plugin di Aggrega, chiedimi conferma prima di installarlo, poi installalo in quel modo, oppure dimmi cosa fare quando si tratta di un passaggio che compio io nella tua interfaccia. Il plugin aggiunge la skill di Aggrega e ti collega al server MCP di Aggrega. Altrimenti, esegui `aggrega skills install --help` e trova il tuo identificatore nell’elenco che stampa. Chiedimi se voglio la skill in questo progetto o in tutti i progetti, poi esegui `aggrega skills install --agent <your identifier>`, aggiungendo `--global` per tutti i progetti. Se non sei nell’elenco, salta l’installazione della skill e dimmelo.3. Se hai installato il plugin, sei già collegato al server MCP di Aggrega. Altrimenti, collegati al server MCP di Aggrega, che è il comando `aggrega mcp`, nel modo in cui aggiungi un server MCP, come descrive per te `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Se ti serve un riavvio o un ricaricamento per caricare il plugin o il server, dimmi cosa fare.4. Una volta collegato, chiama lo strumento `describe-capabilities` senza argomenti e riassumi ciò che elenca.Il prompt è lo stesso in ogni lingua in cui è pubblicata la documentazione: se ne traducono solo le frasi, e ogni comando, flag, indirizzo e nome di strumento al suo interno resta esattamente come scritto, così un assistente legge le stesse istruzioni da qualunque lingua tu lo copi.
Il programma di installazione scarica la release più recente, la verifica rispetto ai digest SHA-256 pubblicati della release e la installa solo per il tuo utente, senza diritti di amministratore; Installare il binario descrive cosa fa e come installare invece a mano.
Cosa cambia da un assistente all’altro
Tre parti del prompt dipendono dall’assistente: il modo in cui installa il plugin di Aggrega, se installa plugin; altrimenti, l’identificatore che passa a --agent quando installa la skill, e il modo in cui aggiunge il server. L’assistente le ricava dal prompt, ma se le conosci puoi scriverle al suo interno.
| Assistente | Installazione del plugin | Installazione della skill senza il plugin |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, poi codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, poi copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity, oppure --agent antigravity-cli per la CLI di Antigravity |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, poi Developer: Reload Window | aggrega skills install --agent cursor |
Anche Visual Studio Code con GitHub Copilot, Kiro e OpenClaw installano il plugin; Installare il plugin indica il modo per ogni assistente, e cosa chiede OpenClaw prima di installare. Gli identificatori che --agent accetta, e la cartella in cui ciascuno scrive, sono elencati in aggrega skills e stampati da aggrega skills install --help. Il modo in cui ciascun assistente aggiunge il server — un proprio comando, oppure una voce nelle sue impostazioni o in un file con l’elenco dei server — è indicato in Collegare il server MCP, client per client.
Quando una parte del prompt non si applica
- Un assistente che installa il plugin salta il collegamento del server: lo ha collegato il plugin. Il plugin non installa il binario, quindi il passaggio 1 resta valido. Dove l’assistente avvia il server del plugin fuori dal tuo progetto — Codex lo avvia nella cartella del plugin stesso — la skill gli dice di indicare al server la cartella del tuo progetto, come descrive La cartella in cui lavora il server.
- Un assistente che non installa alcun plugin e non è nell’elenco di
--agentsalta l’installazione della skill. Raggiunge comunque gli strumenti di Aggrega tramite il server MCP una volta collegato, e il server gli fornisce indicazioni proprie quando si collega. - Un assistente che non può eseguire comandi — un’applicazione di chat senza accesso al tuo terminale — non può seguire il prompt. Installa il binario come descrive Installazione e collega tu stesso l’applicazione come descrive Collegare il server MCP. Per Claude Desktop, vedi Claude Desktop più avanti.
- Un server che qualcun altro esegue per te, raggiunto via HTTPS, non richiede né il binario, né il plugin, né la skill. Fornisci invece l’indirizzo al client dell’assistente, come descrive Un server raggiunto via HTTPS.
Claude Desktop
Claude Desktop si collega ad Aggrega tramite il pacchetto di estensione incluso in ogni release, e quel pacchetto avvia l’aggrega installato sul tuo computer. Configura tu stesso entrambi sul tuo computer:
- Installa
aggregain PowerShell su Windows conirm https://aggrega.ai/install.ps1 | iex, oppure in un terminale su macOS o Linux concurl -fsSL https://aggrega.ai/install.sh | sh. Installare il binario descrive cosa fa il programma di installazione. - Installa il pacchetto di estensione, imposta la sua Workspace folder e riavvia Claude Desktop, come descrive Claude Desktop in Collegare il server MCP.
Una sessione di Claude Desktop può eseguire i propri comandi in un container cloud anziché sul tuo computer, quindi il prompt qui sopra, incollato al suo interno, agisce sul container. Lì aggrega si installa e si esegue dalla shell della sessione una volta che il criterio di rete del container consente aggrega.ai — un proprietario dell’organizzazione lo consente nelle impostazioni di accesso alla rete dell’organizzazione. Il server MCP di Aggrega non vi è collegato: Claude Desktop aggiunge un server locale solo dalle impostazioni delle sue estensioni, e l’estensione avvia l’aggrega sul tuo computer, non quello nel container.
aggrega skills install non ha una voce per Claude Desktop, quindi una sessione di Claude Desktop salta l’installazione della skill. Raggiunge gli strumenti di Aggrega tramite il server MCP una volta installata l’estensione, e il server le fornisce indicazioni proprie quando si collega.