# Integrazione MCP (/it/docs/verdent-manager/configuration/mcp) > Estendi Verdent con server e plugin Model Context Protocol ## Cos'è MCP (Model Context Protocol)? [#cosè-mcp-model-context-protocol] Model Context Protocol (MCP) è un sistema di integrazione che amplia le capacità di Verdent collegandolo a strumenti, sorgenti dati e servizi esterni. **Concetto chiave:** MCP consente a Verdent di interagire con sistemi che vanno oltre il suo set di strumenti integrato, permettendo un'integrazione fluida con: * API e servizi web esterni * Sistemi di database * Piattaforme cloud (AWS, Azure, GCP) * Strumenti di gestione dei progetti * Pipeline CI/CD * Strumenti interni personalizzati **Architettura:** I server MCP fungono da ponte tra Verdent e i sistemi esterni. Ogni server MCP espone capacità specifiche che Verdent può invocare durante le sessioni di coding, in modo simile agli strumenti integrati come `file_read` o `bash`. **Archiviazione della configurazione:** Le configurazioni dei server MCP sono salvate in `~/.verdent/mcp.json` e gestite tramite il menu Settings. *** ## Vantaggi dell'integrazione MCP [#vantaggi-dellintegrazione-mcp] ### Capacità estese [#capacità-estese] **Accesso a sistemi esterni:** Collega Verdent a strumenti e servizi non disponibili tramite le funzionalità integrate. Interroga database, interagisci con servizi cloud o integra API specifiche del progetto senza abbandonare il tuo flusso di lavoro di coding. **Sviluppo di strumenti personalizzati:** Crea server MCP su misura per i requisiti unici del tuo progetto. Costruisci integrazioni specializzate per strumenti interni, API proprietarie o sistemi specifici del dominio. ### Interoperabilità [#interoperabilità] **Sfruttare l'ecosistema:** Attingi al crescente ecosistema MCP. I server MCP sviluppati dalla community offrono integrazioni predefinite per strumenti e servizi popolari. **Protocollo standardizzato:** MCP fornisce un'interfaccia coerente per l'integrazione degli strumenti, garantendo che le nuove capacità si integrino senza problemi con il sistema di strumenti esistente di Verdent. ### Automazione del flusso di lavoro [#automazione-del-flusso-di-lavoro] **Integrazione fluida:** I server MCP diventano parte del set di strumenti di Verdent. L'agente utilizza automaticamente gli strumenti MCP quando appropriato, oppure puoi invocarli esplicitamente per attività specifiche. **Operazioni consapevoli del contesto:** Le integrazioni MCP comprendono il contesto del tuo codebase, permettendo interazioni intelligenti con i sistemi esterni in base allo stato di sviluppo corrente. *** ## Configurare i server MCP [#configurare-i-server-mcp] ### Processo di configurazione [#processo-di-configurazione] **Accedere alle impostazioni MCP:** 1. Apri il menu Settings in Verdent 2. Vai alla sezione **MCP Servers** 3. Visualizza o modifica la configurazione `~/.verdent/mcp.json` **File di configurazione:** I server MCP si configurano tramite il file `~/.verdent/mcp.json`, che definisce le connessioni ai server, l'autenticazione e i parametri di integrazione. Consulta la sezione **Configurazione MCP** più sotto per lo schema completo. ### Gestione della configurazione [#gestione-della-configurazione] **Aggiungere server:** Configura nuovi server MCP aggiungendo voci a `mcp.json` con i dettagli di connessione e le credenziali di autenticazione. **Server multipli:** Verdent supporta più server MCP concorrenti, consentendo l'integrazione con diversi sistemi esterni contemporaneamente. **Testare le connessioni:** Convalida le configurazioni dei server MCP per assicurarti che le connessioni funzionino prima di usarle nei flussi di lavoro di sviluppo. ### Stato del server [#stato-del-server] Monitora lo stato della connessione nel pannello delle impostazioni MCP: | Stato | Descrizione | | ----------- | ------------------------------------------------------- | | **Success** | Server connesso e strumenti disponibili | | **Failed** | Errore di connessione (seleziona per vedere i dettagli) | | **Loading** | Server in inizializzazione | **Aggiornare gli strumenti:** Seleziona il pulsante di aggiornamento per riscoprire gli strumenti disponibili di un server dopo modifiche alla configurazione o problemi di connessione. *** ## Configurazione MCP [#configurazione-mcp] ### Configurazione di base [#configurazione-di-base] **Posizione:** `.mcp.json` nella radice del progetto oppure `~/.verdent/mcp.json` (globale) ```json PostgreSQL Server { "mcpServers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/myapp_dev" ] } } } ``` ```json GitHub Server { "mcpServers": { "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } } } } ``` ```json Multiple Servers { "mcpServers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/myapp_dev" ] }, "github": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } } } } ``` **Chiavi di configurazione:** * `mcpServers` - Chiave di primo livello obbligatoria per la configurazione MCP * `command` - Eseguibile da avviare (in genere `npx` per i pacchetti Node.js) * `args` - Argomenti passati al comando (nome del pacchetto, stringhe di connessione, ecc.) * `env` - Variabili d'ambiente per autenticazione/configurazione **Scopri di più su MCP:** * [Specifica di Model Context Protocol](https://modelcontextprotocol.io/specification) * [Registro dei server MCP](https://mcp.so/servers) - Sfoglia i server MCP disponibili * [Server MCP ufficiali](https://github.com/modelcontextprotocol) - PostgreSQL, GitHub, Filesystem e altro *** ## Plugin ed estensioni MCP [#plugin-ed-estensioni-mcp] ### Plugin disponibili [#plugin-disponibili] I plugin MCP forniscono integrazioni predefinite per strumenti e servizi comuni. Sfoglia il registro della community su [mcp.so/servers](https://mcp.so/servers) oppure il [repository ufficiale dei server MCP](https://github.com/modelcontextprotocol) per la disponibilità attuale. **Categorie di plugin comuni:** * **Integrazioni con database:** strumenti di query per PostgreSQL, MySQL, MongoDB * **Servizi cloud:** interazioni con API di AWS, Azure, GCP * **Strumenti per sviluppatori:** integrazioni con GitHub, GitLab, Jira, Linear * **Piattaforme CI/CD:** Jenkins, GitHub Actions, CircleCI * **Servizi di monitoraggio:** Datadog, New Relic, Sentry * **Comunicazione:** notifiche su Slack, Discord, Microsoft Teams ### Installazione dei plugin [#installazione-dei-plugin] **Metodi di installazione:** I plugin si installano e configurano tramite l'interfaccia delle impostazioni MCP e in genere richiedono: * Identificatore o sorgente del plugin * Parametri di configurazione * Credenziali di autenticazione (se necessarie) **Gestione delle dipendenze:** I plugin MCP possono avere dipendenze da servizi o librerie esterni. I processi di installazione gestiscono automaticamente la risoluzione delle dipendenze quando possibile. *** ## Sviluppo di server MCP personalizzati [#sviluppo-di-server-mcp-personalizzati] ### Creare server personalizzati [#creare-server-personalizzati] Gli utenti avanzati possono creare server MCP personalizzati per integrare strumenti proprietari o sistemi specifici del dominio. **Approccio allo sviluppo:** I server MCP personalizzati implementano la specifica del protocollo MCP, esponendo capacità di strumenti che Verdent può invocare. Consulta la [specifica di Model Context Protocol](https://modelcontextprotocol.io/specification) per i dettagli di implementazione e gli SDK. **Casi d'uso per i server personalizzati:** * **Integrazione con API interne:** collegamento a API e servizi specifici dell'azienda * **Ponti verso sistemi legacy:** consentono a Verdent di interagire con infrastrutture legacy * **Sorgenti dati specializzate:** accesso a database o data warehouse proprietari * **Automazione dei flussi di lavoro:** avvio di pipeline personalizzate di build, deployment o testing ### Pattern di integrazione [#pattern-di-integrazione] **Configurazione a livello di workspace:** I server MCP possono essere configurati a livello di workspace per integrazioni specifiche del progetto, permettendo ai team di condividere le configurazioni MCP tramite il version control. **Interoperabilità degli strumenti:** Gli strumenti forniti da MCP si integrano senza problemi con gli strumenti integrati di Verdent (`file_read`, `bash`, `spawn_subagent`), consentendo flussi di lavoro complessi che combinano più tipi di strumenti. *** ## Funzionalità MCP specifiche del desktop [#funzionalità-mcp-specifiche-del-desktop] ### Configurazione per progetto [#configurazione-per-progetto] | Livello di configurazione | Posizione | Ambito | | ------------------------- | ------------------------------------- | -------------------------------------- | | **Globale** | `~/.verdent/mcp.json` | Tutti i progetti | | **Progetto** | `.mcp.json` nella radice del progetto | Singolo progetto | | **Worktree** | Eredita dal progetto | Eredita la configurazione del progetto | ### MCP multi-worktree [#mcp-multi-worktree] I server MCP funzionano tra i vari worktree: * **Server condivisi:** la configurazione MCP del workspace di base è condivisa da tutti i worktree * **Operazioni isolate:** ogni worktree mantiene uno stato di sessione MCP separato * **Accesso parallelo:** più worktree possono usare gli stessi server MCP contemporaneamente ### Cambio di progetto [#cambio-di-progetto] Quando cambi progetto: * Vengono caricati i server MCP del progetto corrente * I server MCP globali restano disponibili * Le connessioni MCP del progetto precedente vengono mantenute in background *** ## Esempi di flussi di lavoro MCP [#esempi-di-flussi-di-lavoro-mcp] ### Integrazione di query su database [#integrazione-di-query-su-database] **Scenario:** interrogare il database di produzione per il debug di problemi sui dati. **Approccio MCP:** ``` User: "Check the orders table for customer ID 12345" Verdent: [Uses MCP database server to execute safe read-only query] Results: 3 orders found for customer 12345 [Displays formatted results] ``` Il server di database MCP gestisce l'autenticazione, la validazione delle query e la formattazione dei risultati. ### Interazione con servizi cloud [#interazione-con-servizi-cloud] **Scenario:** controllare i log di una funzione AWS Lambda per individuare errori. **Approccio MCP:** ``` User: "Show me recent errors from the payment-processor Lambda function" Verdent: [Invokes MCP AWS integration] [Retrieves CloudWatch logs for specified function] [Filters for ERROR level entries] [Presents formatted error summaries] ``` Il server AWS MCP gestisce l'autenticazione, le chiamate a API e il parsing dei log. ### Monitoraggio della pipeline CI/CD [#monitoraggio-della-pipeline-cicd] **Scenario:** controllare lo stato della build prima di distribuire le modifiche. **Approccio MCP:** ``` User: "Is the master branch build passing?" Verdent: [Queries MCP CI/CD integration] Build #245: ✓ Passed (2 minutes ago) All tests passed, ready for deployment ``` Il server CI/CD MCP traccia lo stato della pipeline e fornisce un riscontro in tempo reale. *** ## Considerazioni sulla sicurezza [#considerazioni-sulla-sicurezza] ### Autenticazione e autorizzazione [#autenticazione-e-autorizzazione] **Gestione delle credenziali:** I server MCP gestiscono l'autenticazione verso i servizi esterni. Le credenziali sono salvate in modo sicuro nella configurazione MCP e non vengono mai esposte nella cronologia della chat o nel codice. **Limitazione dei permessi:** Configura i server MCP con il minimo di permessi necessari. Usa l'accesso in sola lettura quando possibile e limita le operazioni distruttive. ### Operazioni sicure [#operazioni-sicure] **Revisione dei comandi:** Le operazioni che coinvolgono gli strumenti MCP compaiono nella cronologia della conversazione, offrendo visibilità e controllo. **Registro di audit:** Le operazioni dei server MCP compaiono nella cronologia della chat di Verdent, creando una traccia di audit delle interazioni con i sistemi esterni. *** ## Risoluzione dei problemi dell'integrazione MCP [#risoluzione-dei-problemi-dellintegrazione-mcp] ### Problemi comuni [#problemi-comuni] **Errori di connessione:** * Verifica la connettività di rete verso il server MCP * Controlla le credenziali di autenticazione in `mcp.json` * Assicurati che il server MCP sia in esecuzione e accessibile * Convalida la sintassi del file di configurazione **Errori di permessi:** * Conferma che le chiavi API o le credenziali abbiano i permessi richiesti * Controlla le quote di servizio o i limiti di frequenza * Verifica che le regole del firewall consentano il traffico MCP **Problemi nell'invocazione degli strumenti:** * Assicurati che il server MCP esponga correttamente gli strumenti previsti * Controlla che i formati dei parametri degli strumenti corrispondano alle aspettative del server * Esamina i log del server MCP per i dettagli dell'errore ### Ottenere aiuto [#ottenere-aiuto] **Canali di supporto:** * Supporto Verdent: [support@verdent.ai](mailto:support@verdent.ai) * [Documentazione del protocollo MCP](https://modelcontextprotocol.io) * [Community Discord di Verdent](https://discord.com/invite/NGjXEZcbJq) **Informazioni diagnostiche:** Quando segnali problemi con MCP, fornisci: * Tipo e versione del server MCP * Dettagli di configurazione (con le credenziali rimosse) * Messaggi di errore dalla cronologia della chat * Log del server MCP (se accessibili) *** ## Domande frequenti [#domande-frequenti] Le operazioni dei server MCP consumano crediti in base al modello che elabora i risultati. Il server MCP in sé non consuma crediti direttamente. No. I server MCP vengono configurati a livello di utente, non per progetto. Tutti i server configurati sono disponibili in tutti i tuoi progetti. Le credenziali in mcp.json sono salvate localmente sul tuo computer e non vengono mai inviate ai server Verdent. Usa le variabili d'ambiente (`${VAR_NAME}`) per i valori sensibili. I server MCP si avviano quando necessario e restano attivi durante la sessione. Non consumano risorse quando Verdent è chiuso. I server MCP hanno i permessi che configuri tu. Usa l'accesso in sola lettura quando possibile e limita le operazioni distruttive. Chiedi a Verdent di usare uno strumento del server MCP. Risposte corrette indicano che la connessione funziona. Consulta la sezione sulla risoluzione dei problemi in caso di errori.