Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Importare una configurazione client MCP — tre server usati da un assistente di programmazione

Un .mcp.json di Claude Code che elenca tre server Model Context Protocol — due avviati da riga di comando e uno eseguito da qualcun altro — trasformato in bozze di file Aggrega da aggrega import, con ogni server associato alla realizzazione del modo in cui viene eseguito, e compilato per Kubernetes.

Importare una configurazione client MCP lo illustra passo per passo: il comando, i file che scrive e il motivo di ogni riga, la compilazione e i server in esecuzione. Questa cartella contiene ogni fase di quella procedura guidata:

cartella o filecosa contiene
source/la configurazione del client, .mcp.json, il .aggrega-config.yaml che rende la cartella un workspace, e import-answers.yaml, il nome del Secret Kubernetes da cui viene letto il token del server GitHub
draft/i file che aggrega import .mcp.json --target helm ha scritto, invariati, release.lock incluso, e ciò che ha stampato: stdout.txt sullo standard output, import.txt sullo standard error

In un checkout del repository della documentazione, check.sh esegue di nuovo l’importazione, confronta ciò che scrive e stampa con draft/, confronta i blocchi citati dalla procedura guidata con questi file, e convalida e compila ciò che l’importazione ha scritto. Richiede il catalogo della libreria standard (dove procurarselo) estratto accanto a questo repository, oppure la sua directory indicata in AGGREGA_CATALOG_DIRS.

Generare l’esempio

Puoi eseguire l’importazione di questo esempio con i comandi qui sotto, oppure far sì che il tuo assistente AI la esegua per te.

Scrivi l’esempio in una nuova cartella che porta il suo nome:

Terminal window
aggrega scaffold --example import-mcp

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd import-mcp

Build

L’import crea le bozze dei file Aggrega accanto al progetto, in source/. Valuta il progetto rispetto al catalogo della libreria standard, che il registry predefinito del workspace pubblica come snapshot firmato: il primo import lo scarica, lo verifica, lo conserva nella cache dei contenuti del workspace e lo indica tramite il suo digest nel record che scrive accanto alle bozze. Un workspace che indica le proprie cartelle di catalogo — in AGGREGA_CATALOG_DIRS, o sotto workspace.catalog_dirs — importa invece rispetto a quelle. L’import legge il nome del Secret da import-answers.yaml, poi scarica ciò da cui dipende la Release in bozza, così la compilazione segue subito:

Terminal window
cd source
aggrega import .mcp.json --target helm
aggrega build --release release.yaml

La compilazione scrive i manifest Kubernetes sotto dist/helm/; la creazione del Secret e la loro applicazione sono descritte nella procedura guidata linkata sopra.

Con un assistente AI

Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.

Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `import-mcp`, chiama una volta lo strumento `scaffold` con `example` impostato a `import-mcp` e senza `dir`: scrive l’esempio in una nuova cartella `import-mcp`, la cui cartella `source` contiene ciò che questo esempio importa. Poi chiama lo strumento `import` con `workspace_root` impostato a `import-mcp/source`, `source` impostato a `.mcp.json` e `target` impostato a `helm`: legge le risposte di cui ha bisogno da `import-answers.yaml` accanto a `.mcp.json`, scrive le sue bozze in `import-mcp/source` e scarica ciò di cui hanno bisogno. Poi chiama lo strumento `validate` con `workspace_root` impostato a `import-mcp/source` e `release` impostato a `release.yaml`, e lo strumento `build` con `workspace_root` impostato a `import-mcp/source`, `release` impostato a `release.yaml` e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `import-mcp/source/dist/`.

Eseguire il test

Con la build applicata, inoltra una porta locale al Service del server fetch e lascia il comando in esecuzione:

Terminal window
kubectl port-forward svc/fetch-default 8080:8080

Da un altro terminale, chiedi al server di aprire una sessione con la richiesta initialize di MCP:

Terminal window
curl -sS http://127.0.0.1:8080/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-it", "version": "1.0.0"}}}'
: keepalive
: keepalive
event: message
data: {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"protocolVersion":"2025-06-18","serverInfo":{"name":"mcp-fetch","version":"2026.11.11"}}}

La guida esegue la stessa chiamata su Docker Compose e verso il server GitHub.